Skip to content

Shared Record Accessibility

Accessibility commitments for customer-facing Shared Record pages.

Shared Record pages are designed for procurement, finance, and support readers who need a fast answer under time pressure. Accessibility is part of that product promise.

Target

Customer-facing Shared Record pages target WCAG 2.1 AA for:

  • Text contrast.
  • Keyboard navigation.
  • Screen-reader labels.
  • Focus management.
  • Reduced-motion preferences.

Interaction Rules

  • Every action on /c/{handle} must be reachable by keyboard.
  • Step-up forms must have explicit labels and announce errors with aria-live="polite".
  • Sheets and dialogs must trap focus while open and restore focus to the trigger when closed.
  • State pills must include text or aria-label values. Color cannot be the only signal.
  • Links that download exports must describe the format.

Motion

Quiet status motion is allowed only when it helps the user notice a state transition. If prefers-reduced-motion: reduce is set, status animations should be disabled.

Contrast

The customer surface uses a dark zinc reading environment. Body text should meet at least 4.5:1 contrast and large text should meet at least 3:1. Status treatments should pair color with text or iconography.

Review

Before a new Shared Record surface ships:

  1. Run automated accessibility checks for the default and step-up states.
  2. Verify keyboard-only navigation.
  3. Verify screen-reader labels for recording, recorded, verified, and access-code error states.
  4. Verify reduced-motion behavior.