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, and 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 but not yet shipped.