Back to Playbook

Buttons

Buttons are used to trigger actions. They should clearly communicate what will happen when the user clicks them.

Button Playground

Customize the button properties to see how they affect the component.

Why it matters

Buttons are the primary way users interact with your interface to take action. Clear, consistent, and accessible buttons reduce friction and help users complete tasks confidently. A confusing button hierarchy can lead to errors or hesitation.

Button Hierarchy

Primary

High emphasis. Used for the main action on a screen (e.g., "Save", "Submit"). Only one per section.

Secondary

Medium emphasis. Used for alternative actions (e.g., "Cancel", "Back"). Can appear multiple times.

Tertiary / Ghost

Low emphasis. Used for less important actions or to reduce visual noise.

Destructive

Used for actions that delete or remove data. Often styled in red to warn the user.

Usage Checklist

  1. Clear Labels

    Use action verbs (e.g., "Save", "Send") instead of generic terms like "OK" or "Yes".

  2. Visual States

    Define clear styles for hover, active (pressed), focus, and disabled states.

  3. Size & Touch

    Ensure buttons are large enough to be easily tapped on mobile devices (min 44px height).

Previous: Overview Next: Forms