The living catalog

Elements02/15

Button

G2G7C3

Every click that isn't a row or a pad. Machined edge, 1px of real travel; strength is structure, never glow.

Posture

Variants

Printed keys (G2) & states

npx candlelight-ds add button

Use when

Forms, headers, overlays, empty-state actions.

Don't use when

Persistent surface controls (TransportButton), one-shots (Pad), or status tokens (Chip).

States
primarydestructiveoutlinesecondaryquietlinkdisabledwith printed key
Keyboard
  • Enter/Spaceactivates (native button)
Acceptance
  • Exactly one primary per view region (C3).
  • Every variant travels 1px on press.
  • Destructive wears the cold danger tone — red never invites.

Raw twin: /components/button.md·Registry item: /r/button.json