> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.
# EquaButton
> Design system reference for EquaButton, including Storybook, Figma, screenshots, and usage guidance
# EquaButton
> **Last Verified:** 2026-05-20 | **Storybook source:** `equa-patternlib-nextjs/stories/EquaButton.stories.tsx`, Line: 15
## Purpose
Primary, secondary, danger, warning, cancel, icon, grouped, and loading actions.
## Storybook
| Story | Reference |
| -------------------- | --------------------------------------------------------------------------------- |
| Primary | [Storybook](http://localhost:6006/?path=/story/equa-button--primary) |
| Primary Slim | [Storybook](http://localhost:6006/?path=/story/equa-button--primary-slim) |
| Secondary | [Storybook](http://localhost:6006/?path=/story/equa-button--secondary) |
| Error | [Storybook](http://localhost:6006/?path=/story/equa-button--error) |
| Cancel | [Storybook](http://localhost:6006/?path=/story/equa-button--cancel) |
| Warning | [Storybook](http://localhost:6006/?path=/story/equa-button--warning) |
| Button Group Example | [Storybook](http://localhost:6006/?path=/story/equa-button--button-group-example) |
| All Variants | [Storybook](http://localhost:6006/?path=/story/equa-button--all-variants) |
| Icon Button Sizes | [Storybook](http://localhost:6006/?path=/story/equa-button--icon-button-sizes) |
| Icon Button Variants | [Storybook](http://localhost:6006/?path=/story/equa-button--icon-button-variants) |
| Loading Buttons | [Storybook](http://localhost:6006/?path=/story/equa-button--loading-buttons) |
| Icon Button Grid | [Storybook](http://localhost:6006/?path=/story/equa-button--icon-button-grid) |
## API And Props
| Prop or Control | Source | Notes |
| --------------- | ----------------- | ------------------------------------ |
| `disabled` | Storybook control | See source story for accepted values |
| `$slim` | Storybook control | See source story for accepted values |
| `$submitting` | Storybook control | See source story for accepted values |
Sources:
* `equa-patternlib-nextjs/src/components/button/button.tsx`, Line: 6
* `equa-patternlib-nextjs/src/components/button/index.ts`
* `equa-patternlib-nextjs/stories/EquaButton.stories.tsx`, Line: 15
## Figma
UNVERIFIED -- requires Figma node assignment
## Screenshots
| State | Asset |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Equa dark theme | 
|
| Light theme | 
|
## Usage Notes
* Prefer this component over local one-off UI for matching product states.
* Keep new variants represented in Storybook before adding docs references here.
* Use token-backed colors, spacing, radius, and shadows from [Foundations](/architecture/design-system/foundations).
## Accessibility Notes
* Preserve keyboard and focus behavior from the source component.
* Any icon-only controls must provide an accessible label in consuming product code.
* Validate color contrast in both Equa dark and light theme screenshots before release.