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

# Write your first test

> Create a suite and a case with the real fields: steps, expected outcome, priority, and optional persona.

A **suite** is a group of tests (a tab in the old workbook). A **case** is one row: a script you can run again next release.

<Steps>
  <Step title="Create suite">
    **Test Suites** to **Create suite**. Name it like the spreadsheet tab: "Checkout," not "Misc." The list always creates a top-level suite.
  </Step>

  <Step title="Add First Case">
    Title a real user action: "Guest can complete checkout with a valid card." Not "Checkout works."
  </Step>

  <Step title="Fill only what you'll use">
    Description, preconditions, expected outcome, priority (`low` | `medium` | `high` | `critical`), module, tags, persona, estimate in minutes, status (`draft` | `active` | `deprecated`).
  </Step>

  <Step title="Add steps">
    Each step: instruction, expected result, notes, evidence required. That's the procedure column split into something you can pass/fail.
  </Step>
</Steps>

## A good first case

* **Title:** Guest can complete checkout with a valid card
* **Preconditions:** Staging URL from the environment. Empty cart. Test Visa from Acme's sandbox sheet.
* **Steps:** Open storefront to add in-stock SKU to checkout as guest to pay to see order number
* **Expected outcome:** Order number shown; cart empty; no generic error
* **Priority:** `critical`
* **Status:** `active`

Vague and bloated examples: [what is a case](/tests/what-is-a-case).

Then create a cycle, include this case, **Start a run**. That's the moment the spreadsheet would have gotten a yellow "in progress" cell.

<Columns cols={2}>
  <Card title="How to run it" icon="play" href="/running/runs">
    Cycles, testers, pass/fail.
  </Card>

  <Card title="Organize more tests" icon="folder-tree" href="/tests/create-and-organize">
    Suites, tags, modules, deprecating unused tests.
  </Card>
</Columns>