Accessibility Auditor

Accessibility isn't optional but checking for it manually is painful. This tool scans your HTML and JSX files for WCAG violations and tells you exactly what's wrong and how to fix it. No more guessing if your alt text is right or your heading hierarchy makes sense.

One command. Zero config. Just works.

Quick Start

npx ai-a11y src/

What It Does

Scans HTML and JSX files for WCAG 2.1 AA violations
Catches missing alt text, broken heading hierarchy, and color contrast issues
Generates specific fix suggestions with code examples
Supports glob patterns so you can target specific directories
Reports severity levels so you know what to fix first

Usage Examples

# Scan your entire src directory
npx ai-a11y src/

# Scan specific component files
npx ai-a11y src/components/Button.tsx

# Scan all JSX files
npx ai-a11y "src/**/*.jsx"

Best Practices

Run it before every PR - Catch a11y issues before code review, not after
Start with your most visited pages - Fix the high traffic stuff first
Don't ignore warnings - Warnings today become lawsuits tomorrow
Pair with manual testing - Automated checks catch about 30% of real a11y issues. Use a screen reader for the rest.

When to Use This

You're building a public facing web app and need WCAG compliance
Your team doesn't have a dedicated a11y reviewer
You inherited a codebase with zero accessibility consideration
You want to catch obvious violations before a manual audit

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

GitHub: https://github.com/LXGIC-Studios
Twitter: https://x.com/lxgicstudios
Substack: https://lxgicstudios.substack.com
Website: https://lxgic.dev

Requirements

No install needed. Just run with npx. Node.js 18+ recommended.

npx ai-a11y --help

How It Works

The tool reads your HTML or JSX files and extracts the DOM structure. It checks against WCAG 2.1 guidelines for common violations like missing labels, poor contrast ratios, and incorrect ARIA usage. Then it sends the issues to an AI model that generates specific, actionable fix suggestions with code.

License

MIT. Free forever. Use it however you want.

a11y-auditor