> For the complete documentation index, see [llms.txt](https://docs.puppetry.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.puppetry.app/suite.md).

# Suite

Suite is literally a JSON file keeping suite-related targets, groups, test-cases and test-steps.

## Create Suite

To create a new project you can press **Ctrl+N** (⌘N)  or click on **File / New Suite** item in the main menu:

![New Suite in the main menu](/files/-LhewMjZirrIeSlPPt-m)

It opens the following modal window:

![New Suite modal window](/files/-LhewXBRLkt9kg3PGf_z)

You need to specify suite name and press **Create** button. It will create a json file with name built from provided one and open it.

Optionally you can give a custom name to the file. Just click to open **Specify filename** panel:

![Custom filename for suite](/files/-Lhex38yAFv8tsx0EjoB)

## Record Suite

After you created anew suite you can either populate it manually or record it. To go with the last option, click on **Record** button in the footer of **Groups** panel:

![Record suite button](/files/-LhkDYgvTI6O0zjJuPnZ)

It opens a new window:

![Suite Recorder window: Initial state](/files/-LuDYJlc2GJ-c_psLvQL)

Here you can

1\) Select viewport 

![Select viewport combobox](/files/-LhkE09lugZsKU0aILMZ)

2\) Set a color for element highlighting on test pages

![Color selector](/files/-LhkEAur67dVM_6vyn2J)

3\) Enter URL or test page and press **ENTER**. It will bring you to the specified page:

![Suite Recorder window: URL entered](/files/-LuDYO1Q85qyC-wyZcaW)

Now you can interact with the page (click on elements, type in inputs and so on). Any affected element will be automatically registered into targets. But you can **right-click** (or **Ctrl-Shift-click) an element** to register it into targets explicitly. 

![After Ctrl-Shift-click you will be prompted for a target name](/files/-LhkGiebnxtLV_mVt7I-)

You can also find recorder console below the address bar.

![Recorder console](/files/-LuDYb1p-1YamO-KmuD_)

It prints all the user actions intercepted by the recorder. If you hover the console it expands showing you more of the log.

![Recorder log](/files/-LuDYfQ7GDp_6MK4JF7Z)

Left to the **Create Suite** button you can see an icon:

![DevTools button](/files/-LuDYjsGMLmh0cruuWXO)

Click it when you need **Chrome DevTools**.

4\) When you are done, click on **Create Suite** button in the header. That will bring you back to the **Groups** panel, where you will see a newly created **Recorded group:**

![Recorded group collapsed](/files/-LuDYrR_8dJmO_6jMmjs)

Let's expand the generated group and the test case:

![Recorded group expanded](/files/-LuDYvJebgHFiRNTNLGF)

As you can see our interactions on the page recorded into a valid test case. Now let's switch to **Targets** panel:

![Recorded targets](/files/-LuDYyjpJgNJBOHICY7P)

As you can see automatically generated targets named after their selectors. Besides, we have an explicitly specified target (`AVATAR`) 

## Open Suite

To open suite click on **File / Open Suite** item in the main menu:

![Open suite in the main menu](/files/-LhexwQNM3mqosDT9O6_)

It opens the following modal window:

![Open Suite modal window](/files/-LheyX8DE7v9S8bAwjFG)

Here we select a suite from the list of suites currently available in the project

You can also use [Project Explorer](https://docs.puppetry.app/projects#project-explorer)

## Save Suite

To create a new project you can press **Ctrl+S** (⌘S)  or click on **File / Save Suite** item in the main menu:

![Save Suite in the main menu](/files/-LheytfIrcYRjh91LtuX)

## Save Suite As..

You can clone a suite. To do it click on **File / Save Suite** **As...** item in the main menu:

![](/files/-LhexthAeaVU30dOfCoe)

It opens the following modal window:

![Save Suite modal window](/files/-Lhez3GAPwbLlXG3tTCX)

Here you just need to provide a name for suite clone.

## Suite Options

In suite tabs you can find one called Suite o**ptions**:

![Suite options tab](/files/-LuDZ29SekGSqlihBU5L)

Click on it to get the **Suite Options** modal window:

![Suite Options modal window](/files/-LuDZ5ibORaHkMheMdnG)

Here you change the suite name and set up test run timeout (maximal allowed time for the entire test run)