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| Action | Consequence copy must say |
|---|---|
| Remove an account / integration | credentials + the config entry are deleted |
| Reset cached credentials | the user must re-authorise |
| Rebuild a search index | source data itself is untouched |
| Clear a chat | clears this chat only |
| Enable auto-apply | the system will act on its own |
| Approve a plugin browser view | it 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 filteroptional 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/.