javimosch pa11y Plugin
pa11y runs automated accessibility audits against web pages. Detects WCAG violations with actionable output — ideal for CI pipelines and pre-release checks.
Installation
npm install -g pa11y
Basic Usage
# Test a live URL
pa11y https://example.com
# Test local HTML file
pa11y ./index.html
# JSON output for CI
pa11y --reporter json https://example.com
Common Patterns
# WCAG 2.1 AA standard
pa11y --standard WCAG2AA https://example.com
# Ignore known issues via config
pa11y --config .pa11yci.json https://example.com
# Screenshot on failure
pa11y --screen-capture error.png https://example.com
# Run against multiple URLs (pa11y-ci)
pa11y-ci --sitemap https://example.com/sitemap.xml
Usage Examples
- "Check https://mysite.com for WCAG 2.1 AA violations"
- "Run pa11y with JSON output in CI"
- "Audit local index.html for accessibility issues"
SuperCLI
sc pa11y self version
sc pa11y _ _ --standard WCAG2AA https://example.com
sc plugins learn pa11y