Testing

Unit tests

Vitest, always with a fixed timezone so date assertions behave the same everywhere:

TZ=UTC bun run test

A single file:

TZ=UTC bunx vitest run path/to/file.test.ts

Type checking

Type errors are frequently the root cause of test failures, so check types first:

bun run type-check:ci --force

End-to-end tests

Playwright. Set NEXTAUTH_URL to the URL the app actually serves — http://localhost:3000 locally, as .env.example describes.

bun run test-e2e

Open the last HTML report:

bunx playwright show-report test-results/reports/playwright-html-report

Browsers not installed

Executable doesn't exist at .../ms-playwright/chromium-1048/chrome-mac/Chromium.app/...

Download them:

bunx playwright install

Email assertions

Tests that assert on outgoing mail need MailHog running and E2E_TEST_MAILHOG_ENABLED=1:

docker run -d -p 8025:8025 -p 1025:1025 mailhog/mailhog