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

# Quickstart

### Create, Run, and Review Your First Automated Test

This quickstart guide walks you through the core TestFirst workflow—from defining what to test to running your first automated test.

Before you begin, you’ll need a **TestFirst account**.

[Sign up](https://www.testfirst.com/plans) using your email or Google account. Once you’re signed in, you can start testing immediately.

You don’t need prior QA experience.\
If you can describe how a feature works, TestFirst helps you turn that knowledge into structured tests.

### What You’ll Achieve

By the end of this guide, you will have:

* Created a **Test Scope**
* Generated **AI-assisted test cases**
* Completed a test using the **Recorder**
* Run a test
* Viewed the **test results**

### The Big Picture

```
Requirement / Specification
   ↓
Test Scope
   ↓
AI-generated Test Cases
   ↓
Automate Test Case
   ↓
Run Test
   ↓
View Results
```

This workflow helps you move from **product knowledge to test coverage** quickly.

### Step 1: Create Your First Test Scope

A **Test Scope** defines what you want to test. It typically represents a feature, module, or release.

Examples include:

* Login functionality
* Checkout flow
* A new feature
* Regression testing for a release

#### Create a Test Scope

1. Open **Test Scopes** from the sidebar
2. Click **+ New Test Scope**
3. Enter a **scope title** *(optional)*\
   If left empty, TestFirst generates one automatically.
4. Upload a requirement or design document\
   Supported formats include **TXT, Markdown, DOCX, and PDF**.\
   You can also use the **demo file** to get started quickly.
5. Click **Create**

 :star2: Your Test Scope is now ready.

***

### Step 2: Generate Test Cases

Once your scope is created, TestFirst can generate draft test cases automatically.

#### Generate test cases

1. Click **Generate Test Cases**
2. TestFirst analyzes your uploaded documents
3. Draft test cases are generated automatically

You may see two types of suggestions:

* **AI-generated test cases** based on your documents
* **Recommended tests from your Test Library** (if available)

#### Review and select tests

1. Review the generated test cases
2. Select the ones you want to include
3. Click **Add**

These tests are now part of your Test Scope.

***

### Step 3: Open the Test Case in the Editor and Complete the Test Case

Before tests can be executed, each test case must be **completed**.

Completing a test case means either:

* **Automating it**, or
* **Writing the steps manually** using the **TestFirst Editor**

#### Recommended: Use the Recorder

The **Recorder** is the fastest way to create automated tests.

1. In your Test Scope, click the <i class="fa-pencil">:pencil:</i> **Edit** icon on a test case
2. The test case opens in the **TestFirst Editor**
3. Click **Recorder**
4. Download and install the **Utilities Pack** if prompted, and run the **Test Runner**
5. Enter the **website URL**
6. Record the test by performing actions such as:
   * Clicking elements
   * Typing input
   * Verifying page content
7. Set the test case status to **Ready for Testing**
8. Save the test case

Your automated test is now ready :tada:

***

### Step 4: Run the Test

Back in your Test Scope:

1. Refresh the page, then click **Run Test**
2. Select the test cases to execute
3. Click **Run**

#### What happens automatically

* A **Test Plan** is created
* The test plan is sent for execution
* The run appears under **Last Test Runs**

***

### Step 5: View Test Results

To see results:

* Click the **Test Run** link in your Test Scope

From there, you can:

* See pass/fail status
* Open execution details
* Review screenshots and logs
* Generate reports

***

### You’re Done! 🎉

You’ve just completed the full TestFirst workflow:

✔ Defined what to test\
✔ Generated test cases\
✔ Automated a test\
✔ Executed the test\
✔ Viewed the results

You now have a working automated test in TestFirst.

***

### What to Do Next

Continue exploring TestFirst:

* Add more test cases to the same scope
* Create a new scope for another feature
* Explore your Test Case Library organization
* Generate reports from Test Runs