Triage design system v0.13.1-experiment
Home / Review / Audit & findings

Audit & findings

Findings register with current statuses (historical record — normative rules live in spec/rules.json, spec/states.json and INTERACTION.md).
How this audit was run. The layer checklist follows Tcules' trace model (tokens → component contract → design/code agreement → accessibility → documentation → product use), and the contrast thresholds are WCAG 2.2 (4.5:1 text, 3:1 large/non-text). Every number below is computed from the served sheets at render time — open the page and the measurements are live.

Normative, historical, proposals — how to read this site

when documents disagree, the normative layer wins — drift between them is a bug
Findings register — 0.2 status
0.1 findings are resolved; the open list is about growth, not integrity.
F1

Contrast — resolved and enforced

The accent darkened to #0068e0 (4.96:1 on --bg), warning text to #a85708 (4.93:1 on its tint), nav labels now use --text-secondary (#666, 5.74:1), placeholders use --placeholder (#767676, 4.54:1). All text pairs pass; lint rule TDS011 now fails CI if any configured token pair drops below 4.5:1 / 3:1.

Fix: Enforced by TDS011; measured on /foundations/color.
F2

Control boundaries — resolved

Form controls now use --border-control (#8f8f8f, 3.23:1) for the 3:1 non-text boundary; the decorative --line border stays light by design. TDS011 covers the control-boundary pair.

Fix: Enforced by TDS011.
F3

Micro-text floor — raised to 12px

0.9.0 raised badges/nav labels/proposal tags and copy/kbd/table-header labels to ≥12px (0.75–0.875rem) at the default 16px root; the compact density keeps them ≥12px at its 15px root.

Fix: Resolved in 0.9.0; no label-like content uses the old 9.6–9.9px tier.
F4

Spacing — tokenised

tokens.json now publishes 47 spacing steps (main scale + fine/observed) as --space-*; core consumes tokens and lints clean.

Fix: Prefer the main scale for new work; use TDS005 to catch arbitrary values.
F5

All token groups — emitted

Typography, spacing, motion, z-index, shadows, icon sizes, border widths, opacity and a data-viz series are all emitted as custom properties from tokens.json; core consumes semantic aliases only (TDS012).

Fix: Done in 0.2.
F6

Off-palette red — removed

The tokenizer mapped the last literal red (#d33) to --status-danger; core contains no raw colour literals.

Fix: Done in 0.2.
F7

Dead radius declarations — removed

The nullified 3px/8px radii are gone; radius policy is zero with a documented exception (allowRadius: 50%% for the spinner).

Fix: Done in 0.2.
F8

Flow-segment focus ring — fixed

The translucent --focus-ring outline was replaced by the solid --interactive outline (5.18:1), matching the global ring.

Fix: Done in 0.2.
F9

Icon system — sprite shipped

174 Lucide glyphs (ISC) ship as icons/sprite.svg with icons.json and size tokens; core consumes the sprite from its icon block. Keep duplicate meanings disambiguated when adding new screens.

Fix: Resolved after 0.2; catalogue at /components/catalog.
F10

Dark mode — shipped

Every colour primitive (and data-viz series) has a dark value; tokens.css emits prefers-color-scheme + [data-theme=dark]; surfaces rise by luminance instead of shadows; forced-colors and print covered.

Fix: Choose per-app: OS preference or explicit data-theme.
F11

Extraction gaps — merged and matrix-verified

.px-sw, the armed-delete delegate and the current condition rows are in core; spec/states.json now verifies every component's state selectors in CI, and the rename sweep is checked on every build.

Fix: Done in 0.2.
F12

Hard-coded literals — eliminated in core

Core consumes tokens only (0 findings under its own rules, 100/100). The pack-era literal list is kept as history on /foundations/color.

Fix: Consumer projects are held to the same bar by TDS002/TDS009/TDS012.
F13

Data-viz ramp — categorical only

The 8-colour categorical series ships with light+dark values and contrast checks, but ordered data (heatmaps, scales) has no sequential/diverging ramp yet.

Fix: Add a 5–7 step monochromatic ramp based on series 1.
F14

Distribution — packaged

make package builds dist/triage-design-system-.tgz; the artifacts are hash-tracked and /system documents versioned releases. Remaining growth item: a CI metrics trend artifact.

Fix: See /system and build.py package.

Coverage matrix

the pack is presentation-only; behaviour columns point at the scripts it ships or the source app it came from
FamilyLive atCSSBehaviourSource-app tests
Buttons/components/buttonsbase.css .btn/.iconbtn/.seg/.copyshell.js copy; app.js guardApplyT58 (source app)
Forms/components/formsbase.css inputs/label/fieldset/.savebarshell.js submit guard docsT58
Switch/components/forms#switchcore/base.css (P1 merged)app.py __triageArmDel sibling (P2)T58 pins markup
Table / list/components/database.css .tbl/.rowacts/.bulkbar/.pager + mcardspage scripts in appT58/source
Badges / chips / dots/components/database.css——
Feedback / toast/components/feedbackbase.css .msg/.note/.empty/.toast2shell.js toast()T58
Chat / assistant/components/chatbase.css chat block + app.js engineapp.js chatEngine + SSEsource app
Menus / armed delete/components/overlayscore/base.css menu + P2core/shell.js armed deleteT58
Shell / nav/components/navigationbase.css shell blockshell.js drawer/menussource app
Patterns ×7/patterns/dashboardpatterns.css (labelled sections)page scripts in appUX suites in source app

Layer checklist (research model — statuses updated to 0.12)

LayerVerdict for this systemEvidence
Scope & ownershipSingle-app system, one owner (the app repo); no consumed-by matrixREADME/PORTING
Tokens & foundationsAll foundations tokenised and emitted (F4/F5): palette, spacing, type, motion, z-index, shadows, radius; TDS002/TDS005/TDS006/TDS009 guard the layer/foundations/*
Component contractStates documented component-by-component (default/hover/focus/disabled/busy/error/empty/overflow) in components.md + live demos/components/*
Design–code agreementBy construction: the pack is a mechanical extraction (css/base.css ↔ BASE_TMPL). Drift exists only vs later app commits (F11)pitfalls §14, AUDIT P1/P2
AccessibilityWCAG 2.2 scorecard with measured contrast; all text pairs pass; TDS011/TDS014/TDS015 enforce pairs, alt text and accessible names/foundations/accessibility
DocumentationComplete: INTERACTION.md (binding), MIGRATION.md, PROVENANCE.md, RENAME-MAP.md, tokens.json, docs index/docs
Contribution & releaseVersioned (VERSION), packaged (make package), provenance pipeline (PROVENANCE.md); consumer telemetry out of scope by design/system
Product useThe running product here is the skeleton kit itself; no telemetry on copies/detaches/screens

Research register (what filled the holes)

all links verified reachable 2026-10-06
SourcePublisherWhat it informed
Design Tokens Format Module 2025.10 (DTCG)W3C Design Tokens Community Grouptokens.json structure: $value/$type tokens, groups, aliases with {group.token}, application/design-tokens+json media type. The kit has no token file; this portfolio emits one.
Easing and duration — Material Design 3Google MaterialMotion-token comparison: suggested 200–500ms ranges per transition type (enter/exit/on-screen) against the system's 120–400ms values; the motion page's token table.
A guide to designing accessible, WCAG-conformant focus indicatorsSara SoueidanFocus audit: SC 2.4.7 (visible indicator), SC 1.4.11 (3:1 against adjacent colours), SC 2.4.13 (2px perimeter + 3:1 change). Used to score the kit's global :focus-visible ring and input ring.
How to Audit a Design System, with a ChecklistTculesThe audit page's layer checklist (scope/ownership, tokens, component contract, design–code agreement, accessibility, documentation, contribution/release, product use) and the trace-a-component approach.
Spacing unitsU.S. Web Design SystemSpacing-scale comparison: USWDS uses multiples of 8px plus small-step tokens. Informed the spacing page's 2/4px-grid normalisation of the observed values.
Naming Tokens in Design SystemsNathan CurtisToken-naming guidance (scale + semantic two-tier naming) behind the proposed colour alias tier in tokens.json.
Web Content Accessibility Guidelines (WCAG) 2.2W3CContrast thresholds applied in the colour audit: 4.5:1 normal text, 3:1 large text and non-text UI (1.4.11), 24×24 CSS px minimum target (2.5.8, AA), 44px shown as the kit's own stronger target.

Where things stand

  • Open findings: F13 — add a sequential/diverging ramp for ordered data-viz; F14 residual — a CI metrics trend artifact.
  • Open proposals (spec/proposals/): four verification levels with rule-traceable evidence; a formal machine-action provenance contract; splitting core invariants from theme opinions; density and border discipline.
  • Resolution log: historical fixes live in CHANGELOG.md; this register keeps current statuses only and is never normative.
Triage Design System v0.13.1-experiment — the central, app-agnostic UI design authority. Source of truth: /tokens/tokens.json. Showcase chrome only: site/.