Files

1.1 KiB

Truckwash Frontend Development Guidelines

This file is generated from the canonical AI workflow and is the supported Junie-facing reference for the frontend repository.

Build And Run

  • Setup: npm ci and npx playwright install.
  • Start development server: npm run dev.
  • Production build sanity check: npm run build.

Testing

  • Vitest unit tests: npm run test:unit.
  • Playwright smoke: npm run test:e2e:smoke.
  • Playwright full suite: npm run test:e2e:ci.
  • Playwright debug: npx playwright test --debug.
  • Browser validation is Playwright-first. Legacy browser-driver tooling is not part of the supported workflow.

Workflow Notes

  • Generated assistant metadata is checked with node scripts/sync-ai-workflow.mjs --check.
  • Keep frontend browser verification aligned with the existing Playwright projects and runner scripts in package.json.
  • Use the narrowest relevant test command first, then expand to the broader suite when the change risk requires it.

Canonical workflow reference: .ai-workflow/workflow.md.