MagentaA11y is a tool built to simplify the process of accessibility testing.
We wanted to build an intuitive way for product teams to define “done” in a way that ensures accessible experiences work for everyone.
It uses Jekyll with a custom theme as a CMS and relies on markdown for entry creation.
- This is not a comprehensive list of all of the WCAG success criteria or techniques required to become WCAG compliant and should not be used as such.
- Adherence to this list also does not guarantee that a digital asset will be free from accessibility issues or complaints.
Product owners, designers, developers or testers can use the checklist builder to collect testing instructions for web or native app components.
These testing criteria are displayed in markdown format for easy copying/pasting into project management tools like Jira.
Testing instructions includes:
- How to test with keyboard
- How to test with screen reader
- How to test with a screen reader on a mobile device
- Link to the full entry
Each entry contains:
- Video demos with recommended screen reader browser pairings
- Code examples
- Developer notes
- Links to official WCAG and WAI-ARIA documentation
MagentaA11y is built and maintained by the T-Mobile Accessibility Resource Center.
Here are some ways to contribute:
- Add a concise demo video using a screen reader that’s not yet covered.
- Add an entry for a component that is not included.
- Fix a typo or edit for consistent language.
MagentaA11y holds itself accountable to following a layered testing strategy.
Lighthouse CI triggers warnings for performance and SEO and errors for accessibility on key pages and rendered templates.
- Installation note: to deploy, use git push heroku HEAD:main
Local installation instructions
A11yEngineer is a Jekyll based site hosted by Github Pages. Follow Github’s instructions for installing locally.
- Clone the open source repo from T-Mobile
- Testing your GitHub Pages site locally with Jekyll
- Helpful links for installing Jekyll with Ruby 3.0
- Install Ruby 3.0 · macOS Big Sur or Catalina for Intel or Apple Silicon
- Install Ruby 3.0 · macOS Big Sur or Catalina with Homebrew for Intel or Apple Silicon
- Note: Ruby 3.0 will require WEBrick
gem "webrick"to Gemfile
MagentaA11y is open sourced by T-Mobile and released under the Apache 2.0 License.