Roadmap
a11yscan is built in phases. Each phase ships independently and is fully usable on its own.
Phase 1 — CLI Scanner
CompleteThe core scanning engine. Everything needed to audit a site from the command line.
- Sitemap fetching with SSRF protection and retry logic
- URL filtering: prefix, glob (picomatch), exclude, depth, limit
- Bare URL mode with auto-sitemap discovery
- Playwright scanner with AxeBuilder API, concurrency (p-limit)
- Browser crash recovery with automatic relaunch
- Pattern analysis: violations grouped by rule + normalized CSS selector
- Root cause hints (Vuetify, Nuxt, WordPress, Material UI, etc.)
- CSV, JSON, HTML, and Markdown reporters with pattern grouping
- LLM-ready JSON with htmlSnippet, failureSummary, rawSelector
- Per-site timestamped report folders (preserved for diffing)
- SIGINT handling with partial report writing
- CI/CD mode with machine-readable JSON output
- a11y.config.ts single source of truth
- 114 unit tests across CLI and web
Phase 2 — Extended Reporters
In ProgressAdditional output formats and reporting enhancements.
- Markdown reporter for GitHub issues and PRs ✓
- Report diffing: compare two scans to show new/resolved patterns
- Trend tracking across multiple scan runs
- Summary email digest for scheduled server scans
Phase 3 — Interactive Wizard
In ProgressGuided mode for users who don't want to memorize CLI flags.
- Interactive wizard via readline (no external dependencies) ✓
- Report auto-pruning with --keep flag ✓
- Prune subcommand for manual report management ✓
- Saved scan profiles (re-run common scans with one command)
- Profile management: create, list, edit, delete
- a11yscan --profile production shorthand
Phase 4 — Puppeteer Fallback
PlannedAlternative browser engine for environments where Playwright is unavailable.
- Puppeteer scanner as drop-in alternative
- --engine puppeteer flag
- Shared ScannerManager interface between engines
Phase 5 — Marketing Site
In ProgressPublic-facing site at a11yscan.dev for documentation and demos.
- Nuxt 4 + Nuxt UI 4.5.1 static site ✓
- Deployed to Netlify via pnpm generate ✓
- WCAG 2.1 AA compliant ✓
- Interactive demo and pattern gallery
- SEO and OpenGraph metadata