---
site: ui.zyx.tw
url: https://ui.zyx.tw/switch
title: Switch
description: "On / off toggle, one size."
---

# Switch

On / off toggle, one size.

Group: Controls.

## Install

```bash
bunx shadcn@latest init https://ui.zyx.tw/r/base.json
bunx shadcn@latest add @zyx1121/switch
```

The first line sets a project up on the base; skip it if the project already has it.

## Item

### Switch (`switch`)

On / off toggle, one size.

- Install: `bunx shadcn@latest add https://ui.zyx.tw/r/switch.json`
- JSON: [switch.json](https://ui.zyx.tw/r/switch.json)
- Page: [https://ui.zyx.tw/switch](https://ui.zyx.tw/switch) ([Markdown](https://ui.zyx.tw/switch.md))
- npm dependencies: `@base-ui/react`, `cn`
- Registry dependencies: `https://ui.zyx.tw/r/utils.json`

## More

- [Index](https://ui.zyx.tw/index.md): every item
- [Agent instructions](https://ui.zyx.tw/agent-instructions.md): the call order and the rules
- [DESIGN.md](https://github.com/zyx1121/www.zyx.tw/blob/main/apps/ui/DESIGN.md): the design contract
