# qa-playwright-add-new-flow > When adding a new test flow to the QA Playwright project, follow this checklist. - Author: semantic-release-bot - Repository: whitebeardit/playwright-boilerplate - Version: 20260131125435 - Stars: 4 - Forks: 0 - Last Updated: 2026-02-06 - Source: https://github.com/whitebeardit/playwright-boilerplate - Web: https://mule.run/skillshub/@@whitebeardit/playwright-boilerplate~qa-playwright-add-new-flow:20260131125435 --- --- name: qa-playwright-add-new-flow description: Add a new test flow to the QA Playwright project: create tests and test-data folders for the flow, add inputs and optional builder, write specs from fixtures. Use when the user asks to add a flow, new flow, or test suite for a feature. --- # Add new flow When adding a new test flow to the QA Playwright project, follow this checklist. ## Checklist 1. **Create flow folders in tests:** `tests/api//` and/or `tests/ui//`. Create at least one `.spec.ts` file in each folder you add. 2. **Create flow folders in test-data (if there are inputs):** `test-data/api//` and/or `test-data/ui//`. 3. **Define static inputs:** Create `inputs.json` (or `inputs.ts`) with the cases needed; optionally add `builder.ts` that uses [lib/data-factory.ts](../../../lib/data-factory.ts) for varying data. 4. **Write specs:** Import `test` and `expect` from `../../../fixtures`; use Arrange-Act-Assert; for data, import from test-data or use the builder. 5. **baseURL:** If the flow uses another domain, configure it in [playwright.config.ts](../../../playwright.config.ts) or via env (see [docs/08-ambiente-e-configuração.md](../../../docs/08-ambiente-e-configuração.md)). ## Naming - **Flow folder:** short, clear name (e.g. `login`, `pedido`, `relatorio`). - **Spec files:** `*.spec.ts`; name can describe the scenario (e.g. `login.spec.ts`, `footer.spec.ts`). ## Run only this flow ```bash npx playwright test tests/api// npx playwright test tests/ui// ``` ## Full reference [docs/07-como-adicionar-novo-fluxo.md](../../../docs/07-como-adicionar-novo-fluxo.md)