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

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.
