Variant State Rendered at 1pt = 1px on a 393pt iPhone canvas. Tap to feel the pressed state.
What & when
Use it for
- Primary: the one action you want taken on this screen (Next, Get started).
- Secondary: a real alternative next to a primary (Skip, Review).
- Ghost: low-stakes actions inside cards or toolbars.
- Destructive: the final, irreversible step (Delete account).
Don’t use it for
- Never place two primary buttons on one screen.
- Not for navigation between tabs — use the Tab Bar.
- Not for picking an answer — use the Answer Chip.
Anatomy & specs
All values in pt. Click a value to copy.
- Height
- Horizontal padding
- Icon–label gap
- Icon / spinner size
- Pressed scale
- Disabled opacity
- Corner radius (radius-pill)
Tokens
Every colour and text style comes from the Brand Kit.
- primary
- on-primary
- surface-muted
- label
- primary-text
- error
- on-error
- Headline
- 17/22pt · 700
Accessibility
Dynamic Type, VoiceOver & contrast
- 56pt height clears the 44pt minimum touch target.
- Label scales with Dynamic Type (Headline); the button grows in height, never truncates.
- VoiceOver: trait .button. Loading announces “Loading” and sets the button to not enabled.
- Primary label on cobalt passes AA in both appearances.