React · SwiftUI · agent guides
Button
A press-in pill button. It sinks 1px into a well while held and springs back on release: standard, primary and destructive caps at 32 or compact 26, and the link, graphite and strip caps. Tailwind v4 utilities from the theme.
Use it for
- An action that happens right away when the user activates it: Save, New Canvas, Cancel, Delete, Export.
- A dialog footer, form submit, or row action that needs a visible, labelled control.
Don't use it for
- Navigation to another page. Use a link.
- On/off or latched tool state. Use Toggle / ToolButton, which carry the pressed state and LED.
- Icon-only toolbar controls. Use ToolButton inside Toolbar.