Upfront: I did not build this. It is an open-source project on GitHub (pa11y/pa11y, LGPL-3.0). It is listed here on star count, maintenance activity and how well it fits day-to-day storefront operations.
What it does
- One command, one report — no test code to write; pass a URL and get violations with the offending HTML.
- Whole-site scans — the companion pa11y-ci runs many URLs at once, which combined with a sitemap gives you a full audit.
- Thresholds that gate releases — set a maximum allowed issue count and fail the pipeline above it, so debt cannot quietly accumulate.
- Configurable standard — supports WCAG 2.1 A / AA / AAA, so you test against the level you actually need.
How to use it
Install globally from npm and run it:
npm install -g pa11y
# scan a page
pa11y https://yoursite.com
# or as a dev dependency for CI
npm install pa11y --save-dev
It tests against WCAG 2.1 AA by default. For whole-site runs install pa11y-ci, which can read a sitemap.
When to use it, and when not to
Reach for this when you want a finished tool that just runs; reach for axe-core when you want to embed checks in your own test code. They coexist fine.


