Home / Foundations / Accessibility
Accessibility
Focus, contrast, targets, reduced motion and status messages — scored against WCAG 2.2.
Global rule: :focus-visible{outline:2px solid var(--interactive);outline-offset:2px}.
Inputs additionally get border-color:#000; box-shadow:0 0 0 3px var(--focus-ring) on any focus.
click into this page and press Tab — never removed anywhere in the system
WCAG 2.2 scorecard (source audit)
* = passes with the noted caveat; 200% text reflow is verified per example screen in the browser layout matrix| Criterion | Status | Evidence |
|---|---|---|
| 2.4.7 Focus Visible (A) | pass | Global :focus-visible ring, explicit component-scoped rules for interactive controls; the only outline removals are replaced by border/box-shadow changes. Forced-colors keeps a Highlight outline on inputs. |
| 2.4.11 Focus Not Obscured (AA) | pass | html{scroll-padding-block:70px 80px} keeps focused controls clear of sticky topbar/savebar chrome. |
| 1.4.11 Non-Text Contrast (AA) | pass | Switch track/knob now use --control-border (#8f8f8f, 3.23:1); solid --interactive outline measures 5.18:1 on white; control boundaries use --border-control at 3.23:1. The translucent --focus ring alone is ~1.7:1 but always accompanies the solid outline. |
| 2.4.13 Focus Appearance (AAA) | partial | Global outline is 2px with a 3:1 colour change (passes). Inputs also pass via the outline; the flow-segment focus rule uses the translucent --focus for its outline (Q6) — upgrade to solid --acc. |
| 2.5.8 Target Size minimum (AA) | pass | Buttons 34/27px, chips 29px; small precision controls (disclosure summaries, copy, cond-remove, flow segments) now carry a 24px minimum via the 0.3 additions. Coarse pointers force 44px on buttons/nav/menu items and 48px nav rows. |
| 1.4.3 Contrast (AA) | pass | All text pairs pass after 0.2 (#0068e0 accent, #a85708 warning, #666 secondary, #767676 placeholder); enforced by TDS011 in CI. |
| 2.3.3 Animation from Interactions (AAA) | pass | prefers-reduced-motion collapses all animations to 0.01ms, slows the spinner, and disables view-transition groups explicitly. |
| 1.4.1 / forced colors | pass | forced-colors adds border/system-colour fallbacks where box-shadow is forced to none; print hides chrome. |
| 1.4.4 Resize Text | pass | Type is rem-based and scales. All four example screens (dashboard, list, form, viewer) reflow at 200% text (root 32px) with no page-level horizontal overflow at 320px and 390px; asserted per screen in tests/browser/fixtures/layout.html. |
| 4.1.3 Status Messages (AA) | pass | Flash banners carry role=status; the toast host is aria-live=polite; toggles/deletes announce via flash or toast by convention. |
| 1.4.10 Reflow | pass | Phone mode is a designed layout, not a scaled desktop; tables reflow to cards, no horizontal page scroll. |
Non-text contrast & touch
Focus outline
--interactive #0068e0 · 5.18:1 on white
Control boundary
--border-control #8f8f8f · 3.23:1 (decorative --line stays 1.26:1 by design)
Switch track
--line2 #d4d4d4 + blue checked state + knob contrast
Coarse target
44px buttons / 48px nav rows (@media(pointer:coarse))
Research grounding. SC thresholds and the 2px-perimeter focus model are cited from Sara Soueidan's WCAG focus-indicator guide (which quotes SC 2.4.7 / 1.4.11 / 2.4.13) and WCAG 2.2 itself: 4.5:1 text, 3:1 large/non-text, 24×24 target minimum. The kit's own 44px coarse target is stricter than AA.
Triage Design System v0.13.1-experiment — the central, app-agnostic UI design authority.
Source of truth: /tokens/tokens.json. Showcase chrome only:
site/.