Accessibility is core to all design decisions made in our Design System. New components or patterns must complete the following to be admitted into the design system.
Foundational accessibility tests
As part of staging reviews, new components must complete foundational accessibility testing using this GitHub ticket. Foundational testing requires evaluating:
- Color and color contrast
- Automated testing with axe by Deque
- Content zoom and reflow
- Keyboard navigation
Advanced testing with mobile and desktop screen readers
As part of staging reviews, new components must also complete advanced testing with an accessibility specialist using a screen reader on both mobile and desktop. As a default, based on recommendations from the Blinded Veterans Association, we recommend testing with:
- iOS with Safari using VoiceOver (Mobile)
- Windows 11 with Chrome using JAWs (Desktop)
Note: The testing tools above may be replaced, depending on context, with NVDA and TalkBack.
It is the intention of this team to improve our testing standards to more accurately reflect the full disabled experience. Today our compliance testing sets a minimal standard that we are striving to raise.
Get accessibility guidance early from the CAIA team
The Sitewide Content, Accessibility, and Information Architecture (CAIA) team can help you meet VA.gov’s accessibility standards. Whether you’re starting a new product or refining an existing one, contact the CAIA team as early as possible to create accurate, consistent, accessible, and equitable content for Veterans.
Submit a Sitewide Content, Accessibility, and IA intake form ticket in GitHub to get started.