accessibility-contrast-audit
[Design System] Quantitative accessibility audit for UI - contrast ratios, font sizes, tap targets,
作者 CANTAGESTUDIO|オープンソース
Accessibility & Contrast Audit
Quantitative accessibility checks for contrast, font size, hit areas, and semantic structure.
Quick Start
python3 scripts/audit_accessibility.py --source src/ --tokens tokens.json
WCAG Standards Reference
| Criterion | Level AA | Level AAA |
|---|---|---|
| Normal text contrast | 4.5:1 | 7:1 |
| Large text contrast (18px+ or 14px bold) | 3:1 | 4.5:1 |
| UI components/graphics | 3:1 | 3:1 |
| Minimum touch target | 44×44px | 44×44px |
| Minimum font size (body) | 16px | 16px |
Problem Types
| Type | Severity | Description |
|---|---|---|
low-contrast | error | Text/background contrast below WCAG threshold |
text-too-small | warning | Font size below recommended minimum |
hit-area-too-small | warning | Touch/click target below 44×44px |
heading-skip | warning | Heading levels skipped (h1→h3) |
missing-alt | error | Image missing alt text |