> 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/readme.md).

# Welcome to TestFirst

**TestFirst** is a **full-stack QA platform** designed to help teams turn product knowledge into reliable test coverage. Start from requirements, generate structured test cases, automate workflows, and track results — all in one workspace.

TestFirst supports the full testing lifecycle, from understanding requirements to generating tests, running tests, and reviewing results. You can start without writing code and expand into advanced automation as your testing needs grow.

### What you can do with TestFirst

* Start testing directly from **requirements, specifications, or design documents**
* **Generate AI-assisted test case drafts**
* Refine test cases using the **TestFirst Editor or the Recorder**
* Run automated tests **in the cloud**
* Track **execution progress, failures, and results**

You can begin without writing code, and gradually expand into more advanced automation workflows as your testing needs grow.

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-bolt">:bolt:</i></h4></td><td><strong>Quickstart</strong></td><td>Create, run, and review your first automated test case in minutes.</td><td><a href="/files/MC5HdInmtxlpEBIEgLw8">/files/MC5HdInmtxlpEBIEgLw8</a></td><td></td><td><a href="/pages/7FvWQMF0kTK7HGhlQfmo">/pages/7FvWQMF0kTK7HGhlQfmo</a></td></tr><tr><td><h4><i class="fa-leaf">:leaf:</i></h4></td><td><strong>Test Scopes</strong></td><td>Organize requirements, generate tests, and manage testing for a feature or module.</td><td><a href="/files/lymZkIOolYJOX63bz9IL">/files/lymZkIOolYJOX63bz9IL</a></td><td></td><td><a href="/pages/C3PK9ydRXsyJQLO7CJuz">/pages/C3PK9ydRXsyJQLO7CJuz</a></td></tr><tr><td><h4><i class="fa-globe-pointer">:globe-pointer:</i></h4></td><td><strong>Editor Basics</strong></td><td>Learn how to write and edit tests using the TestFirst editor, selectors, and data repository.</td><td><a href="/files/jLBWiayZUZ0DjMhNKikK">/files/jLBWiayZUZ0DjMhNKikK</a></td><td></td><td><a href="/pages/mktsCgbmKhQ6URJTaYmm">/pages/mktsCgbmKhQ6URJTaYmm</a></td></tr></tbody></table>

## How TestFirst Works

TestFirst organizes testing through a structured workflow built around three core components: **Test Scopes, Test Cases, and Test Execution**. Test Scopes define what needs to be tested, Test Cases describe the scenarios to verify, and Test Execution runs those tests and records the results, including outcomes and any defects found.

At a high level, the platform follows this flow:

```
Test Scope
   ↓
Test Cases
   ↓
Test Execution
   ↓
Results & Issues
```

Each layer builds on the previous one and helps teams maintain structured and repeatable testing.

***

### Test Scopes

A **Test Scope** defines the area of the product you want to test.

It acts as the workspace where you:

* organize test cases
* generate tests from documentation
* run tests and track results

Scopes help keep testing focused on a specific feature, module, or release.

### Test Cases

A **Test Case** describes a scenario you want to verify.

Test cases can be:

* generated from source documents
* written manually
* automated using the Recorder

Test cases can also be reused from the **Test Case Library** across multiple scopes.

### Test Execution

When tests are executed, TestFirst creates a **Test Plan** and records the results as a **Test Run**.

Execution tracks:

* pass or fail status
* execution details
* logs and artifacts from the run

This makes it easy to monitor the quality of the system over time.

### Results and Issues

After execution, you can review results and investigate failures.

When problems are found, issues can be created and tracked directly from the testing workflow.

This keeps testing results connected with development and debugging.

***

### How the Pieces Fit Together

Most teams use TestFirst in a repeating cycle:

```
Define scope
   ↓
Add or generate tests
   ↓
Run tests
   ↓
Review results
   ↓
Improve tests
```

This cycle helps teams continuously expand and maintain reliable test coverage.