# Console accessibility

The console targets WCAG 2.2 AA and must remain usable with keyboard-only and
screen-reader workflows in online and sealed environments.

Core principles
- Deterministic navigation and stable focus order.
- Keyboard-first interaction with remappable shortcuts.
- Assistive technology parity for status and progress updates.
- Design tokens that maintain contrast targets.
- Offline parity for banners, dialogs, and keyboard flows.

Keyboard model
- Global shortcuts for search, tenant switch, filters, and help.
- Module shortcuts for findings, SBOM explorer, runs, and downloads.
- Focus traps for dialogs and drawers with consistent return focus.

Screen reader behavior
- Polite live regions for background updates.
- Assertive alerts for errors and blocking conditions.
- Aria grid semantics for large tables.

Testing
- Automated axe checks in UI CI.
- Playwright a11y sweeps on critical routes.
- Manual screen reader spot checks before releases.

Related references
- docs/accessibility.md
- docs/ui/*
- docs/observability/ui-telemetry.md