Governance - Accessibility
Variable Governance - Accessibility
Accessibility is a constraint on variables, not an afterthought. Variables should make accessible defaults easier to ship, not easier to bypass.
What variables should encode
- Color and contrast: Semantic color variables should be chosen so common UI combinations can meet contrast requirements.
- Focus visibility: Variables for focus rings (color, width, offset) should exist and be used consistently.
- Motion: Duration and easing variables should support reduced motion modes.
- Typography: Font sizes and line heights should avoid unreadable defaults.
Review expectations
When a variable changes:
- Identify impacted UI states (default, hover, active, disabled, focus).
- Verify contrast for intended pairings (text on surface, icon on surface, borders).
- Confirm focus variables remain visible across themes/modes.
- If the change affects motion variables, confirm reduced motion behavior.