> ## 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.

# EquaSwitch

> Design system reference for EquaSwitch, including Storybook, Figma, screenshots, and usage guidance

# EquaSwitch

> **Last Verified:** 2026-05-20 | **Storybook source:** `equa-patternlib-nextjs/stories/EquaSwitch.stories.tsx`, Line: 6

## Purpose

Binary switch controls for settings and preferences.

## Storybook

| Story            | Reference                                                                     |
| ---------------- | ----------------------------------------------------------------------------- |
| Default          | [Storybook](http://localhost:6006/?path=/story/equa-switch--default)          |
| With Label       | [Storybook](http://localhost:6006/?path=/story/equa-switch--with-label)       |
| Sizes            | [Storybook](http://localhost:6006/?path=/story/equa-switch--sizes)            |
| Label Positions  | [Storybook](http://localhost:6006/?path=/story/equa-switch--label-positions)  |
| Custom Color     | [Storybook](http://localhost:6006/?path=/story/equa-switch--custom-color)     |
| Disabled         | [Storybook](http://localhost:6006/?path=/story/equa-switch--disabled)         |
| Group            | [Storybook](http://localhost:6006/?path=/story/equa-switch--group)            |
| Settings Example | [Storybook](http://localhost:6006/?path=/story/equa-switch--settings-example) |
| All Variants     | [Storybook](http://localhost:6006/?path=/story/equa-switch--all-variants)     |

## API And Props

| Prop or Control | Source            | Notes                                |
| --------------- | ----------------- | ------------------------------------ |
| `size`          | Storybook control | See source story for accepted values |
| `labelPosition` | Storybook control | See source story for accepted values |
| `disabled`      | Storybook control | See source story for accepted values |

Sources:

* `equa-patternlib-nextjs/src/components/switch/switch.tsx`, Line: 5
* `equa-patternlib-nextjs/src/components/switch/index.ts`
* `equa-patternlib-nextjs/stories/EquaSwitch.stories.tsx`, Line: 6

## Figma

UNVERIFIED -- requires Figma node assignment

## Screenshots

| State           | Asset                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Equa dark theme | <img src="https://mintcdn.com/equainc/KxDhtr750a40VJd3/images/design-system/components/equa-switch/equa-switch--all-variants-equa.png?fit=max&auto=format&n=KxDhtr750a40VJd3&q=85&s=f603e6dc47b2d84d1073e8612b981f77" alt="EquaSwitch dark theme" width="1366" height="900" data-path="images/design-system/components/equa-switch/equa-switch--all-variants-equa.png" />          |
| Light theme     | <img src="https://mintcdn.com/equainc/KxDhtr750a40VJd3/images/design-system/components/equa-switch/equa-switch--all-variants-light.png?fit=max&auto=format&n=KxDhtr750a40VJd3&q=85&s=fd3d0d425a05f2078f5b4b3cc1d43a16" alt="EquaSwitch light theme" width="1366" height="900" data-path="images/design-system/components/equa-switch/equa-switch--all-variants-light.png" /> |

## 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.