Marc-André Bombeck
9cefaecf94
The protected shell renders its hydration gate for every child until /api/auth/me resolves, so after a goto, a reload or an exit click nothing exists yet: no nav, no top bar, no banner, no page body. Fifteen absence assertions across twelve specs were asserted inside that window. Each was true because the surface had not rendered, and each would have stayed green if the thing it forbids came back. Every site now waits for a positive marker of the loaded state first: the document sheet's footer download action, the settled integrations card rather than the family attribute its skeleton shares, the top bar after an exit, the page's own heading, the delegate's own marker, the Coach FAB. Two skeleton-absence waits are replaced by waits on the content that follows. delegated-writes had a different cause: it asserted the bulk selection bar absent although no row was ever selected, so it passed for an owner too. The gate is one level earlier - below MANAGE no row carries a checkbox at all - so the test asserts that instead, with the bar and the row delete kept as backstops. No sleeps added, no timeouts raised, no claim weakened.
e2e/
End-to-end browser tests. Playwright 1.60 drives a production build of the app against a real PostgreSQL, with @axe-core/playwright for accessibility assertions. This is the heaviest test tier; CI runs it on every PR, and locally it is worth running when a change touches a UI flow.
Running
pnpm e2e
The Playwright config (../playwright.config.ts) builds the app (next build) and brings up Postgres before the specs run; setup/global-setup.ts seeds the auth + fixture state. The suite is not part of the fast local gate (typecheck / lint / test) — it surfaces at PR CI, so expect responsive/wizard/nav reworks to flag here first.
Layout
setup/—test.ts(the suite'stest+expectentry point),global-setup.ts(auth + DB seeding),test-helpers.ts(shared login + navigation helpers).utils/— fixtures such asmock-dashboard-snapshot.ts.fixtures/— synthetic payloads a journey uploads, built in code rather than committed as blobs so the content stays reviewable (apple-health-export.ts).*.spec.ts— one spec per flow: auth/login/redirect, dashboard, charts, the medication-wizard cadences (medications-wizard-*), insights generation + scroll restoration, doctor report, settings, mobile-viewport consistency, locale switch, accessibility (a11y.spec.ts), and thev1427-*regression set.
Conventions
Import test and expect from ./setup/test, never from @playwright/test — types (Page, Route, …) still come from the package. The entry point extends Playwright's test with an automatic fixture that drops route handlers and page listeners after every test, so a handler left in flight cannot fail the test it belonged to once the context closes. src/__tests__/e2e-route-cleanup-guard.test.ts enforces the import boundary.
Assert against stable data-* attributes (data-slot, data-display-step, root display attrs), not viewport-dependent visible text. Responsive sm:hidden UI changes break getByText on desktop while the underlying element is still present — anchoring on data attributes keeps the specs stable across breakpoints. See ../CLAUDE.md.