> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.litmuscheck.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create your first test

> Learn how to write a basic test

## Create a new suite

**View your suites**\
Once you are logged in, your test suites appear on your homepage.

<img src="https://mintcdn.com/litmuscheck/gYvbee5XWkhoHrTt/images/getting-started/dashboard-run.png?fit=max&auto=format&n=gYvbee5XWkhoHrTt&q=85&s=e14269496d273666b5f0d6c9a3646883" alt="Dashboard" width="1022" height="271" data-path="images/getting-started/dashboard-run.png" />

**Create a suite**\
Click the **New Suite** button at the top of the sidebar.
Enter your `Suite Name`, `URL` and click the **Create** button.

<img src="https://mintcdn.com/litmuscheck/gYvbee5XWkhoHrTt/images/getting-started/create.png?fit=max&auto=format&n=gYvbee5XWkhoHrTt&q=85&s=30811f8f58bfd2e81f941e916c777bad" alt="Dashboard" width="621" height="285" data-path="images/getting-started/create.png" />

**View suite details**\
Click on the suite name or **View** button on the homepage.

<img src="https://mintcdn.com/litmuscheck/gYvbee5XWkhoHrTt/images/getting-started/suite.png?fit=max&auto=format&n=gYvbee5XWkhoHrTt&q=85&s=5f01148e28f850c4536fce1a894fec3c" alt="Suite" width="1918" height="637" data-path="images/getting-started/suite.png" />

## Create a test

Inside a suite, click the **Add Test** button on the right to launch the Compose View.

### Adding steps

* Enter `saucedemo.com` in the Go to URL input and click **Add**
* Click on **Add** icon and select **Input**

<img src="https://mintcdn.com/litmuscheck/gYvbee5XWkhoHrTt/images/getting-started/new-test.png?fit=max&auto=format&n=gYvbee5XWkhoHrTt&q=85&s=1aa86c4b787c0e53321fb5b19dc48c44" alt="Steps" width="565" height="325" data-path="images/getting-started/new-test.png" />

* Enter `standard_user` in **value**, select **New Element**, and enter Username as **prompt**
* Click on **Add** icon and select **Input**
* Enter `secret_sauce` in **value**, select **New Element**, and enter Password as **prompt**

### Live browser view

The browser pane on the right shows your test in action.

* Click **Start Run** to open the session.
* Click **Stop** to end it.

<img src="https://mintcdn.com/litmuscheck/gYvbee5XWkhoHrTt/images/getting-started/compose-new.png?fit=max&auto=format&n=gYvbee5XWkhoHrTt&q=85&s=719b73d0db5155f6523d6d56e8b7ee24" alt="Live view" width="1888" height="880" data-path="images/getting-started/compose-new.png" />

### Adding more steps

When adding more steps while live view is on, the steps continue to execute.

* Click on **Add** icon and select **Click**
* Select **New Element** and enter Login as **prompt**

The live mode will show the execution of the click step.

### Adding goals

<img src="https://mintcdn.com/litmuscheck/gYvbee5XWkhoHrTt/images/getting-started/goal-new.png?fit=max&auto=format&n=gYvbee5XWkhoHrTt&q=85&s=56278d31074cc2980f5fa7c1bd526b58" alt="Goal Agent" width="505" height="94" data-path="images/getting-started/goal-new.png" />

Enter a natural-language goal in the bottom input and press **Enter**. The autonomous agent will attempt all available actions to reach your goal. When complete (or if it gets stuck), it will show the sequence of steps it took. You can discard them or add them to your test.

> **Tip:** Keep goals simple for best results.

<img src="https://mintcdn.com/litmuscheck/gYvbee5XWkhoHrTt/images/getting-started/goal-add.png?fit=max&auto=format&n=gYvbee5XWkhoHrTt&q=85&s=b045a706144021292edc8ece9a3a9f32" alt="Goal Agent Steps" width="1897" height="892" data-path="images/getting-started/goal-add.png" />

### Viewing script and selectors

When an instruction runs, its generated script appears in the script box. Click the element description to toggle between available selectors.

### Saving and discarding

* Click **Save** to persist your test (there is no autosave).
* Click **Discard** to throw away unsaved changes.
