Components
Button
The main way to act. One primary button per view; everything else steps down.
Press Save changes to see the busy state
<button class="btn">Save</button>
<button class="btn btn-outline btn-sm"><svg>…</svg>Filter</button>
<button class="btn btn-ghost btn-icon" aria-label="Close"><svg>…</svg></button>
<button class="btn" aria-busy="true" disabled><span class="spinner"></span>Saving</button>
Variants
| Class | Look | Use |
|---|---|---|
.btn |
Near-black fill, depth-raised-fill. Hover: fill at 80% |
The one primary action |
.btn-outline |
0.5px border, depth-raised. Hover: muted fill |
Most secondary actions, toolbars |
.btn-secondary |
Secondary fill, depth-raised |
A filled alternative to outline |
.btn-ghost |
Flat. Hover: muted fill | Icon buttons, low-emphasis actions in dense rows |
.btn-destructive |
Destructive at 10% fill, destructive text | Delete, remove, revoke |
.btn-link |
Text only, underline on hover | Inline actions in prose |
Sizes
| Class | Height | Text | Icon | Radius |
|---|---|---|---|---|
.btn-xs |
24px | 12px | 12px | 8px |
.btn-sm |
28px | 12.8px | 14px | 8px |
| (default) | 32px | 14px | 16px | 10px |
.btn-lg |
36px | 14px | 16px | 10px |
Add .btn-icon for a square icon-only button at any size. Padding is 10px
(8px at extra small), with a 6px gap between icon and label.
States
| State | How to trigger | Look |
|---|---|---|
| Hover | — | Grows the ambient shadow layer only; the control hasn't moved |
| Press | :active |
Moves down 1px and drops its shadow, so the gap to the surface closes. Skipped on menu triggers (aria-haspopup) |
| Focus | :focus-visible |
3px ring at 50% ring |
| Disabled | disabled / aria-disabled="true" |
50% opacity, no shadow, not clickable |
| Busy | aria-busy="true" plus disabled |
Spinner before the label, full opacity, not clickable. Busy is not unavailable |
| Menu open | aria-expanded="true" |
Outline and ghost keep their hover fill |
| Invalid | aria-invalid="true" |
Destructive border and ring |
Rules
- Never a solid red button. Destructive is a tint.
- Ghost buttons never get a shadow: a shadow under nothing looks like a rendering bug.
- On sparse marketing pages, primary buttons are flat (no shadow); there the shadow reads as grime.
- Labels are sentence case verbs: "Add to Linear", not "Linear Integration".
- Icon-only buttons always have an
aria-label.