Triage design system v0.13.1-experiment
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 forward
FileWhat it is
system/README.mdwhat Triage is, how to consume it, theming, governance, decoupling status
CHANGELOG.mdversion history
INTERACTION.mdthe binding interaction standard (one mechanism per recurring action)
MIGRATION.mdthe 0.6 → 0.12 upgrade guide and checklist
PROVENANCE.mdfile-by-file origin of every generated artifact
RENAME-MAP.mdthe complete old → new vocabulary map
spec/proposals/open proposals under review — draft changes, never binding
tokens/tokens.jsonthe token source of truth (DTCG)
build.pyassembler, --check guard, provenance hashes

Archive — the original design pack

files are served raw from the pack
FileWhat it is
README.mdwhat the design is + kit contents
PORTING.mdthe step-by-step adoption playbook
CREDITS.mdprovenance + licenses
ui-conventions.md (not in pack)the interaction standard — copied into site/docs-from-app/ because the pack predates it

references/ — distilled rules

start with pitfalls.md
FileWhat 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)
FileWhat it covers
README.mdIndex + reading order for the design records.
ui-redesign.mdThe app-wide visual redesign record.
ux-benchmarks.mdBenchmarks and rationale for interaction choices.
app-inventory.mdPage-by-page inventory used during the redesign.
research-shell.md / research-lists.md / research-forms.mdResearch briefs for shell, list and form patterns.
critique-round1.md + critiques/Review rounds with desktop/mobile findings.
mobile-ui.md / mobile-ui-research.mdThe phone-first pass and its research.
dashboard-mobile.md / messages-mobile.md / assistant-mobile.mdPer-page mobile records.
dashboard-recent-mail.mdWhy the dashboard feed is a stacked list, not a table.
undo-triage-snooze.mdReversible-action design.
spa-turbo.mdTurbo/SPA layer rules.
flows-builder-v2.md / flows-fuzzy-classifier.mdFlow builder records.

Portfolio records

these are the portfolio's own records, not pack content
FileWhat it is
site/README.mdhow this audit site is built, run and served (incl. Tailscale)
site/AUDIT.mdthe durable findings record: measured contrast table, P1–P3 restoration provenance, research register
docs-from-app/ui-conventions.mdverbatim 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
Triage Design System v0.13.1-experiment — the central, app-agnostic UI design authority. Source of truth: /tokens/tokens.json. Showcase chrome only: site/.