# Run smoke / regress

> For the complete documentation index, see [llms.txt](/llms.txt)

Group related scenarios into a [collection](/concepts/collections/) and run them
together.

## Create one

In the [viewer](/viewer/overview/): **Collections** (⌘3) → create → add
scenarios → reorder by drag. A collection is a small YAML file under
`unotest/e2e/collections/`.

## Run it

```sh
# fast key flows
npx @unotest/web collection smoke --workers=4

# full sweep, stop on first failure
npx @unotest/web collection regress --bail
```

During a run you get per-scenario status and a progress bar (in the viewer), or a
serial/parallel summary on the CLI.

## A good split

- **smoke** — login, checkout, the 5 flows that must never break. Run on every
  push.
- **regress** — everything. Run nightly or before release.

Wire it into CI: [Run in CI](/guides/ci/).