Triage design system v0.13.1-experiment
Home / Foundations / Voice & copy

Voice & copy

The copy standard: sentence case, Enable/Disable, announce every mutation, name the object.

The rules

distilled from docs/ui-conventions.md
  • Sentence case for buttons, links, menu items. Micro-labels (badges, nav groups) are uppercase by CSS, not by copy.
  • Verbs are Enable / Disable for entity state — never Pause/Resume or On/Off variants. Non-boolean transitions (Retire, approve, save permissions) stay text buttons.
  • Announce every mutation in past tense, naming the object: “Rule 'News' disabled.”, “Chat deleted.”, “Sample moved to the in-set — Promo.”
  • Three flash kinds only — ok (green), warn (amber), err (red). info is retired.
  • Name the object in destructive labels and aria-labels. “Delete rule 'News'”, not “Delete”.
  • Empty states: title + one-line reason + at most one action. Never a bare blank area or a bare “failed”.

One-way actions keep a native confirm()

arming cannot carry the consequence — six high-stakes actions are the exhaustive list
ActionConsequence copy must say
Remove an account / integrationcredentials + the config entry are deleted
Reset cached credentialsthe user must re-authorise
Rebuild a search indexsource data itself is untouched
Clear a chatclears this chat only
Enable auto-applythe system will act on its own
Approve a plugin browser viewit can transmit data by navigating itself

Announcement patterns

Rule 'News' disabled. (flash, redirect)
Saved, but the index did not rebuild — press Rebuild to retry. (partial outcome → warn)
Folder “Finance” is not in the folder map. (specific reason, names the object)
Sample moved to the in-set — Promo. (toast, in place)
past tense · names the object · the kind matches the outcome

Empty state anatomy

No rules match this filter

Clear the filter to see all 12 rules, or create a rule for these messages.

Clear filter
optional icon slot exists (30px svg, 40% opacity) but is optional
Triage Design System v0.13.1-experiment — the central, app-agnostic UI design authority. Source of truth: /tokens/tokens.json. Showcase chrome only: site/.