E2E Testing

Playwright-based E2E and visual regression tests, run inside Docker for environment isolation. The Docker setup uses a separate test database so dev work continues uninterrupted in parallel.

Why Docker

Two reasons that compound:

1. DB isolation — the dev DB typically has PROD-synced data; the test DB has deterministic fixtures. Separate database instances on separate containers, separate compose profile.
2. Visual baseline reproducibility — fonts and Chromium versions are pinned, so visual snapshots are stable across machines.

The procedure runs as direct docker compose calls so it is fully visible and the runner can recover from infrastructure issues without elevated permissions or project-specific wrappers.

Standard run

Tear down stale state, build, run, fetch report, tear down. One sequence (paste as a single Bash invocation):