Accessibility audit engine
a11y-engine
A WCAG 2.2 accessibility audit engine that orchestrates route discovery, multi-engine scanning, stack-aware enrichment, source analysis, and report generation through a stable API and CLI.
a11y-engine is the shared core behind the accessibility tooling ecosystem. It discovers routes through sitemap-first crawling, scans pages with axe-core, Chrome DevTools Protocol checks, and pa11y HTML CodeSniffer, then merges and deduplicates findings into report-ready data.
The engine enriches each finding with WCAG mapping, severity, affected personas, fix guidance, framework and CMS notes, source ownership hints, and optional Claude-powered recommendations. It can be consumed programmatically as @diegovelasquezweb/a11y-engine or executed from the terminal through the a11y-audit CLI.
Outputs include JSON scan results, enriched findings, HTML dashboards, PDF compliance reports, Markdown remediation guides, manual testing checklists, screenshots, and source-pattern findings for local projects or remote GitHub repositories.
What it does
- Route discovery crawler with sitemap-first discovery, robots filtering, depth control, and route limits.
- Multi-engine runtime scanning with axe-core, CDP accessibility-tree checks, and pa11y.
- Stack detection from runtime signals and source signals such as package.json and project structure.
- Report builders for HTML dashboard, PDF compliance report, checklist, and Markdown remediation guide.
- Source code pattern scanning for local paths and remote GitHub repositories without cloning.
- Knowledge API for WCAG levels, severity definitions, personas, glossary, and scanner help.