Skip to content

feat(web): keyboard shortcuts cheat sheet (?) + a11y audit (keyboard nav, ARIA, contrast) #208

Description

@subinium

Severity: priority/warning
Source: Internal UX audit (v0.7 sweep)
Area: packages/web

Problem

  • No keyboard shortcuts cheat sheet (Cmd+K palette would be exposed via ? standard).
  • Most interactive elements aren't keyboard-navigable. Screen-reader semantics are missing on custom Lit components.
  • Color contrast not audited — some text on the dark theme may fail WCAG AA.

Proposed fix

  1. ? opens a modal listing all shortcuts (palette opener, persona switch, theme toggle, reload, focus-composer, scroll-to-latest, etc.).
  2. Keyboard nav: every interactive element reachable via Tab. Custom <crowclaw-*> components implement focus() + arrow-key handling where appropriate (e.g., session list).
  3. ARIA: every custom button has role="button" + accessible label. Modals trap focus + escape-closes.
  4. Contrast: run axe-core in a CI check; fix all AA failures.
  5. Screen reader: visible focus rings + skip-to-main link.

Expected impact

  • Compliance with corp accessibility requirements (often blocks enterprise sales).
  • Power-user productivity uplift (no-mouse workflow).

References

  • Internal v0.7 platform polish audit

Metadata

Metadata

Assignees

No one assigned

    Labels

    a11yAccessibility (keyboard nav, ARIA, contrast)enhancementNew feature or requestpolishProfessional finish / accessibility / i18npriority/warningReal cost / risk; fix when scheduledsource/auditInternal audit finding

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions