Know Your Vote Kentucky
Design system
A living reference for the tokens and patterns behind KYVKY. This companion renders the v1.1 spec — the source of truth stays in guidelines.md, mirrored in globals.css, theme.ts, and tailwind.config.js.
8px
base spacing unit
AA
contrast floor, never a stretch goal
3
radius steps · 8 / 24 / full
Principles
The product reads as one trustworthy, neutral, accessible civic reference — closer to a reliable government tracking service than to a startup.
1
Legible over decorative
Dense legislative data — 1,400+ bills a session — has to scan. Whitespace, hierarchy, and restraint beat ornament.
2
Neutral, never editorial
Color must not imply a political position. A brand-critical constraint, not a preference.
3
Accessible by default
WCAG 2.1 AA is the floor. Every text pairing ≥4.5:1; every control has a visible focus ring and a 44px target.
4
One token, one meaning
A single semantic set. No duplicate keys that let two components drift apart.
What's inside
Foundations
Color, type scale, spacing, radius & elevation — the tokens of record.
Components
Buttons, forms, chips, feedback, and the new tabs / pagination / modal / tooltip specs.
Domain
Bill card + progress meter, member and committee cards.
Patterns
Navigation, marketing hero, and the welcome / digest emails.
Standards
The AA accessibility floor and the non-partisan voice guide.
Refinements
Proposed token, spacing, and hierarchy improvements — flagged, not yet shipped.