# Introduction

> Accessible audio controls for React, Vue, Svelte and the web, as headless primitives and as styled components you copy into your shadcn/ui project. Built to be used by people and by AI agents.

**audio/ui** is a set of accessible, composable audio controls for the web, in React, Vue, Svelte or plain HTML: knobs, faders, XY pads, envelopes, meters, waveforms, timelines, sequencers, drum pads, piano keyboards and piano rolls.

Audio controls have many details: a knob has to drag, respond to the wheel and the keyboard, reset on double click, and be announced correctly by a screen reader. audio/ui implements them once.

## What to install

Both come from the `@audio-ui` registry, which puts the code in your project: you read it, change it and own it.

**The primitives** are headless: behavior and accessibility, no styles, one adapter per framework (React, Vue, Svelte and plain web components) over the same logic. Pick them when you have your own design system.

**React**

```bash
npx shadcn@latest add @audio-ui/knob-react
```

**Vue**

```bash
npx shadcn@latest add https://www.audio-ui.dev/r/styles/base-nova/knob-vue.json
```

**Svelte**

```bash
npx shadcn@latest add https://www.audio-ui.dev/r/styles/base-nova/knob-svelte.json
```

**JavaScript**

```bash
npx shadcn@latest add https://www.audio-ui.dev/r/styles/base-nova/knob-web.json
```

**In React**

**The styled components and ready blocks** are for projects that use shadcn/ui and Tailwind CSS v4.

```bash
npx shadcn@latest add @audio-ui/knob
```

## Top components

**In Vue, Svelte and Web**

Each links to its page, with its install and its usage in your framework.

**Top components**

| Name | Description |
| --- | --- |
| `Knob` | Rotary parameter with drag, wheel, keyboard and reset. [Docs](/docs/components/base/knob#installation). |
| `Fader` | Linear gain or parameter slider. [Docs](/docs/components/base/fader#installation). |
| `XY Pad` | Two parameters on one surface. [Docs](/docs/components/base/xypad#installation). |
| `Envelope` | Breakpoint editor for ADSR and other ramps. [Docs](/docs/components/base/envelope#installation). |
| `Meter` | Stereo and multi-channel level with peak hold. [Docs](/docs/components/base/meter#installation). |
| `Waveform` | Seekable waveform with a loop region. [Docs](/docs/components/base/waveform#installation). |
| `Plot` | Draggable curves for EQs, filters and compressors. [Docs](/docs/components/base/plot#installation). |
| `Timeline` | Zoomable arrangement view with a smooth playhead. [Docs](/docs/components/base/arrangement#installation). |
| `Sequencer` | Step grid to draw a pattern. [Docs](/docs/components/base/sequencer#installation). |
| `Pad` | Drum pads with velocity. [Docs](/docs/components/base/pad#installation). |
| `Piano Roll` | Note editor with a velocity lane. [Docs](/docs/components/base/piano-roll#installation). |

**In React**

Each links to its docs, with a live preview, the API and the source. Install any of them with `npx shadcn@latest add @audio-ui/<name>`.

**Top components**

| Name | Description |
| --- | --- |
| `Knob` | Rotary parameter with drag, wheel, keyboard and reset. [Docs](/docs/components/base/knob). |
| `Fader` | Linear gain or parameter slider. [Docs](/docs/components/base/fader). |
| `XY Pad` | Two parameters on one surface. [Docs](/docs/components/base/xypad). |
| `Envelope` | Breakpoint editor for ADSR and other ramps. [Docs](/docs/components/base/envelope). |
| `Meter` | Stereo and multi-channel level with peak hold. [Docs](/docs/components/base/meter). |
| `Waveform` | Seekable, live or bar-style waveform with regions. [Docs](/docs/components/base/waveform). |
| `Plot` | Draggable curves for EQs, filters and compressors. [Docs](/docs/components/base/plot). |
| `Timeline` | Zoomable arrangement view with a smooth playhead. [Docs](/docs/components/base/arrangement). |
| `Sequencer` | Step grid to draw a pattern. [Docs](/docs/components/base/sequencer). |
| `Pad` | Drum pads with velocity and choke groups. [Docs](/docs/components/base/pad). |
| `Piano Roll` | DAW-style note editor with a velocity lane. [Docs](/docs/components/base/piano-roll). |

## Built for agents

audio/ui is made to be used by AI coding agents as much as by people. Open code, one consistent API and plain markdown docs mean an agent can find the right component, read how it works and wire it up without guessing.

- **[Agent skill](/docs/agents):** teaches your agent which layer to pick, how to install and the mistakes to avoid.
- **[MCP server](/docs/mcp):** `https://www.audio-ui.dev/mcp` lets your agent list components, read their docs and search the catalog.
- **[llms.txt](/llms.txt):** a structured map of every docs page, each also served as markdown.

## Principles

- **Accessible by default:** native inputs where it matters, labelled controls, full keyboard support.
- **Composable:** small parts that fit together, so you pick the level of abstraction for each screen.
- **Open code:** read it, change it, own it.
- **No lag:** values that change every frame, like playheads and meters, move without re-rendering your page.

## Next steps

**In Vue, Svelte and Web**

Head over to [Get started](/docs) to add audio/ui to your project, or open [Knob](/docs/components/base/knob#installation) to place your first primitive, with its code in your framework.

**In React**

Head over to [Get started](/docs) to add audio/ui to your project, or open [Knob](/docs/components/base/knob) to install your first component.

