# Cadence Design System

> The design system for Cadence, a workforce-orchestration platform. Warm and editorial —
> warm paper, deep ink, three typefaces with strict jobs. Jade (#2F8F68) is the only brand
> color and marks the user's committing action; purple (#6B4FE0) belongs to the AI alone.
> A dark theme (warm brown-black) remaps every token. Built to be read by people and machines.

## Docs

- [Overview](https://design.cadencework.ai/index.md): the system in one paragraph
- [Foundations](https://design.cadencework.ai/foundations.md): color, 25 token roles (light+dark), typography, icons, layout, motion, number formatting
- [Components](https://design.cadencework.ai/components.md): buttons, forms, chips, cards, progress, data display, feedback, overlay, charts, media
- [Patterns](https://design.cadencework.ai/patterns.md): AI surfaces (chat + canvas), rules of the agent, dark theme, outcomes
- [Native](https://design.cadencework.ai/native.md): iOS/Android — Crew worker app, mobile rules, platform tokens
- [Brand](https://design.cadencework.ai/brand.md): wordmark, why jade, imagery
- [Voice](https://design.cadencework.ai/voice.md): calm, direct, names over roles; write-like-this / never-this pairs
- [Getting started](https://design.cadencework.ai/getting-started.md): install, ground rules, machine-readable exports
- [Changelog](https://design.cadencework.ai/changelog.md): version history (current: v1.1)

## Machine-readable

- [Full system](https://design.cadencework.ai/llms-full.txt): everything in one file
- [tokens.json](https://design.cadencework.ai/tokens.json): W3C design tokens, source of truth
- [tokens.css](https://design.cadencework.ai/tokens.css): CSS custom properties, both themes
- [tokens.swift](https://design.cadencework.ai/tokens.swift): SwiftUI colors (trait-resolved light/dark) + space/radius/motion
- [tokens.kt](https://design.cadencework.ai/tokens.kt): Compose CadenceLight/CadenceDark + space/radius/motion
- [CLAUDE.md](https://design.cadencework.ai/CLAUDE.md): drop-in instructions for coding agents

## Hard rules (never violate)

- One jade committing action per surface; hover deepens color, nothing moves or scales
- Purple only where the agent acts — never in charts, never as decoration
- Status is a chip, never a bare dot; progress always carries a number or label
- Sentence case everywhere; no emoji; no exclamation points; names over roles
- Fraunces never sets body text; mono for times, money, counts, statuses
- Respect prefers-reduced-motion by dropping all loops