Eve library

V1-P2-3511 — OSHUN PWA Mobile Shell WCAG 2.1 AA Signoff

Guide

Revision 1

On this page

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#

bash
# 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.