The master TODO requires:
"OSHUN PWA mobile shell — same surfaces. V: zero violations."
Same surface checklist as V1-P2-3510 but at an iPhone-class mobile viewport
(390×844). The OSHUN PWA is the same Next.js app served by apps/oshun/web
(manifest.json + sw.js installed under apps/oshun/web/public/); this spec
exercises the mobile shell layout, drawer-style navigation, and condensed shell
chrome at the same eleven surfaces V1-P2-3510 exercised at desktop.
Surface coverage#
| V1-P2-3511 surface | Route | Enforcing test |
|---|---|---|
| Home | / |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case home) |
| Library | /library |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case library) |
| Search | /search |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case search) |
| Notifications | /profile?path=notifications |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case notifications) |
| Settings (profile) | /profile |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case settings) |
| Tara entry | /domains/tara |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case domain-tara) |
| Veritas entry | /domains/veritas |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case domain-veritas) |
| Nyx entry | /domains/nyx |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case domain-nyx) |
| Arete entry | /domains/arete |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case domain-arete) |
| Nisaba entry | /domains/nisaba |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case domain-nisaba) |
| Metis entry | /domains/metis |
e2e/wcag-aa-signoff-v1-p2-3511.spec.ts (case domain-metis) |
Viewport: 390×844 (iPhone-class, matches the existing
studio-concordia-workbench-accessibility.spec.ts mobile case). Reduced-motion
is emulated for deterministic axe results.
Verification result (2026-05-05)#
11/11 tests pass against apps/oshun/web running locally on port 3010 with the
BFF on port 4010. Each surface scan returns zero serious/critical WCAG 2.1 AA
violations under [data-shell-root].
A precondition fix was required before the Metis mobile entry could pass: the
mobile-only Metis preview eyebrow (Resume path, Continuity section labels in
apps/oshun/web/src/components/metis/MetisShellEntryPreview.tsx) used Metis
brand color #2563eb (Tailwind blue-600) on the dark navy panel background
#112137, yielding a contrast ratio of 3.13:1 for 13px text — fails axe
color-contrast (WCAG 1.4.3, AA threshold 4.5:1 for small body text). Lightened
the eyebrow color to #93c5fd (Tailwind blue-300) which yields ~8.2:1 against
the same background while preserving the Metis-blue identity. The brand color
tokens (#2563EB) used for solid fills, buttons, and borders are unchanged;
only the small text-on-dark eyebrow uses the lighter shade. The pre-existing
MetisShellEntryPreview.test.tsx unit tests still pass.
Run command#
# from apps/oshun/web with BFF + dev servers running
E2E_BASE_URL=http://127.0.0.1:3010 E2E_BFF_URL=http://127.0.0.1:4010 \
npx playwright test e2e/wcag-aa-signoff-v1-p2-3511.spec.ts \
--project=chromium --workers=1 --reporter=list
Defense-in-depth#
V1-P2-3511 sits inside the same a11y verification ladder as V1-P2-3510 (see
docs/releases/p2/v1-p2-3510-oshun-web-wcag-signoff.md):
- V1-P2-3500 auto-axe afterEach fixture runs a document-wide axe pass after every test in the spec.
- V1-P2-3501 pa11y-ci nightly sweep covers the same routes.
- V1-P2-3502 Storybook a11y addon enforces per-component primitive axe.
V1-P2-3511 owns the mobile-viewport consolidated surface checklist; the desktop variant is V1-P2-3510, and the per-surface specs (route-, search-, domain-accessibility) own richer interaction-level coverage.