---
description: Generate and run frontend journey tests with Vitest/Testing Library, plus browser verification for apps/web. Covers login and FULL_PAGE index/form/detail.
---

# E2E / Journey Command

This command invokes the **e2e-runner** agent to cover critical UI journeys. There is no NestJS or Playwright suite.

## What This Command Does

1. **Identify journeys** — login, FULL_PAGE index / form / detail
2. **Write or update Vitest tests** — mock `@repo/core-api` services
3. **Run** `pnpm test` (or `pnpm --filter web test`)
4. **Browser-verify** `apps/web` when the change is routing or layout
5. **Report** pass/fail

## When to Use

Use `/e2e` when:

- Testing login or a FULL_PAGE module flow
- Verifying index → form → detail navigation
- Checking empty / error states after a UI change
- Preparing a PR that touches routing or providers

## How It Works

The e2e-runner agent will:

1. Copy patterns from `apps/web/src/apps/main/modules/example/full-page/`
2. Mock `fullPageDataService` (or the module's factory) — not a database
3. Run `pnpm test`
4. Drive the browser for layout/routing if needed (`pnpm dev:web`)
5. Summarize failures

## Example

```
User: /e2e Test the example full-page index and detail flow
```

Canonical sample: `example/full-page`. Do not invent a third page style. Do not add Playwright unless asked.

## Related

Agent: `.cursor/agents/e2e-runner.md`