Step 1 - Creating the Lab
- Add a new item lab in your course curriculum page

- A new lab item gets added. Edit the lab using the controls:

- A lab item in a course can be attached to an existing lab you created in the past. If not, you can create a new lab with this Edit interface:

- You should now be able to write a quick lab name and press on “Create Lab” button. Once you do, press on
Attach to course item
button. Once that is done, click the three dots again and click on “Edit” to edit the lab.

Step 2 - Lab Instructions
Once you click onEdit
button a new page will open. On this page you need to setup instructions for lab. These instructions would be visible to the user when they’re attempting the lab. Therefore, include all the helper material, lab setup instructions here.

Step 3 - Lab Defaults
Lab defaults section include how your lab environment boots. It is one of the most important parts because a wrong default environment might confuse your students. Therefore it is important to set it up properly.We recommend forking this repository: HTML playground
starter.
.cdmrc
file, a critical configuration file for Fermion labs. Familiarize yourself with the .cdmrc guide to understand how it works before proceeding.

Step 4 - Evaluation Script
Evaluation script is actually what runs when the user on the playground clicks on “Run Tests” button.

UNIT_TEST_OUTPUT_FILE
environment, all we have to do is trigger that script via Node.js.
The full path of the script is made available at run-time with another environment variable called TEST_FILE_NAME
. Therefore, all we have to do is write the following in the evaluation script area:
Step 5 - Test file
In the sameEvaluation
tab, you’ll see another section called “Custom test file”. You can use this test file to add custom code for testing user work.

Test command to run section
inside the evaluation tab we were in earlier.
The point of having a file like this to provide you with a place where you can write your evaluation script.
For HTML/CSS labs, you can use the default test file for playwright:
Step 6 - Add challenges
Finally, in the UI below, add friendly name of challenges that must be visible to the user. Note that the order of challenges is important here and must match the boolean array you write using the bash script + test file above.