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-labelvalues. 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:
- Run automated accessibility checks for the default and step-up states.
- Verify keyboard-only navigation.
- Verify screen-reader labels for recording, recorded, verified, and access-code error states.
- Verify reduced-motion behavior.