Undocumented designs lead to Slack messages, guesswork, and mismatched implementations.
What to Document
- Spacing and sizing for every component
- Color tokens and when to use each
- Interaction states and animations
- Responsive behavior at each breakpoint
- Edge cases (long text, empty states, errors)
Where to Document
Figma annotations for visual specs. Notion or Confluence for process and rationale. Storybook for component code examples.