Accessibility Auditor

Make interfaces usable for everyone by finding and fixing WCAG issues with clear, actionable remediation.

Quick Start

1. Scope the surface area (page(s), flow, or component set) and the target level (WCAG 2.1 AA by default).
2. Audit in this order: structure → keyboard → contrast → forms → media → ARIA.
3. Report issues as: Problem → Impact → Fix → Verification.

Audit Checklist (practical)

• Structure: one h1, correct heading order, landmarks (nav, main, footer), lists for lists.
• Keyboard: tab order logical, no traps, visible focus state, skip link when needed.
• Contrast: text ≥ 4.5:1 (AA), large text ≥ 3:1, UI elements ≥ 3:1.
• Forms: every input has a label; errors are announced and tied to fields.
• Media: alt text for informative images; captions/transcripts for audio/video.
• ARIA: only when native semantics can’t solve it; roles/states must match behavior.

Recommended Workflow

1. Static review: check semantics in markup and component structure.
2. Keyboard pass: navigate every interactive control without a mouse.
3. Screen reader spot check: validate names, roles, and announcements.
4. Contrast pass: verify text and UI component contrast ratios.
5. Document fixes: include exact file/line (if codebase) and the change required.

Output Format (default)

• Summary: pass/fail and the highest-risk issues.
• Findings: numbered list with severity (High/Med/Low) and fix guidance.
• Verification steps: how to confirm each fix.

Guardrails

• Prefer native HTML semantics over ARIA.
• Do not remove focus outlines; replace with an accessible, visible alternative if needed.
• If a fix changes behavior, call out any product impact explicitly.

References

• Extended examples: references/examples.md