descrybe/docs/a11y-notes.md

Accessibility notes (Descrybe v2 web)

Critical fixes from the a11y pass (keyboard / focus / ARIA).

Sidebar (Nav.svelte)

• Mobile drawer uses inert + aria-hidden when closed so off-canvas links are not in the Tab order.
• Open drawer traps focus; Escape closes it.
• Hamburger aria-controls="app-sidebar" matches the aside id; label toggles Open/Close.
• Nav links expose aria-current="page"; More uses aria-expanded / aria-controls.
• Primary Stores points at /stores (data-tour="nav-stores").

Focus traps

Shared helper: src/lib/a11y/focus-trap.ts.

Surface	Behavior
Dialog.svelte	Tab cycle inside panel; focus restored on close; Escape closes
Tutorial popover	Tab cycle = popover controls + highlighted data-tour target (so forced steps stay keyboard-reachable); Escape pauses
Mobile sidebar	Tab cycle while drawer open

Store hub (/stores)

• Landmark section with accessible heading (sr-only).
• Each connector is an article with labelled title + CTA aria-label.
• Status badges include an accessible name (Status: …).

Remaining (non-blocking)

• Individual feature dialogs that bypass ui/Dialog should adopt the same trap.
• Live axe/browser keyboard audit on every route still recommended before production.