Actions · core

Button

action.button

A button is a pressable control that invokes an immediate action.

buttonthe thing you clickthe action control

States5

Touch target44px

Evidence6

Introduced by8 kits

Visual specimen

Same contract. Every kit voice.

MAVAN renderingdefault

Translation table

What code calls it.

Web<button>The closest native or standardized web primitive.direct

ARIAbuttonThe primary accessibility role or state pattern.direct

SwiftUIButtonThe nearest named SwiftUI API.direct

AppKitNSButtonThe nearest named AppKit API.direct

Anatomy

Every part, named.

1Interactive container
2Visible label or icon
3Action target
4State treatment
5Focus indicator

Often confused with

Similar shape. Different contract.

Link buttonaction.link-button

Shares a visual family, but has a different role, state model, or interaction contract.

Toggle buttonaction.toggle-button

Shares a visual family, but has a different role, state model, or interaction contract.

Prompt · paste into your agent

Ask for the exact thing.

Implement the canonical Button component (action.button). A button is a pressable control that invokes an immediate action. Support these states: default, hover, focus-visible, active, disabled. Use semantic design tokens rather than raw visual values. Preserve a minimum 44px touch target where interactive. Provide and verify: implementation, state-matrix, responsive, keyboard, touch, reduced-motion. Keep the component API stable so every Studio kit can supply its own rendering without changing the behavior contract.

Studio contract

What must be proven.

Required states

default · hover · focus-visible · active · disabled

Required evidence

implementation · state-matrix · responsive · keyboard · touch · reduced-motion

Source union

mavan · jade · lumen · aurora · cabana · purple-rain · spatial · margin