VKC E2E Playwright Runbook
When to use
- •You add or edit
e2e/*.spec.ts. - •You debug flaky E2E failures locally or in CI.
- •You see port/health-check issues (
E2E_PORT,E2E_HEALTH_PATH,webServer).
Hard rules (this repo)
- •Default E2E port is 3100 (not 3000) unless explicitly overridden.
- •Prefer the project runner:
scripts/run-playwright-e2e.jsvianpm run test:e2e. - •Always capture failure context:
- •
test-results/*/error-context.md
- •
Canonical references
- •Runner:
scripts/run-playwright-e2e.js - •Scripts:
package.json(test:e2e*) - •E2E non-negotiables:
AGENTS.md
References
- •Runbook:
.codex/skills/vkc-e2e-playwright-runbook/references/e2e-runbook.md