Skip to content

Roadmap

a11yscan is built in phases. Each phase ships independently and is fully usable on its own.

Phase 1 — CLI Scanner

Complete

The 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 Progress

Additional 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 Progress

Guided 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

Planned

Alternative 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 Progress

Public-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
</> a11yscan

Pattern-aware accessibility auditor. Groups thousands of violations into actionable patterns for ARIA roles, accessible names, and color contrast.

MIT License. Built with Nuxt, Playwright, and axe-core.

v1.5.0|Changelog|Illinois Criminal Justice Information Authority