Home / Review / Design docs index
Design docs index
Every design record served by this site, with a one-line gloss.
System package
the source of truth going forwardArchive — the original design pack
files are served raw from the packreferences/ — distilled rules
start with pitfalls.md| File | What it covers |
|---|
| Palette, type, layout constants, z-index, motion — the distilled token sheet. |
| The working component catalogue with markup recipes. |
| One-line index of every class in base.css + patterns.css. |
| Scripts, load order, chat engine, Turbo rules. |
| Phone behaviors, breakpoints and the QA recipe. |
| READ BEFORE PORTING — the 14 traps. |
design-docs/ — the original records
served under /design-docs/ (raw markdown)| File | What it covers |
|---|
| README.md | Index + reading order for the design records. |
| ui-redesign.md | The app-wide visual redesign record. |
| ux-benchmarks.md | Benchmarks and rationale for interaction choices. |
| app-inventory.md | Page-by-page inventory used during the redesign. |
| research-shell.md / research-lists.md / research-forms.md | Research briefs for shell, list and form patterns. |
| critique-round1.md + critiques/ | Review rounds with desktop/mobile findings. |
| mobile-ui.md / mobile-ui-research.md | The phone-first pass and its research. |
| dashboard-mobile.md / messages-mobile.md / assistant-mobile.md | Per-page mobile records. |
| dashboard-recent-mail.md | Why the dashboard feed is a stacked list, not a table. |
| undo-triage-snooze.md | Reversible-action design. |
| spa-turbo.md | Turbo/SPA layer rules. |
| flows-builder-v2.md / flows-fuzzy-classifier.md | Flow builder records. |
Portfolio records
these are the portfolio's own records, not pack content| File | What it is |
|---|
| site/README.md | how this audit site is built, run and served (incl. Tailscale) |
| site/AUDIT.md | the durable findings record: measured contrast table, P1–P3 restoration provenance, research register |
| docs-from-app/ui-conventions.md | verbatim copy of the app's interaction standard (not in the pack; its class/global names predate the rename sweep — see RENAME-MAP.md) |
Screenshots
design-docs/screenshots + design-docs/img