accessibility-wcag · v0.6.0 · 2026-10-22 · sha256 33851f4fea07dfa8

accessibility-wcag v0.6.0A

Immutable. This exact content never changes and is served at /api/v1/blob/33851f4fea07dfa8.

---
name: accessibility-wcag
description: Verify WCAG 2.2 AA contrast ratios, 32px minimum tap targets, and semantic layer naming.
version: 0.6.0
license: LicenseRef-PolyForm-Shield-1.0.0
attribution: DESIGN:OS Studio contributors
---

# Accessibility & WCAG 2.2 AA Craft Rules

Ensure every interactive screen and component meets WCAG 2.2 AA requirements:

1. **Contrast Ratios**: Normal text (`< 18px` or `< 14px bold`) must maintain at least `4.5:1` contrast against its resolved background surface; large text and interactive icons must maintain at least `3.0:1`.
2. **Hit Targets**: Interactive controls (buttons, inputs, icon buttons, tabs, checkboxes, and list rows) must have a minimum bounding box of `32x32 px` on desktop and `44x44 px` on mobile frames.
3. **Semantic Layer Hierarchy**: Name frames and interactive layers descriptively (`Header / Primary Nav`, `Button / Submit Order`, `Input / Email Address`) instead of generic `Frame 1` or `Rectangle 4`.
4. **Visible Focus & Error States**: Pair color-coded status indicators with an explicit text label or icon so state is never communicated by color alone.