# Mizzle
> Animated components for React, Svelte and Solid, installed as source with the shadcn CLI or shadcn-svelte.
Source: https://mizzle.saddy.me/docs/introduction.md
# Introduction
> Animated components for React, Svelte and Solid, installed as source with the shadcn CLI or shadcn-svelte.
## What you get
- **Yours to change.** Each component is added to your project as a source file with the shadcn CLI. No package to update, nothing hidden.
- **CSS does the motion.** Transitions driven by a data attribute and a few variables. No animation library to install, and a hover can be interrupted for free.
- **Made to be read.** Small files with named parts, checked against strict TypeScript and an accessibility linter. Every component forwards its ref and passes your props to its root, and its page explains why it moves the way it does.
- **Fits your theme.** Tailwind classes and shadcn’s colour names, in light and dark. Timing can be set from a class.
## Three frameworks, one set
Every component is written for React first, then ported to Svelte 5 and Solid with the same look, the same motion and the same props wherever the framework allows. Pick yours with the Framework switch on any component page: the preview, the code, the install command and the usage all follow. One license covers all three.
## Quick start: React
Components come from a [shadcn](https://ui.shadcn.com) registry. Text Reveal, Number Roll, Link, Field and Input are free and install without a key. Everything else is unlocked by the license key you get when you [buy](/pricing).
### 1. Set up shadcn
Skip this if your project already has a `components.json`.
```bash
npx shadcn@latest init
```
### 2. Add the registry
In `components.json`, tell shadcn where Mizzle lives. For the free components, that is all you need.
```json
{
"registries": {
"@mizzle": "https://mizzle.saddy.me/r/{name}.json"
}
}
```
### 3. Unlock the paid components
After you buy, put `MIZZLE_LICENSE=your-license-key` in `.env.local`, which the shadcn CLI reads, and keep it out of version control. Then tell shadcn to send the key with each request. One key covers everything you buy. Add the header only once the key is set: the CLI stops with an error when `MIZZLE_LICENSE` is missing.
```json
{
"registries": {
"@mizzle": {
"url": "https://mizzle.saddy.me/r/{name}.json",
"headers": {
"Authorization": "Bearer ${MIZZLE_LICENSE}"
}
}
}
}
```
### 4. Pick a look
Every component comes in three looks: Raised, a white panel on a grey frame (the default); Inset, a grey panel set into a white frame; and Flat, one grey body with no shadows. To install everything in Inset or Flat, add the look to the registry URL. Switch looks on any component page to see them. The looks come with the license: the free components install in Flat.
```json
"url": "https://mizzle.saddy.me/r/flat/{name}.json"
```
### 5. Add a component
By name. The CLI brings in anything else the component needs.
```bash
npx shadcn@latest add @mizzle/text-reveal
```
### 6. Use it
The source lands in your components folder, ready to import and to edit.
```tsx
import { TextReveal } from "@/components/mizzle/text/text-reveal"
export default function Hero() {
return (
Words rise into place, one after another.
)
}
```
## Quick start: Svelte
Svelte components install with [shadcn-svelte](https://shadcn-svelte.com) from their own registry, as Svelte 5 components that use runes. They land in your components folder, one folder per component.
### 1. Set up shadcn-svelte
Skip this if your project already has a `components.json`.
```bash
npx shadcn-svelte@latest init
```
### 2. Add a component
By its URL. The free ones need nothing else, and the CLI brings in anything a component uses.
```bash
npx shadcn-svelte@latest add https://mizzle.saddy.me/r/svelte/text-reveal.json
```
### 3. Unlock the paid components
shadcn-svelte cannot send a key in a header, so it goes in the URL instead. Keep it in your shell as `MIZZLE_LICENSE`, out of version control, and quote the URL so the shell fills it in.
```bash
export MIZZLE_LICENSE=your-license-key
npx shadcn-svelte@latest add "https://mizzle.saddy.me/r/svelte/$MIZZLE_LICENSE/dynamic-island.json"
```
### 4. Pick a look
For Inset or Flat, add the look after `/svelte` in the URL: `/svelte/inset/` or `/svelte/flat/`, before the key if there is one.
### 5. Use it
Text goes in `text`, classes in `class`.
```markup
```
## Quick start: Solid
Solid components install with the shadcn CLI, the same way as React, from the Solid registry.
### 1. Add the registry
In `components.json`, point `@mizzle` at the Solid registry. Paid components send the key from `MIZZLE_LICENSE` in `.env.local`, as for React.
```json
{
"registries": {
"@mizzle": {
"url": "https://mizzle.saddy.me/r/solid/{name}.json",
"headers": {
"Authorization": "Bearer ${MIZZLE_LICENSE}"
}
}
}
}
```
### 2. Add a component
```bash
npx shadcn@latest add @mizzle/text-reveal
```
### 3. Use it
```tsx
import { TextReveal } from "~/components/mizzle/text/text-reveal"
export default function Hero() {
return (
Words rise into place, one after another.
)
}
```
---
Source: https://mizzle.saddy.me/docs/using-with-ai.md
# Using with AI
> Docs your coding agent can read, an MCP server and a skill, so it picks the right component, installs it with the right command and uses its real props.
## Docs for LLMs
Every docs page is also plain Markdown: add `.md` to its address, or use Copy page at the top of any page.
- [llms.txt](https://mizzle.saddy.me/llms.txt) lists every page with a line on what it is, for an agent to pick from.
- [llms-full.txt](https://mizzle.saddy.me/llms-full.txt) is every page in one file, to paste into a chat.
## MCP server
Connect your agent to Mizzle's MCP server and it can look components up and install them in your framework and look. It only reads the docs: your license key stays in your project, and the shadcn CLI does the installing.
- **get_setup.** The registry entry for your framework and look, and where the key goes.
- **list_components.** Everything for your framework, by category, free or paid.
- **search_components.** Find a component by what it should do.
- **get_component.** The install command, usage and props for one component.
- **list_video_components, get_video_component.** The video components, what each one takes and how to install it.
- **list_videos, get_video.** The videos made from the components: what each is made from, and the command that installs it.
### 1. Claude Code
```bash
claude mcp add --transport http mizzle https://mizzle.saddy.me/mcp
```
### 2. Cursor
```json
{
"mcpServers": {
"mizzle": {
"url": "https://mizzle.saddy.me/mcp"
}
}
}
```
### 3. VS Code
```json
{
"servers": {
"mizzle": {
"type": "http",
"url": "https://mizzle.saddy.me/mcp"
}
}
}
```
### 4. Codex
```toml
[mcp_servers.mizzle]
url = "https://mizzle.saddy.me/mcp"
```
## Skill
The Mizzle skill teaches your agent how to set up the registry, install for each framework and look, keep the key out of chat, and use components as documented. Agents that support skills load it when you mention Mizzle or ask for an animated component.
```bash
npx skills add https://mizzle.saddy.me
```
## Example prompts
- Set up Mizzle in this project with the Flat look.
- Find a Mizzle component for an animated price and add it to the pricing card.
- Add the Mizzle Dynamic Island to the header and show the upload progress in it.
- Which Mizzle components are free for Svelte?
---
Source: https://mizzle.saddy.me/docs/design-system/overview.md
# Overview
> The colours, type, spacing, radii, shadows and motion Mizzle's components use.
## Values travel with the component
Each component writes its values as Tailwind classes in its own file. These pages list those values.
## Three looks
Every component comes in Raised, Inset and Flat. The looks change elevation and the fills behind it; colour, type, spacing and motion are the same in all three.
---
Source: https://mizzle.saddy.me/docs/design-system/colour.md
# Colour
> shadcn's colour names, four status colours, four inks, and tints of the text colour for everything structural.
## Theme colours
The shadcn variables the components read.
| Token | Value | Use |
| --- | --- | --- |
| background | `var(--background)` | Raised surfaces, controls and the page behind them. |
| foreground | `var(--foreground)` | Text, icons, and the base every tint is mixed from. |
| muted-foreground | `var(--muted-foreground)` | Secondary text: hints, metadata, descriptions. |
| popover | `var(--popover)` | Menus, selects and tooltips. |
| destructive | `var(--destructive)` | Actions that delete, and fields with an error. |
## Status
From the toast. The AI components use the same hues.
| Token | Value | Dark | Use |
| --- | --- | --- | --- |
| success | `oklch(0.5 0.13 152)` | `oklch(0.704 0.15 152)` | Done, saved, passed. |
| warning | `oklch(0.5 0.14 70)` | `oklch(0.704 0.15 75)` | Waiting on someone, needs a look. |
| error | `oklch(0.5 0.21 27.3)` | `oklch(0.704 0.191 22.2)` | Failed, rejected. |
| info | `oklch(0.5 0.17 255)` | `oklch(0.704 0.15 255)` | Running, in progress, for your information. |
## Inks
Text colours.
| Token | Value | Use |
| --- | --- | --- |
| ink | `var(--foreground)` | Headings, labels, values. `text-foreground` |
| ink-row | `color-mix(in oklab, var(--foreground) 85%, transparent)` | Menu and list rows, so a highlighted row can step up to full ink. `text-foreground/85` |
| ink-muted | `var(--muted-foreground)` | Supporting text and placeholders. `text-muted-foreground` |
## Tints
Fills made by mixing the foreground into whatever is behind.
| Token | Value | Dark | Use |
| --- | --- | --- | --- |
| tint-tray | `color-mix(in oklab, var(--foreground) 3.5%, transparent)` | `color-mix(in oklab, var(--foreground) 4.5%, transparent)` | The tray a card's surface sits in. A card that is a link takes 6% on hover and 8.5% pressed. `bg-foreground/[0.035]` |
| tint-well | `color-mix(in oklab, var(--foreground) 4%, transparent)` | - | A sunken area inside a surface, and disabled fields. `bg-foreground/[0.04]` |
| tint-subtle | `color-mix(in oklab, var(--foreground) 5%, transparent)` | - | Inline code, and hover on rows in dense lists: the data grid, tool calls. `bg-foreground/[0.05]` |
| tint-hover | `color-mix(in oklab, var(--foreground) 6%, transparent)` | - | Hover, and the highlighted row in a menu. `bg-foreground/[0.06]` |
| tint-press | `color-mix(in oklab, var(--foreground) 8%, transparent)` | - | A pressed item in a menu, select or toolbar. `bg-foreground/[0.08]` |
| tint-active | `color-mix(in oklab, var(--foreground) 10%, transparent)` | - | A pressed ghost button; a trigger whose popup is open. `bg-foreground/[0.1]` |
---
Source: https://mizzle.saddy.me/docs/design-system/type.md
# Type
> The text sizes, line heights and weights the components use.
## Roles
Weights used: 400 and 500.
| Token | Value | Use |
| --- | --- | --- |
| micro | `11px / 16px · 500` | Badges, key hints, counts. `text-[11px] leading-4 font-medium` |
| caption | `12px / 16px · 400` | Hints, timestamps, metadata. Tooltips take it at 500. `text-[12px] leading-4` |
| body | `13px / 20px · 400` | The default for text in a component. `text-[13px] leading-5` |
| label | `13px / 20px · 500` | Buttons, menu items, titles inside a card. Controls add `tracking-[-0.006em]`. `text-[13px] leading-5 font-medium` |
| input | `14px / 20px · 400` | Text fields and large buttons. `text-[14px] leading-5` |
| title | `15px / 24px · 500` | The one heading of a dialog or panel. `text-[15px] leading-6 font-medium tracking-[-0.01em]` |
## Numbers
Counters, timers, prices and table cells use `tabular-nums`.
---
Source: https://mizzle.saddy.me/docs/design-system/spacing.md
# Spacing
> A 4px scale, with half steps at the small end.
## Scale
Each step is a Tailwind spacing class: `space-2` is `gap-2`, `px-2` or `p-2`.
| Token | Value | Use |
| --- | --- | --- |
| space-0.5 | `2px` | The tightest gap, between parts of one item. |
| space-1 | `4px` | A tray's padding around its surface, a menu's around its rows, and the gap between items that belong together. |
| space-1.5 | `6px` | Icon to label inside a control. |
| space-2 | `8px` | The default gap between items. A row's inline padding. |
| space-2.5 | `10px` | A small button's inline padding. |
| space-3 | `12px` | Between groups. A button's inline padding; a text field's. |
| space-4 | `16px` | Inside a surface: card content, a toast, an accordion row. |
| space-5 | `20px` | Inside a dialog. |
---
Source: https://mizzle.saddy.me/docs/design-system/radius.md
# Radius
> The corner radii the components use, by what they wrap.
## Scale
| Token | Value | Use |
| --- | --- | --- |
| radius-key | `4px` | 16px marks: key hints, inline tags. |
| radius-mark | `5px` | The 16px checkbox. |
| radius-chip | `6px` | 20–24px pieces: chips, icon boxes, inline code, small icon buttons. |
| radius-control-sm | `7px` | 28px controls: the small button. Tooltips. |
| radius-control | `8px` | 32px controls: the button, menu and select rows, tabs, toolbar items. |
| radius-control-lg | `10px` | 40px controls: the large button, text fields. |
| radius-container | `12px` | What holds 8px controls with 4px padding: menus, selects, toolbars, tab lists. |
| radius-panel | `14px` | A block that stands alone: a toast, an accordion item. |
| radius-surface | `16px` | A card's surface, a dialog's body. |
| radius-bubble | `18px` | Chat bubbles, and the field inside a composer. |
| radius-tray | `20px` | What holds a 16px surface with 4px padding: a card, a dialog. |
| radius-composer | `22px` | What holds an 18px field with 4px padding: the composer, the prompt input. |
| radius-pill | `9999px` | Tags, avatars, switches, dots. `rounded-full` |
---
Source: https://mizzle.saddy.me/docs/design-system/elevation.md
# Elevation
> The shadows the components use, in the Raised look.
## Levels
Light and dark recipe for each.
| Token | Value | Dark | Use |
| --- | --- | --- | --- |
| tray | `none` | - | The frame a card's surface rests in. No shadow; filled with `tint-tray`. |
| raised | `0 0 0 1px rgb(0 0 0/0.03), 0 1px 2px rgb(0 0 0/0.04)` | `inset 0 1px 0 rgb(255 255 255/0.06), 0 0 0 1px rgb(255 255 255/0.03)` | A card's surface, a dialog's body. |
| raised-hover | `0 0 0 1px rgb(0 0 0/0.04), 0 2px 4px rgb(0 0 0/0.05), 0 14px 24px -14px rgb(0 0 0/0.22)` | `inset 0 1px 0 rgb(255 255 255/0.09), 0 0 0 1px rgb(255 255 255/0.05), 0 14px 24px -14px rgb(0 0 0/0.8)` | A card that is a link, under the pointer. |
| control | `inset 0 0 0 1px color-mix(in oklab, var(--foreground) 13%, transparent), 0 1px 2px rgb(0 0 0/0.05)` | - | Secondary buttons and fields: a hairline that sits on the control, and a 1px drop. |
| tooltip | `0 0 0 1px rgb(0 0 0/0.06), 0 2px 4px -1px rgb(0 0 0/0.06), 0 10px 24px -8px rgb(0 0 0/0.16)` | `inset 0 1px 0 rgb(255 255 255/0.06), 0 0 0 1px rgb(255 255 255/0.07), 0 10px 24px -8px rgb(0 0 0/0.6)` | Tooltips. |
| popover | `0 0 0 1px rgb(0 0 0/0.06), 0 2px 4px -1px rgb(0 0 0/0.06), 0 12px 28px -8px rgb(0 0 0/0.2)` | `inset 0 1px 0 rgb(255 255 255/0.06), 0 0 0 1px rgb(255 255 255/0.07), 0 12px 28px -8px rgb(0 0 0/0.6)` | Menus, selects, popovers. |
| toast | `0 0 0 1px rgb(0 0 0/0.06), 0 4px 10px -4px rgb(0 0 0/0.08), 0 16px 32px -12px rgb(0 0 0/0.18)` | `inset 0 1px 0 rgb(255 255 255/0.06), 0 0 0 1px rgb(255 255 255/0.06), 0 16px 40px -12px rgb(0 0 0/0.7)` | Toasts. |
| dialog | `0 0 0 1px rgb(0 0 0/0.06), 0 4px 10px -4px rgb(0 0 0/0.08), 0 24px 48px -12px rgb(0 0 0/0.25)` | `inset 0 1px 0 rgb(255 255 255/0.05), 0 0 0 1px rgb(255 255 255/0.06), 0 24px 60px -12px rgb(0 0 0/0.7)` | Dialogs: the one surface over a scrim. |
## States
| Token | Value | Dark | Use |
| --- | --- | --- | --- |
| focus | `inset 0 0 0 1px color-mix(in oklab, var(--foreground) 48%, transparent), 0 0 0 3px color-mix(in oklab, var(--foreground) 10%, transparent)` | - | A focused field: the hairline darkens and a soft 3px halo appears. Buttons and rows take a 2px outline in `foreground/50`, 2px out. |
| invalid | `inset 0 0 0 1px var(--destructive), 0 0 0 3px color-mix(in oklab, var(--destructive) 16%, transparent)` | - | A focused field with an error. |
| selected-agent | `0 0 0 1px oklch(0.62 0.16 250/0.7), 0 0 0 4px oklch(0.62 0.16 250/0.12)` | `0 0 0 1px oklch(0.75 0.13 250/0.7), 0 0 0 4px oklch(0.75 0.13 250/0.12)` | The node or step in focus in the AI agent components. |
## In each look
- Raised uses the recipes above.
- Inset drops the hairline ring: a card's grey panel sits in a white frame, and floating surfaces keep only their drops.
- Flat has no shadows. Floating surfaces are a 6% tint (10% in dark) on the background, and controls keep their hairline.
---
Source: https://mizzle.saddy.me/docs/design-system/motion.md
# Motion
> The curves and durations the components' CSS transitions use.
## Curves
Colour changes use the plain `ease-out` keyword.
| Token | Value | Use |
| --- | --- | --- |
| out | `cubic-bezier(0.22, 1, 0.36, 1)` | Entering, settling. |
| in | `cubic-bezier(0.4, 0, 1, 1)` | Leaving. |
| in-out | `cubic-bezier(0.65, 0, 0.35, 1)` | Moving between two places. |
| roll | `cubic-bezier(0.76, 0, 0.24, 1)` | Two things trading places. |
| glide | `cubic-bezier(0.2, 0, 0, 1)` | Following an anchor, layout. |
| sheet | `cubic-bezier(0.32, 0.72, 0, 1)` | A surface sliding in or out. |
| standard | `cubic-bezier(0.4, 0, 0.2, 1)` | An indicator reaching for its target. |
| hold | `cubic-bezier(0.3, 0, 0.75, 1)` | A fill that tracks a press held down. |
## Durations
All on 50ms steps.
| Token | Value | Use |
| --- | --- | --- |
| 100ms | `100ms` | A press going down. A tooltip appearing. |
| 150ms | `150ms` | Hover, colour and focus outlines. Menus and dialogs closing. |
| 200ms | `200ms` | Toasts. Text changing colour as a tab or row is chosen. |
| 250ms | `250ms` | Menus, popovers and dialogs opening. A tooltip gliding to the next control. |
| 300ms | `300ms` | A card's shadow deepening under the pointer. |
| 350ms | `350ms` | Layout: content resizing or reflowing. |
| 400ms | `400ms` | A press releasing. The trailing edge of a moving tab indicator. |
## Reduced motion
Transitions carry `motion-reduce:transition-none`.
---
Source: https://mizzle.saddy.me/docs/design-system/accessibility.md
# Accessibility
> Contrast, focus, forced colours, reduced motion and keyboard support in the components.
## Contrast
Measured on this site's theme, against the background. Text needs 4.5:1.
| Token | Value | Dark | Use |
| --- | --- | --- | --- |
| text | `var(--foreground)` | - | 17:1 light · 16.3:1 dark. `text-foreground` |
| row text | `color-mix(in oklab, var(--foreground) 85%, transparent)` | - | 12.1:1 light · 9.4:1 dark, on a menu. `text-foreground/85` |
| muted text and placeholders | `var(--muted-foreground)` | - | 4.8:1 light · 6.4:1 dark. `text-muted-foreground`, `placeholder:text-muted-foreground` |
| destructive | `var(--destructive)` | - | 4.6:1 light · 6.9:1 dark. `text-destructive` |
| status | `oklch(0.5 0.17 255)` | `oklch(0.704 0.15 255)` | 5.4–6.3:1 light · 6.9–8.1:1 dark, across success, warning, error and info. |
## Focus
Shown on keyboard focus only, with `focus-visible`. Focus indicators need 3:1.
| Token | Value | Use |
| --- | --- | --- |
| buttons and rows | `color-mix(in oklab, var(--foreground) 50%, transparent)` | 3.8:1 light · 3.8:1 dark; 3.7:1 on a card's tray. `outline-2 outline-offset-2 outline-transparent focus-visible:outline-foreground/50` |
| fields | `color-mix(in oklab, var(--foreground) 48%, transparent)` | 3.6:1 light · 3.6:1 dark, with a 3px halo. The `focus` shadow on the Elevation page. |
| links | `color-mix(in oklab, var(--foreground) 45%, transparent)` | 3.3:1 light · 3.2:1 dark on body text: the link's own colour at 45%. `focus-visible:outline-current/45` |
## Forced colours
Shadows are removed in forced-colours mode, such as Windows High Contrast. Fields, menus, selects, dialogs, tooltips and card surfaces carry `outline-hidden`: no outline normally, and an outline in the system colour in forced-colours mode. Buttons and toasts keep their transparent 2px outline, which forced-colours mode paints. Menu and select rows outline the highlighted row: `forced-colors:data-highlighted:outline-solid`.
## Reduced motion
Transitions carry `motion-reduce:transition-none`.
## Keyboard and roles
Primitives are built on Base UI in React, Bits UI in Svelte and Kobalte in Solid, which supply keyboard handling, focus management and ARIA roles.
---
Source: https://mizzle.saddy.me/docs/primitives/button.md
# Button
> A button that feels like an object: light on its surface, a shadow that deepens under the pointer and closes up when pressed, a quick press and a slow release. Busy and done states swap in softly without the button changing width. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/button
## Installation
```bash
npx shadcn@latest add @mizzle/button
```
## Usage
```tsx
import { Button } from "@/components/mizzle/primitives/button"
Save changes
Cancel
Save changes
See pricing
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"primary" \| "secondary" \| "outline" \| "ghost"` | `"primary"` | What the button means on the page. |
| size | `"sm" \| "md" \| "lg"` | `"md"` | 28, 32 or 40px tall. |
| shape | `"pill" \| "rounded"` | `"pill"` | Pill on its own; rounded inside a card or form. |
| status | `"idle" \| "loading" \| "success"` | `"idle"` | Shows a spinner or a check in place of the label. |
| icon | `boolean` | - | Square, for a lone icon. Give it an aria-label. |
| href | `string` | - | Render a link that looks the same. |
| render | `ReactElement` | - | Render as another element, keeping the look. |
---
Source: https://mizzle.saddy.me/docs/primitives/tabs.md
# Tabs
> Tabs whose selected chip tightens under a press, stretches towards the tab you pick, then gathers itself, with panels that drift in from the same side. A raised chip in a tray, or a sliding underline. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/tabs
## Installation
```bash
npx shadcn@latest add @mizzle/tabs
```
## Usage
```tsx
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/mizzle/primitives/tabs"
Overview
Activity
…
…
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| defaultValue | `string` | - | The tab selected at first. |
| value | `string` | - | The selected tab, when you control it. |
| onValueChange | `(value: string) => void` | - | Called when another tab is picked. |
| variant | `"segmented" \| "line"` | `"segmented"` | A tray with a sliding segment, or a sliding underline. |
| shape | `"pill" \| "rounded"` | `"pill"` | Pill look only: pill on its own, rounded inside a card or panel. |
---
Source: https://mizzle.saddy.me/docs/primitives/card.md
# Card
> A soft tray around a raised surface, with concentric corners. As a link its surface lifts on hover and sinks on press, and its media breathes; it does not jump at the pointer.
Live demo: https://mizzle.saddy.me/docs/primitives/card
## Installation
```bash
npx shadcn@latest add @mizzle/card
```
## Usage
```tsx
import { Card, CardDescription, CardFooter, CardMedia, CardTitle } from "@/components/mizzle/primitives/card"
Morning light
2026
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| href | `string` | - | Make the whole card a link, with hover and press. |
| aspect | `string` | `"4/3"` | On CardMedia: the media’s aspect ratio. |
---
Source: https://mizzle.saddy.me/docs/primitives/squircle-card.md
# Squircle Card
> The Card with continuous corners. A plain squircle at the same radius looks sharper, so the radius grows by the depth a circle cuts divided by the depth the curve cuts, ×1.84 for a squircle; the corners line up with the round ones they replace and the nested gap stays even. Uses CSS corner-shape inside @supports, so browsers without it keep the regular round Card.
Live demo: https://mizzle.saddy.me/docs/primitives/squircle-card
## Installation
```bash
npx shadcn@latest add @mizzle/squircle-card
```
## Usage
```tsx
import { CardDescription, CardFooter, CardTitle } from "@/components/mizzle/primitives/card"
import { SquircleCard, SquircleCardMedia } from "@/components/mizzle/primitives/squircle-card"
Morning light
2026
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| radius | `number` | `20` | The round radius you would have written, in px. Inner surfaces get it minus the 4px gap. |
| shape | `number` | `2` | The superellipse() value: 1 is round, 2 a squircle, higher is squarer. The radius compensation follows it. |
| href | `string` | - | Make the whole card a link, with hover and press. |
| aspect | `string` | `"4/3"` | On SquircleCardMedia: the media’s aspect ratio. |
---
Source: https://mizzle.saddy.me/docs/primitives/accordion.md
# Accordion
> Rows that open to show more. One thing moves: the panel’s height, on one short clock both ways, so rows trading places leave everything below them still and nothing creeps into place at the end. The plus turns into a minus on the same clock. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/accordion
## Installation
```bash
npx shadcn@latest add @mizzle/accordion
```
## Usage
```tsx
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/mizzle/primitives/accordion"
Do I pay once?
Yes. One payment, no subscription.
Can I use it for client work?
Yes, in as many projects as you like.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"line" \| "card"` | `"line"` | Rows on hairlines, or on one raised surface in a tray. |
| multiple | `boolean` | `false` | Let more than one row be open at a time. |
| defaultValue | `string[]` | - | The rows open at first. |
| value | `string[]` | - | The open rows, when you control them. |
| onValueChange | `(value: string[]) => void` | - | Called when a row opens or closes. |
| disabled | `boolean` | - | On AccordionItem: the row cannot be opened. |
---
Source: https://mizzle.saddy.me/docs/primitives/dialog.md
# Dialog
> A dialog built like the card: what you read sits on a raised surface, what you press sits under it on the tray. It comes towards you in 250ms and is gone in 150. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/dialog
## Installation
```bash
npx shadcn@latest add @mizzle/dialog
```
## Usage
```tsx
import { Button } from "@/components/mizzle/primitives/button"
import { Dialog, DialogBody, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogTitle, DialogTrigger } from "@/components/mizzle/primitives/dialog"
}>Delete project
Delete this project?
This cannot be undone.
}>Cancel
Delete project
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| open | `boolean` | - | On Dialog: whether it is open, when you control it. |
| onOpenChange | `(open: boolean) => void` | - | On Dialog: called when it opens or closes. |
| defaultOpen | `boolean` | - | On Dialog: open at first. |
| disablePointerDismissal | `boolean` | - | On Dialog: a click outside no longer closes it. |
| render | `ReactElement` | - | On DialogTrigger and DialogClose: the element to render as. |
| backdropClassName | `string` | - | On DialogContent: classes for the dimmed layer. |
---
Source: https://mizzle.saddy.me/docs/primitives/toast.md
# Toast
> A short message that rises in from just below where it rests, out of a slight blur, and leaves the same small way. Newer toasts stack in front and older ones tuck in behind, a little smaller and dimmer; hover the stack to spread it out. When a toast changes, its words and icon morph in place. A pill variant puts the whole message on one dark line, and a single manager makes each new message take the place of the last. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/toast
## Installation
```bash
npx shadcn@latest add @mizzle/toast
```
## Usage
```tsx
import { ToastProvider, toastManager } from "@/components/mizzle/primitives/toast"
{children}
toastManager.add({ title: "Event created", description: "Friday 14 March, 18:00" })
toastManager.add({ type: "success", title: "Payment received" })
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| position | `"top-left" \| "top-center" \| "top-right" \| "bottom-left" \| "bottom-center" \| "bottom-right"` | `"bottom-right"` | On ToastProvider: where the stack sits. |
| variant | `"card" \| "pill"` | `"card"` | On ToastProvider: a card with a title and description, or one dark line with the action as a chip. |
| limit | `number` | `3` | On ToastProvider: how many toasts show at once. |
| single | `boolean` | `false` | On createToastManager: every message updates the one toast in place instead of adding another, so nothing stacks. |
| timeout | `number` | `3200 \| 4800 \| 7000` | Per toast: milliseconds before it closes, 0 to keep it open. By default it follows the content: a title, a description, an action. |
| data | `{ style?: "tooltip" }` | - | Passed to anchoredToastManager.add. "tooltip" draws the toast with the Tooltip's surface, type and motion, in the place the tooltip sat, with no close button. |
| toastManager | `ToastManager` | - | On either provider: a manager from createToastManager, if you want more than the shared one. |
| portalProps | `Toast.Portal.Props` | - | On either provider: props for the portal, such as a container to render into. |
| viewportClassName | `string` | - | On ToastProvider: classes for the fixed stack. |
---
Source: https://mizzle.saddy.me/docs/primitives/menu.md
# Menu
> A menu of actions that grows out of the button that opened it and is gone the moment you choose. Items, ticks, choices, groups and key hints. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/menu
## Installation
```bash
npx shadcn@latest add @mizzle/menu
```
## Usage
```tsx
import { Button } from "@/components/mizzle/primitives/button"
import { Menu, MenuContent, MenuItem, MenuSeparator, MenuShortcut, MenuTrigger } from "@/components/mizzle/primitives/menu"
}>Options
Rename
R
Duplicate
Delete
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| side | `"top" \| "bottom" \| "left" \| "right"` | `"bottom"` | On MenuContent: which side of the trigger it opens on. |
| align | `"start" \| "center" \| "end"` | `"start"` | On MenuContent: how it lines up with the trigger. |
| sideOffset | `number` | `6` | On MenuContent: the gap to the trigger, in pixels. |
| destructive | `boolean` | - | On MenuItem: red, for actions that cannot be undone. |
| closeOnClick | `boolean` | - | On an item: close the menu when chosen. True for MenuItem, false for ticks and choices. |
| render | `ReactElement` | - | On MenuTrigger: the element to render as. |
---
Source: https://mizzle.saddy.me/docs/primitives/toolbar.md
# Toolbar
> A row of controls that act on one thing: buttons, toggles, a choice of one, a link or an input. Arrow keys move between them, and where you pick one of a few the highlight glides between them.
Live demo: https://mizzle.saddy.me/docs/primitives/toolbar
## Installation
```bash
npx shadcn@latest add @mizzle/toolbar
```
## Usage
```tsx
import { Toolbar, ToolbarButton, ToolbarSeparator, ToolbarToggle, ToolbarToggleGroup } from "@/components/mizzle/primitives/toolbar"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"floating" \| "tray"` | `"floating"` | On Toolbar: a raised bar, or flat on the page. |
| shape | `"rounded" \| "pill"` | `"rounded"` | On Toolbar: corners for the bar and its buttons. |
| orientation | `"horizontal" \| "vertical"` | `"horizontal"` | On Toolbar and ToolbarToggleGroup: which way it runs. |
| icon | `boolean` | - | On ToolbarButton and ToolbarToggle: a square icon button. |
| indicator | `boolean` | - | On ToolbarToggleGroup: one highlight that slides to the pressed item. |
| multiple | `boolean` | - | On ToolbarToggleGroup: let several be pressed at once. |
---
Source: https://mizzle.saddy.me/docs/primitives/tooltip.md
# Tooltip
> A small label for a control. Give a row of controls one tooltip between them and it stays open as you move along: the label glides to the next control, changes width to fit, and the words dissolve from one to the next. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/tooltip
## Installation
```bash
npx shadcn@latest add @mizzle/tooltip
```
## Usage
```tsx
import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/mizzle/primitives/tooltip"
import { Button } from "@/components/mizzle/primitives/button"
}>Save
Save changes
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| side | `"top" \| "right" \| "bottom" \| "left"` | `"top"` | On TooltipContent: which side of the trigger it opens on. |
| align | `"start" \| "center" \| "end"` | `"center"` | On TooltipContent: how it lines up with the trigger. |
| sideOffset | `number` | `8` | On TooltipContent: the gap to the trigger, in pixels. |
| handle | `TooltipHandle` | - | On Tooltip and TooltipTrigger: ties detached triggers to one tooltip. Make it with createTooltipHandle. |
| payload | `Payload` | - | On TooltipTrigger: what the shared tooltip shows for this trigger. |
| delay | `number` | `600` | On TooltipTrigger and TooltipProvider: milliseconds before it opens. |
| render | `ReactElement` | - | On TooltipTrigger: the element to render as. |
---
Source: https://mizzle.saddy.me/docs/primitives/link.md
# Link
> A text link whose underline is drawn on the text: it draws in from the left, leaves to the right, and follows the words when they wrap. Four treatments, hover and keyboard alike, no JavaScript.
Live demo: https://mizzle.saddy.me/docs/primitives/link
## Installation
```bash
npx shadcn@latest add @mizzle/link
```
## Usage
```tsx
import { Link } from "@/components/mizzle/primitives/link"
See the work
Motion
Start a project
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"slide" \| "grow" \| "solid" \| "swap" \| "none"` | `"slide"` | How the link reacts to hover and focus. |
| arrow | `boolean` | - | Show an arrow after the label. Defaults to true for external links. |
| external | `boolean` | - | Open in a new tab. Defaults to true for absolute http(s) URLs. |
| href | `string` | - | Where the link goes. |
---
Source: https://mizzle.saddy.me/docs/primitives/verified-badge.md
# Verified Badge
> The scalloped check that sits after a name. A soft glint passes over it every couple of seconds, and stays still for anyone who prefers less motion.
Live demo: https://mizzle.saddy.me/docs/primitives/verified-badge
## Installation
```bash
npx shadcn@latest add @mizzle/verified-badge
```
## Usage
```tsx
import { VerifiedBadge } from "@/components/mizzle/primitives/verified-badge"
Keza Uwase
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| size | `"sm" \| "md" \| "lg" \| number` | `"md"` | 18, 22 or 28 pixels, or any width in pixels. |
| tone | `"blue" \| "gold" \| "neutral"` | `"blue"` | The fill colour. |
| shimmer | `boolean` | `true` | Pass a glint over the badge. |
| decorative | `boolean` | `false` | Hide it from screen readers when the text already says verified. |
| aria-label | `string` | `"Verified"` | What a screen reader says. |
---
Source: https://mizzle.saddy.me/docs/primitives/popover.md
# Popover
> A panel that opens from a button and holds a small task, such as a form or a few options. It scales and fades in from the trigger, leaves faster than it arrives, and closes on Escape or an outside click. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/primitives/popover
## Installation
```bash
npx shadcn@latest add @mizzle/popover
```
## Usage
```tsx
import { Popover, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger } from "@/components/mizzle/primitives/popover"
import { Button } from "@/components/mizzle/primitives/button"
}>Share
Share this page
Anyone with the link can read it.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| side | `"top" \| "right" \| "bottom" \| "left"` | `"bottom"` | On PopoverContent: which side of the trigger it opens on. |
| align | `"start" \| "center" \| "end"` | `"center"` | On PopoverContent: how it lines up with the trigger. |
| sideOffset | `number` | `8` | On PopoverContent: the gap to the trigger, in pixels. |
| alignOffset | `number` | - | On PopoverContent: shifts it along the trigger, in pixels. |
| initialFocus | `RefObject` | - | On PopoverContent: the element to focus when it opens. |
| render | `ReactElement` | - | On PopoverTrigger and PopoverClose: the element to render as. |
---
Source: https://mizzle.saddy.me/docs/primitives/toggle-group.md
# Toggle Group
> A row of toggle buttons that share one state. Pick one at a time or several, with icon or text items. Pressed items take a tinted fill and dip on press, and the arrow keys move focus along the row. Built on Base UI.
Live demo: https://mizzle.saddy.me/docs/primitives/toggle-group
## Installation
```bash
npx shadcn@latest add @mizzle/toggle-group
```
## Usage
```tsx
import { ToggleGroup, ToggleGroupItem } from "@/components/mizzle/primitives/toggle-group"
Left
Centre
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| multiple | `boolean` | `false` | On ToggleGroup: let more than one item be pressed. |
| value / defaultValue | `string[]` | - | On ToggleGroup: the pressed values. |
| onValueChange | `(value: string[]) => void` | - | On ToggleGroup: called when the pressed values change. |
| shape | `"rounded" \| "pill"` | `"rounded"` | On ToggleGroup: the shape of the items. |
| disabled | `boolean` | `false` | On ToggleGroup and ToggleGroupItem: ignore input. |
| value | `string` | - | On ToggleGroupItem: the value it adds to the group. |
| icon | `boolean` | `false` | On ToggleGroupItem: a square item for a single icon. |
---
Source: https://mizzle.saddy.me/docs/primitives/meter.md
# Meter
> A quiet gauge for a value in a known range, such as storage used or seats taken. A label on the left, the figure on the right, and a thin bar that eases to its fill the first time it is seen and whenever the value changes. Built on Base UI.
Live demo: https://mizzle.saddy.me/docs/primitives/meter
## Installation
```bash
npx shadcn@latest add @mizzle/meter
```
## Usage
```tsx
import { Meter } from "@/components/mizzle/primitives/meter"
`${formatted} of 100 GB`}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| value | `number` | - | The current value. |
| variant | `"bar" \| "ticks"` | `"bar"` | Draw the bar as a solid fill, or as a ruler of fine ticks that fills tick by tick. |
| min | `number` | `0` | The lowest value. |
| max | `number` | `100` | The highest value. |
| label | `ReactNode` | - | Text on the left. Pass aria-label instead if you leave it out. |
| format | `Intl.NumberFormatOptions` | - | How the value is written. |
| renderValue | `(formatted: string, value: number, figure: ReactNode) => ReactNode` | - | Replaces the text on the right, for a figure such as 64 GB of 100 GB. |
---
Source: https://mizzle.saddy.me/docs/primitives/progress.md
# Progress
> Meter's sibling for a task. A determinate bar eases to each new value, and a null value gives a calm sliding segment while the length is unknown. The figure turns to full ink when the task is complete. Built on Base UI.
Live demo: https://mizzle.saddy.me/docs/primitives/progress
## Installation
```bash
npx shadcn@latest add @mizzle/progress
```
## Usage
```tsx
import { Progress } from "@/components/mizzle/primitives/progress"
(value === null ? "Preparing" : `${Math.round(value)}%`)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"bar" \| "ticks"` | `"bar"` | Draw the bar as a solid fill, or as a ruler of fine ticks. While the length is unknown it is a sliding segment, or a run of ticks lighting and fading. |
| value | `number \| null` | - | The current value. null means the length is unknown. |
| min | `number` | `0` | The lowest value. |
| max | `number` | `100` | The highest value. |
| label | `ReactNode` | - | Text on the left. Pass aria-label instead if you leave it out. |
| format | `Intl.NumberFormatOptions` | - | How the value is written. |
| renderValue | `(formatted: string \| null, value: number \| null) => ReactNode` | - | Replaces the text on the right. |
---
Source: https://mizzle.saddy.me/docs/primitives/badge.md
# Badge
> A small label for a state or a count, in ink, tint, hairline or red, with an optional dot or icon. The selectable form is a filter chip: the whole chip is the hit area, the check draws in and the chip eases wider. It has a native checkbox underneath, so it works in a form.
Live demo: https://mizzle.saddy.me/docs/primitives/badge
## Installation
```bash
npx shadcn@latest add @mizzle/badge
```
## Usage
```tsx
import { Badge, SelectableBadge } from "@/components/mizzle/primitives/badge"
Active
Motion
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"default" \| "secondary" \| "outline" \| "destructive"` | `"default"` | On Badge: the surface. destructive is the soft red of color. |
| color | `"neutral" \| "green" \| "blue" \| "violet" \| "pink" \| "red" \| "amber"` | - | On Badge: a soft tint of the hue with text of the same hue, in place of variant. |
| size | `"sm" \| "md"` | `"md"` | On Badge and SelectableBadge: the height and type size. |
| dot | `boolean` | `false` | On Badge: a small dot before the label. |
| checked / defaultChecked | `boolean` | - | On SelectableBadge: whether the chip is on. |
| onCheckedChange | `(checked: boolean) => void` | - | On SelectableBadge: called when the chip is toggled. |
| name | `string` | - | On SelectableBadge: the form field name. value and disabled pass to the input as well. |
---
Source: https://mizzle.saddy.me/docs/primitives/avatar.md
# Avatar
> A person's picture, with initials when there is none. The image fades in once it has loaded and carries a hairline outline so pale photos keep their edge. A group overlaps them with a ring in the background colour and can end in a +3. Built on Base UI.
Live demo: https://mizzle.saddy.me/docs/primitives/avatar
## Installation
```bash
npx shadcn@latest add @mizzle/avatar
```
## Usage
```tsx
import { Avatar, AvatarFallback, AvatarGroup, AvatarImage } from "@/components/mizzle/primitives/avatar"
AU
DO
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| size | `"sm" \| "md" \| "lg" \| "xl"` | `"md"` | On Avatar and AvatarGroup: 24, 32, 40 or 56 pixels. Avatars in a group take the group's size. |
| more | `number` | - | On AvatarGroup: shows a +N avatar at the end. |
| delay | `number` | `0` | On AvatarFallback: milliseconds to wait before showing the initials. |
---
Source: https://mizzle.saddy.me/docs/primitives/group.md
# Group
> Joins buttons, inputs and triggers into one object. Inner corners square off, the outer ones keep each child's own radius, neighbours share one edge, and the focused child's ring is never clipped by its neighbour. It works with any Button variant, Input, and Popover or Menu triggers.
Live demo: https://mizzle.saddy.me/docs/primitives/group
## Installation
```bash
npx shadcn@latest add @mizzle/group
```
## Usage
```tsx
import { Group, GroupSeparator } from "@/components/mizzle/primitives/group"
import { Button } from "@/components/mizzle/primitives/button"
Confirm all
…
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| orientation | `"horizontal" \| "vertical"` | `"horizontal"` | On Group: which way the children line up. |
| size | `"sm" \| "md"` | `"md"` | On Group: sets every joined segment to 28px or 32px tall, with Button's padding and text size at that size. |
| className | `string` | - | On GroupSeparator: the line is light on a dark button by default. On a tinted button pass a tint such as bg-foreground/[0.12]. |
---
Source: https://mizzle.saddy.me/docs/primitives/sidebar.md
# Sidebar
> A sidebar for an app: a workspace menu, quiet groups, collapsible sub-items and a user menu, in three arrangements. It collapses to a 48px icon rail with tooltips, scrolls its middle on its own, and becomes an off-canvas panel on small screens. [ and Ctrl/Cmd+B toggle it.
Live demo: https://mizzle.saddy.me/docs/primitives/sidebar
## Installation
```bash
npx shadcn@latest add @mizzle/sidebar
```
## Usage
```tsx
import {
Sidebar,
SidebarContent,
SidebarFooter,
SidebarGroup,
SidebarGroupLabel,
SidebarHeader,
SidebarInset,
SidebarItem,
SidebarProvider,
SidebarSub,
SidebarSubItem,
SidebarTrigger,
} from "@/components/mizzle/primitives/sidebar"
}>Harbor Labs
Workspace
} trailing="3" current>
Inbox
} defaultOpen>
}>Issues
}>Amara Okafor
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"fixed" \| "floating" \| "inset"` | `"fixed"` | On Sidebar: docked to the edge with a hairline, a detached panel, or on the frame colour beside a SidebarInset panel. |
| open / defaultOpen | `boolean` | `true` | On SidebarProvider: whether the sidebar is expanded. |
| onOpenChange | `(open: boolean) => void` | - | On SidebarProvider: called when the sidebar expands or collapses. |
| icon | `ReactNode` | - | On SidebarItem and SidebarSub: the 16px icon, which stays in place in the rail. |
| trailing | `ReactNode` | - | On SidebarItem: a shortcut hint or a small count at the end of the row. |
| current | `boolean` | `false` | On SidebarItem and SidebarSubItem: marks the current page with a tinted row. |
| render | `ReactElement` | - | On SidebarItem and SidebarSubItem: the element to render, such as a link, instead of a button. |
| label | `ReactNode` | - | On SidebarSub: the parent row's label, also its tooltip in the rail. |
| open / defaultOpen | `boolean` | `false` | On SidebarSub: whether its sub-items are shown. |
---
Source: https://mizzle.saddy.me/docs/primitives/kbd.md
# Kbd
> A keyboard key for showing shortcuts. KbdShortcut takes a combination as text and draws the caps for it, and each cap dips while that key is held on the keyboard, then springs back. Command shows as ⌘ on Apple platforms and Ctrl elsewhere.
Live demo: https://mizzle.saddy.me/docs/primitives/kbd
## Installation
```bash
npx shadcn@latest add @mizzle/kbd
```
## Usage
```tsx
import { Kbd, KbdGroup, KbdShortcut } from "@/components/mizzle/primitives/kbd"
Ctrl
K
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| pressed | `boolean` | `false` | On Kbd: draws the cap pushed in. |
| separator | `boolean \| string` | - | On KbdGroup and KbdShortcut: a sign between the caps of a combination. true draws a plus. None by default. |
| keys* | `string` | - | On KbdShortcut: the combination. Join keys with + ("mod+shift+k") and separate the steps of a sequence with a space ("g i"). mod is Command on Apple platforms and Ctrl elsewhere. |
| onTrigger | `() => void` | - | On KbdShortcut: called when the whole combination is pressed. Plain keys are ignored while typing in a field, and it never calls preventDefault. |
---
Source: https://mizzle.saddy.me/docs/components/forms/form.md
# Form
> The form that holds the fields. It validates with the browser’s own rules, shows errors where they belong, takes errors back from your server, and hands you the values as an object.
Live demo: https://mizzle.saddy.me/docs/components/forms/form
## Installation
```bash
npx shadcn@latest add @mizzle/form
```
## Usage
```tsx
import { Form } from "@/components/mizzle/forms/form"
import { Field, FieldError, FieldLabel } from "@/components/mizzle/forms/field"
import { Input } from "@/components/mizzle/forms/input"
import { Button } from "@/components/mizzle/primitives/button"
const [errors, setErrors] = React.useState({})
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| errors | `Record` | - | Errors from outside, such as a server, keyed by field name. |
| onFormSubmit | `(values, details) => void` | - | Called on a valid submit with the values as an object. |
| validationMode | `"onSubmit" \| "onBlur" \| "onChange"` | `"onSubmit"` | When fields check themselves. |
| actionsRef | `RefObject<{ validate(name?: string): void }>` | - | Validate every field, or one, from your own code. |
---
Source: https://mizzle.saddy.me/docs/components/forms/field.md
# Field
> A label, a control, a hint and an error, wired together. The label names the control, the hint describes it, and the error appears under it with a short settle when something is wrong.
Live demo: https://mizzle.saddy.me/docs/components/forms/field
## Installation
```bash
npx shadcn@latest add @mizzle/field
```
## Usage
```tsx
import { Field, FieldDescription, FieldError, FieldLabel } from "@/components/mizzle/forms/field"
import { Input } from "@/components/mizzle/forms/input"
Work email
We send the invite here.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| name | `string` | - | On Field: the key for this value in the form’s values and errors. |
| validate | `(value) => string \| string[] \| null` | - | On Field: your own check, run after the native ones. |
| validationMode | `"onSubmit" \| "onBlur" \| "onChange"` | - | On Field: overrides the form’s. |
| match | `boolean \| keyof ValidityState` | - | On FieldError: show only for this kind of problem. |
| disabled | `boolean` | - | On Field or Fieldset: disables everything inside. |
---
Source: https://mizzle.saddy.me/docs/components/forms/input.md
# Input
> A text input and a textarea that grows as you write. Quiet at rest, lifted on focus, red when wrong.
Live demo: https://mizzle.saddy.me/docs/components/forms/input
## Installation
```bash
npx shadcn@latest add @mizzle/input
```
## Usage
```tsx
import { Input, Textarea } from "@/components/mizzle/forms/input"
import { Field, FieldLabel } from "@/components/mizzle/forms/field"
Full name
Bio
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ...props | `React.ComponentProps<'input'>` | - | Everything an input takes, plus `onValueChange`. |
---
Source: https://mizzle.saddy.me/docs/components/forms/select.md
# Select
> Choose one option from a list. The trigger looks like an input; when there is room the list opens over it with the chosen option sitting where the trigger was, like a native menu on a Mac, and otherwise just below it.
Live demo: https://mizzle.saddy.me/docs/components/forms/select
## Installation
```bash
npx shadcn@latest add @mizzle/select
```
## Usage
```tsx
import { Select, SelectContent, SelectItem, SelectTrigger } from "@/components/mizzle/forms/select"
const plans = [
{ value: "starter", label: "Starter" },
{ value: "team", label: "Team" },
]
{plans.map((plan) => (
{plan.label}
))}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| items | `{ value, label }[] \| Record` | - | On Select: labels for values, shown in the trigger. |
| value / defaultValue | `any` | - | On Select: the chosen value. |
| onValueChange | `(value) => void` | - | On Select: called when the choice changes. |
| placeholder | `ReactNode` | - | On SelectTrigger: shown while nothing is chosen. |
---
Source: https://mizzle.saddy.me/docs/components/forms/checkbox.md
# Checkbox
> A box that ticks. The check draws itself in, and a parent checkbox shows a dash when only some of its children are on.
Live demo: https://mizzle.saddy.me/docs/components/forms/checkbox
## Installation
```bash
npx shadcn@latest add @mizzle/checkbox
```
## Usage
```tsx
import { Checkbox } from "@/components/mizzle/forms/checkbox"
import { Field, FieldLabel, FieldError } from "@/components/mizzle/forms/field"
I agree to the terms
Please accept the terms.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| checked / defaultChecked | `boolean` | - | On Checkbox: whether it is ticked. |
| parent | `boolean` | - | On Checkbox inside a group: controls all the others. |
| allValues | `string[]` | - | On CheckboxGroup: every value, for the parent. |
| value / onValueChange | `string[]` | - | On CheckboxGroup: the checked values. |
---
Source: https://mizzle.saddy.me/docs/components/forms/radio-group.md
# Radio Group
> Pick one of a few. The chosen ring fills and a dot grows from its centre.
Live demo: https://mizzle.saddy.me/docs/components/forms/radio-group
## Installation
```bash
npx shadcn@latest add @mizzle/radio-group
```
## Usage
```tsx
import { Radio, RadioGroup } from "@/components/mizzle/forms/radio-group"
import { Field, Fieldset, FieldsetLegend, FieldItem, FieldLabel } from "@/components/mizzle/forms/field"
}>
Delivery
Standard
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| value / defaultValue | `any` | - | On RadioGroup: the chosen value. |
| onValueChange | `(value) => void` | - | On RadioGroup: called when the choice changes. |
| value | `any` | - | On Radio: the value it stands for. |
---
Source: https://mizzle.saddy.me/docs/components/forms/switch.md
# Switch
> An on and off that takes effect at once. The thumb slides across and stretches a little while you hold it.
Live demo: https://mizzle.saddy.me/docs/components/forms/switch
## Installation
```bash
npx shadcn@latest add @mizzle/switch
```
## Usage
```tsx
import { Switch } from "@/components/mizzle/forms/switch"
import { Field, FieldItem, FieldLabel } from "@/components/mizzle/forms/field"
Sync across devices
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| checked / defaultChecked | `boolean` | - | Whether it is on. |
| onCheckedChange | `(checked) => void` | - | Called when it flips. |
---
Source: https://mizzle.saddy.me/docs/components/forms/number-field.md
# Number Field
> A number you can type, step with the buttons, or nudge with the arrow keys, kept inside its limits.
Live demo: https://mizzle.saddy.me/docs/components/forms/number-field
## Installation
```bash
npx shadcn@latest add @mizzle/number-field
```
## Usage
```tsx
import { NumberField } from "@/components/mizzle/forms/number-field"
import { Field, FieldLabel } from "@/components/mizzle/forms/field"
Guests
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| value / defaultValue | `number` | - | The number. |
| min / max / step | `number` | - | Limits and the size of a step. |
| format | `Intl.NumberFormatOptions` | - | How the number is written, such as a currency. |
---
Source: https://mizzle.saddy.me/docs/components/forms/combobox.md
# Combobox
> A field that filters its list as you type. It has a clear button, a check on the chosen row, a No results state, and a multiple mode that shows the choices as chips in the field. Built on Base UI.
Live demo: https://mizzle.saddy.me/docs/components/forms/combobox
## Installation
```bash
npx shadcn@latest add @mizzle/combobox
```
## Usage
```tsx
import {
Combobox,
ComboboxContent,
ComboboxEmpty,
ComboboxInput,
ComboboxItem,
ComboboxList,
} from "@/components/mizzle/forms/combobox"
const cities = ["Berlin", "Kigali", "Lisbon"]
No results
{(city: string) => (
{city}
)}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| items | `Item[]` | - | On Combobox: everything that can be chosen. The list is filtered from it. |
| multiple | `boolean` | `false` | On Combobox: let several be chosen. Use ComboboxChips as the field. |
| value / defaultValue | `Item \| Item[]` | - | On Combobox: the choice, an array when multiple. |
| onValueChange | `(value) => void` | - | On Combobox: called when the choice changes. |
| disabled | `boolean` | `false` | On Combobox and ComboboxItem: ignore input. |
| placeholder | `string` | - | On ComboboxInput and ComboboxChips: shown while nothing is typed or chosen. |
| startAddon | `ReactNode` | - | On ComboboxInput: an icon or element before the text, such as a search icon. |
| showClear | `boolean` | `true` | On ComboboxInput: show the clear button. |
| showTrigger | `boolean` | `true` | On ComboboxInput: show the chevron that opens the list. |
| placeholder | `ReactNode` | - | On ComboboxTrigger: shown while nothing is chosen. The trigger is a button with Select's surface that shows the chosen value; put a ComboboxInput inside ComboboxContent to search from the popup. |
| children | `(item, index) => ReactNode` | - | On ComboboxChips: what each chosen item shows, usually a ComboboxChip. Leave it out for a chip with the item's label. |
| removeLabel | `string` | - | On ComboboxChip: the accessible name of its remove button. |
| sideOffset | `number` | `6` | On ComboboxContent: the gap to the field, in pixels. |
| align | `"start" \| "center" \| "end"` | `"center"` | On ComboboxContent: how the popup lines up with its anchor. |
| items | `Item[]` | - | On ComboboxGroup: the group's items, so an empty group hides while filtering. |
| value | `Item` | - | On ComboboxItem: the item this row chooses. |
---
Source: https://mizzle.saddy.me/docs/components/forms/otp-field.md
# OTP Field
> A one-time code made of separate slots. Typing moves on to the next slot, Backspace goes back, a paste fills them all, and each digit arrives with a short fade. Slots match Input. Built on Base UI.
Live demo: https://mizzle.saddy.me/docs/components/forms/otp-field
## Installation
```bash
npx shadcn@latest add @mizzle/otp-field
```
## Usage
```tsx
import { Field, FieldLabel } from "@/components/mizzle/forms/field"
import { OTPField } from "@/components/mizzle/forms/otp-field"
Verification code
verify(code)} />
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| length | `number` | `6` | How many slots. |
| groupSize | `number` | - | Slots per group, with a separator between groups. Leave it out for one group. |
| onComplete | `(value: string) => void` | - | Called when every slot is filled. |
| value / defaultValue | `string` | - | The code. |
| onValueChange | `(value: string) => void` | - | Called when the code changes. |
| validationType | `"numeric" \| "alphanumeric" \| "none"` | `"numeric"` | Which characters the slots accept. |
| mask | `boolean` | `false` | Show a dot instead of each character. |
| disabled | `boolean` | `false` | Turns the slots off. A disabled Field does this too. |
---
Source: https://mizzle.saddy.me/docs/components/forms/calendar.md
# Calendar
> A month grid for choosing a day or a range, written on Date and Intl with no date library. The selection glides to the next day, months travel in the direction you go, a range fills as you move toward its end, and the title opens a grid of months.
Live demo: https://mizzle.saddy.me/docs/components/forms/calendar
## Installation
```bash
npx shadcn@latest add @mizzle/calendar
```
## Usage
```tsx
import { Calendar } from "@/components/mizzle/forms/calendar"
const [date, setDate] = React.useState()
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| mode | `"single" \| "range"` | `"single"` | Choose one day, or a start and an end. |
| value / defaultValue | `Date \| { from: Date; to?: Date } \| null` | - | The chosen day, or the range when mode is range. null is controlled and empty. |
| onValueChange | `(value) => void` | - | Called with the new day, or the range. A range has no to until its second click. |
| month / defaultMonth | `Date` | - | The month on show. Any day in it will do. |
| onMonthChange | `(month: Date) => void` | - | Called with the first day of the month the calendar moves to. |
| min / max | `Date` | - | The first and last day that can be chosen. |
| disabled | `(date: Date) => boolean` | - | Return true for a day that cannot be chosen. |
| weekStartsOn | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | `from the locale, else 1` | The first column, with 0 as Sunday. |
| locale | `string` | `the browser's` | Sets the month and weekday names and the numerals. |
| showOutsideDays | `boolean` | `true` | Draws the days of the neighbouring months, muted, in the leading and trailing cells. |
---
Source: https://mizzle.saddy.me/docs/components/chat/message.md
# Message
> One message in a conversation: who sent it, the bubble, and what is said underneath. Messages from the same person run together, replies quote what they answer, and reactions sit on the bubble’s edge.
Live demo: https://mizzle.saddy.me/docs/components/chat/message
## Installation
```bash
npx shadcn@latest add @mizzle/message
```
## Usage
```tsx
import { Bubble, Message, MessageAvatar, MessageContent, MessageFooter } from "@/components/mizzle/chat/message"
Are we still on for brunch tomorrow?
Yes, 10 at the usual place.
09:43
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| align | `"start" \| "end"` | `"start"` | On Message: received on the left, sent on the right. |
| variant | `"default" \| "accent" \| "plain"` | - | On Bubble: muted, solid or no surface. Defaults to muted when received and solid when sent. |
| src / fallback | `string` | - | On MessageAvatar: an image, or initials. Leave both out to hold the space. |
| name | `string` | - | On MessageAvatar: who it is. Sets their colour, matching their replies. |
| author / hue | `ReactNode / number` | - | On BubbleReply: who wrote the message being answered, and optionally the hue of their colour. |
| open | `boolean` | - | On MessageActions: keep it showing, for example while a picker it opened is up. |
| reactions / onToggle | `{ emoji, count, mine? }[] / (emoji) => void` | - | On BubbleReactions: the chips, and what a click does. |
---
Source: https://mizzle.saddy.me/docs/components/chat/message-status.md
# Message Status
> Where a sent message has got to: sending, sent, delivered, read, or not delivered. The clock fades into a tick, a second tick joins it, and read takes on colour.
Live demo: https://mizzle.saddy.me/docs/components/chat/message-status
## Installation
```bash
npx shadcn@latest add @mizzle/message-status
```
## Usage
```tsx
import { MessageStatus } from "@/components/mizzle/chat/message-status"
import { MessageFooter } from "@/components/mizzle/chat/message"
09:43
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| status | `"sending" \| "sent" \| "delivered" \| "read" \| "failed"` | - | Where the message has got to. |
| showLabel | `boolean` | `false` | Show the word beside the icon. |
| label | `ReactNode` | - | Your own word for the state. |
---
Source: https://mizzle.saddy.me/docs/components/chat/typing-indicator.md
# Typing Indicator
> Someone is writing. Three dots that rise and settle in turn inside a bubble, or a small pill that names who is typing.
Live demo: https://mizzle.saddy.me/docs/components/chat/typing-indicator
## Installation
```bash
npx shadcn@latest add @mizzle/typing-indicator
```
## Usage
```tsx
import { TypingDots, TypingStatus } from "@/components/mizzle/chat/typing-indicator"
import { Bubble } from "@/components/mizzle/chat/message"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| label | `string` | `"Typing"` | On TypingDots: what screen readers hear. |
| typers | `{ name, src?, initials? }[]` | - | On TypingStatus: who is typing. |
---
Source: https://mizzle.saddy.me/docs/components/chat/chat-divider.md
# Chat Divider
> The quiet structure of a conversation: a line for each day, a line where the unread messages start, and a small note when someone joins or leaves.
Live demo: https://mizzle.saddy.me/docs/components/chat/chat-divider
## Installation
```bash
npx shadcn@latest add @mizzle/chat-divider
```
## Usage
```tsx
import { ChatDivider, ChatEvent } from "@/components/mizzle/chat/chat-divider"
Yesterday
3 unread
}>Ineza joined the conversation
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"default" \| "unread"` | `"default"` | On ChatDivider: a day line, or where unread starts. |
| icon | `ReactNode` | - | On ChatEvent: a 14px icon before the text. |
---
Source: https://mizzle.saddy.me/docs/components/chat/reaction-picker.md
# Reaction Picker
> A row of emoji to react with. Each one lifts and grows a little under the pointer, and the ones you have already used are marked.
Live demo: https://mizzle.saddy.me/docs/components/chat/reaction-picker
## Installation
```bash
npx shadcn@latest add @mizzle/reaction-picker
```
## Usage
```tsx
import { ReactionPicker } from "@/components/mizzle/chat/reaction-picker"
toggleReaction(emoji)}
onMore={openEmojiPicker}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| emojis | `string[]` | `["👍", "❤️", "😂", "😮", "🎉"]` | The emoji on offer. |
| selected | `string[]` | - | The ones you have already used. |
| onSelect | `(emoji) => void` | - | Called with the emoji that was picked. |
| onMore | `() => void` | - | Shows a plus at the end and is called when it is pressed. |
---
Source: https://mizzle.saddy.me/docs/components/chat/composer.md
# Composer
> Where a message is written. It grows with what you type, Enter sends, and the microphone turns into a send button as soon as there is something to send.
Live demo: https://mizzle.saddy.me/docs/components/chat/composer
## Installation
```bash
npx shadcn@latest add @mizzle/composer
```
## Usage
```tsx
import { Composer } from "@/components/mizzle/chat/composer"
send(text)}
onAttach={pickFile}
onRecord={startRecording}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| onSend | `(text) => void` | - | Called with the trimmed text. The box clears itself. |
| onAttach | `() => void` | - | Shows the paperclip and is called when it is pressed. |
| onRecord | `() => void` | - | Shows the microphone while the box is empty. |
| value / onValueChange | `string` | - | The draft, when you hold it yourself. |
| placeholder | `string` | `"Message"` | Shown while the box is empty, and its label. |
---
Source: https://mizzle.saddy.me/docs/components/chat/voice-note.md
# Voice Note
> A recorded message in a chat bubble. The waveform fills as it plays, and the play button turns into pause in one movement. Pair it with Voice Recorder and it shows the shape of what was actually said.
Live demo: https://mizzle.saddy.me/docs/components/chat/voice-note
## Installation
```bash
npx shadcn@latest add @mizzle/voice-note
```
## Usage
```tsx
import { Message } from "@/components/mizzle/chat/message"
import { VoiceNote, VoiceNoteGroup } from "@/components/mizzle/chat/voice-note"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src | `string` | - | The audio. Its length is read from the file. |
| duration | `number` | `53` | Seconds, for a note without a file, or until the file reports its own. |
| waveform / bars / seed | `number[] / number / number` | - | Bar heights from 0 to 1, or how many bars to make up from a seed. |
| playing / onPlayingChange | `boolean` | - | Control playback yourself. |
| variant | `"default" \| "accent"` | - | A received or a sent bubble. Follows the message’s alignment when left out. |
| size | `"sm" \| "md" \| "lg"` | `"md"` | 40, 48 or 56px tall. |
| speeds | `number[]` | `[1, 1.5, 2]` | Speeds the time label cycles through. One entry turns it off. |
---
Source: https://mizzle.saddy.me/docs/components/chat/voice-recorder.md
# Voice Recorder
> A record button that grows into a voice note as you speak. A warm glow drifts round its edge and swells with your voice, the bars build up beside it, and stopping hands back the audio with its real waveform.
Live demo: https://mizzle.saddy.me/docs/components/chat/voice-recorder
## Installation
```bash
npx shadcn@latest add @mizzle/voice-recorder
```
## Usage
```tsx
import { VoiceRecorder } from "@/components/mizzle/chat/voice-recorder"
import { VoiceNote } from "@/components/mizzle/chat/voice-note"
send( )
}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| onRecorded | `({ blob, url, duration, waveform }) => void` | - | Called when the recording is stopped, or time runs out. |
| onCancel | `() => void` | - | Called when the recording is discarded. |
| autoStart | `boolean` | `false` | Start listening as soon as it appears. |
| maxDuration | `number` | `120` | Seconds before it stops on its own. |
| bars | `number` | `36` | How many bars the returned waveform has. |
| accent | `string` | `"oklch(0.7 0.19 45)"` | The colour of the glow. |
---
Source: https://mizzle.saddy.me/docs/components/chat/poll.md
# Poll
> A question with a few answers, sent as a message. Tap one and the bars fill to each answer’s share, the percentages roll into place and the people who chose it appear beside it. Let people pick several, close it when the time is up, and it settles into the final count.
Live demo: https://mizzle.saddy.me/docs/components/chat/poll
## Installation
```bash
npx shadcn@latest add @mizzle/poll
```
## Usage
```tsx
import { Poll } from "@/components/mizzle/chat/poll"
saveVote(ids)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| question | `string` | - | What is being asked. |
| options | `{ id, label, votes, voters?: { name, src? }[] }[]` | - | The answers, the votes they have so far, and optionally who cast them. |
| multiple / respondents | `boolean / number` | `false` | Let people pick several. Shares are then measured against how many people voted; give that count, or the busiest answer stands in for it. |
| defaultVote | `string \| string[] \| null` | - | Answers already chosen, already counted in their votes. |
| onVote | `(ids: string[]) => void` | - | Called with the chosen ids after every change; empty when a vote is taken back. |
| me | `{ name, src? }` | - | Who is voting, so their avatar joins the answer they pick. |
| closed / closedLabel | `boolean / string` | `false / "Final results"` | Stop taking votes and show the results as they stand. |
| hint | `string` | - | The line under the answers before anyone votes. |
---
Source: https://mizzle.saddy.me/docs/components/chat/status-dot.md
# Status Dot
> Presence with a shape for each status: a glowing dot that pulses when online, a crescent for away, a bar for do not disturb and a ring for offline. Changing status springs it into the new shape. StatusPill puts the dot and its name in a tinted chip.
Live demo: https://mizzle.saddy.me/docs/components/chat/status-dot
## Installation
```bash
npx shadcn@latest add @mizzle/status-dot
```
## Usage
```tsx
import { StatusDot, StatusPill } from "@/components/mizzle/chat/status-dot"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| status | `"online" \| "away" \| "busy" \| "offline"` | `"online"` | Which status to show. |
| size | `number` | `10` | The dot's width in pixels. |
| pulse | `boolean` | `true` | Send rings out while online. |
---
Source: https://mizzle.saddy.me/docs/components/ai/prompt-input.md
# Prompt Input
> Where a prompt is written. It takes files from a picker, a drop or a paste, records voice notes with a glow that swells with your voice, opens a menu for / commands and @ mentions as you type them, picks a model, and turns its send button into a stop button while the answer streams.
Live demo: https://mizzle.saddy.me/docs/components/ai/prompt-input
## Installation
```bash
npx shadcn@latest add @mizzle/prompt-input
```
## Usage
```tsx
import { PromptInput, PromptInputAttach, PromptInputAttachment, PromptInputAttachments, PromptInputCommands, PromptInputFooter, PromptInputModelSelect, PromptInputRecord, PromptInputSubmit, PromptInputTextarea, PromptInputTools } from "@/components/mizzle/ai/prompt-input"
add(files)}
allowEmpty={attached.length > 0}
>
{attached.map((file) => (
remove(file)} />
))}
addVoice(recording)} />
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| status | `"ready" \| "submitted" \| "streaming"` | `"ready"` | On PromptInput. Ready sends; submitted waits; streaming stops. |
| onSubmit / onStop | `(text) => void / () => void` | - | On PromptInput. Called with the trimmed text, or to stop the answer. |
| value / onValueChange | `string` | - | On PromptInput. The draft, when you hold it yourself. |
| onAttach / accept | `(files: File[]) => void / string` | - | On PromptInput. Turns on the picker, dropping and pasting; accept narrows the picker. |
| allowEmpty | `boolean` | `false` | On PromptInput. Lets it send with no text, e.g. with files. |
| open | `boolean` | `true` | On PromptInputTray. Rises out from behind the card. |
| onRecorded | `({ blob, url, duration, waveform }) => void` | - | On PromptInputRecord. Called when a recording is kept. |
| accent / maxDuration | `string / number` | `"oklch(0.7 0.19 45)" / 120` | On PromptInputRecord. The glow colour, and the seconds after which it stops by itself. |
| trigger | `string` | `"/"` | On PromptInputCommands. The character that opens it. |
| items | `{ value, label?, description?, icon? }[]` | - | On PromptInputCommands. What can be picked. |
| onSelect | `(item) => string \| void` | - | On PromptInputCommands. Return the text to insert, or leave it to insert the trigger and value. |
| models | `{ value, label, description? }[]` | - | On PromptInputModelSelect. The models to choose from. |
---
Source: https://mizzle.saddy.me/docs/components/ai/message-scroller.md
# Message Scroller
> A transcript that only moves when the reader asks it to. A new prompt rises to the top with the end of the last answer still in view, the reply streams into the space below it, and scrolling away is respected until you jump back.
Live demo: https://mizzle.saddy.me/docs/components/ai/message-scroller
## Installation
```bash
npx shadcn@latest add @mizzle/message-scroller
```
## Usage
```tsx
import { MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerViewport } from "@/components/mizzle/ai/message-scroller"
{messages.map((message) => (
{/* your message */}
))}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| scrollAnchor | `boolean` | `false` | On MessageScrollerItem. This row starts a new turn. |
| messageId | `string` | - | On MessageScrollerItem. A stable id for scrollToMessage. |
| defaultScrollPosition | `"start" \| "end" \| "last-anchor"` | `"last-anchor"` | On MessageScroller. Where a saved transcript opens. |
| peek | `number` | `64` | On MessageScroller. How much of the previous turn stays above a new one. |
| autoScroll | `boolean` | `true` | On MessageScroller. Anchor new turns and follow the live edge. |
| direction | `"start" \| "end"` | `"end"` | On MessageScrollerButton. Which end it jumps to. |
---
Source: https://mizzle.saddy.me/docs/components/ai/turn.md
# Turn
> One exchange: what you asked, then what the agent did and said. The prompt is a bubble on the right with its attachments above it and copy and edit on hover; the reply is a column the other pieces stack into, in the order they happened.
Live demo: https://mizzle.saddy.me/docs/components/ai/turn
## Installation
```bash
npx shadcn@latest add @mizzle/turn
```
## Usage
```tsx
import { Turn, TurnPrompt, TurnReply } from "@/components/mizzle/ai/turn"
import { CopyAction, Response, ResponseAction } from "@/components/mizzle/ai/response"
}
actions={
<>
edit(prompt)}>
>
}
>
{prompt}
{thought}
{answer}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children | `ReactNode` | - | On TurnPrompt. The prompt text. Leave it empty for a turn that is only attachments or a voice note. |
| attachments | `ReactNode` | - | On TurnPrompt. Files or a voice note, shown above the bubble. |
| actions | `ReactNode` | - | On TurnPrompt. Buttons under the bubble that show on hover or focus, such as CopyAction and ResponseAction. |
| children | `ReactNode` | - | On TurnReply. Reasoning, tool calls, the plan, the response and its actions, in order. |
---
Source: https://mizzle.saddy.me/docs/components/ai/outline.md
# Outline
> The questions asked so far, as a rail of marks at the edge of the transcript. The mark for the turn you are reading is longer; rest on the rail and the questions fan out beside their marks; pick one and the transcript glides back to it.
Live demo: https://mizzle.saddy.me/docs/components/ai/outline
## Installation
```bash
npx shadcn@latest add @mizzle/outline
```
## Usage
```tsx
import { Outline } from "@/components/mizzle/ai/outline"
import { MessageScroller, MessageScrollerContent, MessageScrollerItem, MessageScrollerViewport } from "@/components/mizzle/ai/message-scroller"
{turns.map((turn) => (
{/* … */}
))}
({ id: turn.id, label: turn.prompt }))} />
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| items* | `{ id, label }[]` | - | One per question, in order. Each id matches the messageId of a MessageScrollerItem with scrollAnchor. |
| active | `string \| null` | - | Which mark is current. Left out, it follows the turn in view inside a MessageScroller. |
| onSelect | `(id) => void` | - | Called with the id that was picked. Inside a MessageScroller the transcript also scrolls there. |
| margin | `number` | `64` | Pixels left above the turn when it scrolls into place. Match the scroller’s peek. |
| label | `string` | `"Questions"` | The rail’s name for screen readers. |
---
Source: https://mizzle.saddy.me/docs/components/ai/response.md
# Response
> An answer as it streams. Each word comes out of a slight blur as it arrives, numbered citations become source chips you can hover, and the actions underneath copy, rate and retry.
Live demo: https://mizzle.saddy.me/docs/components/ai/response
## Installation
```bash
npx shadcn@latest add @mizzle/response
```
## Usage
```tsx
import { CopyAction, Response, ResponseAction, ResponseActions } from "@/components/mizzle/ai/response"
{text}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children | `string` | - | The text so far. |
| streaming | `boolean` | `false` | Still arriving, so hold back an unfinished last word. |
| sources | `{ title, url, snippet?, icon? }[]` | - | What [1], [2] and so on point to. |
| label | `string` | - | On ResponseAction. Its name and tooltip. |
| text | `string` | - | On CopyAction. What it copies. |
---
Source: https://mizzle.saddy.me/docs/components/ai/sources.md
# Sources
> Where an answer came from. A row of site icons, a count and the first domains, opening into the full list: numbered to match the citations in the text, each with its site, title and a line of what it said.
Live demo: https://mizzle.saddy.me/docs/components/ai/sources
## Installation
```bash
npx shadcn@latest add @mizzle/sources
```
## Usage
```tsx
import { Sources } from "@/components/mizzle/ai/sources"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| sources | `{ title, url, snippet?, icon? }[]` | - | The sources, in citation order. |
| label | `string` | - | The button text. Defaults to the count. |
| defaultOpen | `boolean` | `false` | Start with the list open. |
| open / onOpenChange | `boolean / (open) => void` | - | Hold the list open or closed yourself. |
---
Source: https://mizzle.saddy.me/docs/components/ai/suggestions.md
# Suggestions
> Prompts to try next, as pills or as a list of follow-ups. They arrive one after another so the eye reads them in order.
Live demo: https://mizzle.saddy.me/docs/components/ai/suggestions
## Installation
```bash
npx shadcn@latest add @mizzle/suggestions
```
## Usage
```tsx
import { Suggestion, Suggestions } from "@/components/mizzle/ai/suggestions"
send("Why are clouds white?")}>
Why are clouds white?
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"pills" \| "list"` | `"pills"` | On Suggestions. A row of pills or a list. |
| label | `string` | - | On Suggestions. A heading, and the group’s name. |
---
Source: https://mizzle.saddy.me/docs/components/ai/reasoning.md
# Reasoning
> The model thinking out loud, kept to a small window. While it thinks the latest lines scroll up in steps under a shimmering label; when it is done it folds away into how long it took, and opens again to read in full.
Live demo: https://mizzle.saddy.me/docs/components/ai/reasoning
## Installation
```bash
npx shadcn@latest add @mizzle/reasoning
```
## Usage
```tsx
import { Reasoning } from "@/components/mizzle/ai/reasoning"
{reasoning}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| streaming | `boolean` | `false` | Still thinking. |
| duration | `number` | - | Seconds it thought for. Timed when left out. |
| lines | `number` | `3` | How many lines show while it thinks. |
| open / defaultOpen / onOpenChange | `boolean` | - | Hold it open or closed. By default it is open while thinking. |
| streamingLabel / label | `string` | `"Thinking"` | The label while thinking, and once it is done. |
---
Source: https://mizzle.saddy.me/docs/components/ai/tool-call.md
# Tool Call
> What an agent did, one row per step. A step shimmers while it runs and draws a tick when it finishes; rows with output open to show it, and a group folds the whole run into one line.
Live demo: https://mizzle.saddy.me/docs/components/ai/tool-call
## Installation
```bash
npx shadcn@latest add @mizzle/tool-call
```
## Usage
```tsx
import { ToolCall, ToolCalls, ToolOutput } from "@/components/mizzle/ai/tool-call"
{log}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| name | `string` | - | On ToolCall. The tool, such as Read or Search. |
| target | `ReactNode` | - | On ToolCall. What it worked on. |
| status | `"pending" \| "running" \| "done" \| "failed"` | `"done"` | On ToolCall. Where the step is. |
| added / removed | `number` | - | On ToolCall. Lines changed. |
| title / running | `string / boolean` | - | On ToolCalls. The group’s line, and whether it shimmers. |
---
Source: https://mizzle.saddy.me/docs/components/ai/tasks.md
# Tasks
> The to-do list an agent is working through. A ring fills as tasks finish, the one in progress shimmers over the file it is touching, a finished one keeps what it changed at its side, and folded it is a single line naming what is happening now. It sits best in a tray rising out of the prompt input.
Live demo: https://mizzle.saddy.me/docs/components/ai/tasks
## Installation
```bash
npx shadcn@latest add @mizzle/tasks
```
## Usage
```tsx
import { Tasks } from "@/components/mizzle/ai/tasks"
import { PromptInput, PromptInputTray } from "@/components/mizzle/ai/prompt-input"
…
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| tasks* | `{ id, title, status: "pending" \| "running" \| "done" \| "failed", progress?, detail?, meta?, error? }[]` | - | The tasks, in order. Give a running task a `progress` from 0 to 1 and its ring fills to that share, with the percentage rolling beside it; leave it out and the ring turns. `detail` is a second line such as a file path, `meta` sits at the right once the task is done (lines changed, time taken) and `error` shows under a failed one. |
| title | `string` | `"Tasks"` | The header label. |
| open / defaultOpen / onOpenChange | `boolean` | `true` | Whether the list is shown, or only the header line. |
---
Source: https://mizzle.saddy.me/docs/components/ai/plan.md
# Plan
> A plan the agent proposes before it acts: a title, a line on what it changes, the scope in a few words, and numbered steps that arrive one by one with the files each one touches. Start it and the steps tick off as the work runs; ask for changes and say what should change without leaving the card.
Live demo: https://mizzle.saddy.me/docs/components/ai/plan
## Installation
```bash
npx shadcn@latest add @mizzle/plan
```
## Usage
```tsx
import { Plan } from "@/components/mizzle/ai/plan"
revise(note)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| title / description | `ReactNode` | - | What the plan is, and what it touches. |
| scope | `string[]` | - | A few facts under the description, such as how many files it touches. |
| steps* | `{ title, description?, files?, status?: "pending" \| "running" \| "done" \| "failed" }[]` | - | The steps, in order. Add to it while streaming; set each step’s status as the work runs and the plan reads Plan complete when every step is done. |
| status | `"streaming" \| "ready" \| "approved" \| "declined"` | `"ready"` | Where the plan is in its life. |
| onApprove / onRevise | `() => void / (note: string) => void` | - | Shows each button when given. Revise opens a field inside the card and sends what was typed. |
| approveLabel / reviseLabel / revisePlaceholder | `string` | `"Approve" / "Revise" / "What should change?"` | The button labels, and the field’s placeholder. |
| open / defaultOpen / onOpenChange | `boolean` | - | Whether the steps show. By default they do until the plan is decided. |
---
Source: https://mizzle.saddy.me/docs/components/ai/confirmation.md
# Confirmation
> The agent asking for a yes before it does something: run a command, start a plan, touch a file. One line says what and why, two buttons answer, and once answered it settles into a quiet record of the decision.
Live demo: https://mizzle.saddy.me/docs/components/ai/confirmation
## Installation
```bash
npx shadcn@latest add @mizzle/confirmation
```
## Usage
```tsx
import { Confirmation } from "@/components/mizzle/ai/confirmation"
setStatus("approved")}
onReject={() => setStatus("rejected")}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| title / description | `ReactNode` | - | The question, and what saying yes will do. |
| status | `"pending" \| "approved" \| "rejected"` | `"pending"` | Whether it is still waiting, and how it was answered. |
| onApprove / onReject | `() => void` | - | Shows each button when given. |
| approveLabel / rejectLabel | `string` | `"Allow" / "Deny"` | The button labels. |
| approvedLabel / rejectedLabel | `string` | `"Allowed" / "Denied"` | What the row says once answered. |
| icon | `ReactNode` | - | Replaces the shield. |
---
Source: https://mizzle.saddy.me/docs/components/ai/questionnaire.md
# Questionnaire
> An agent asking before it acts, one question at a time, in the same tinted bubble as the rest of the conversation. Pick with a click or the number key shown at the end of each row, and a single answer moves on by itself; a strip of steps shows how far along you are, the card glides to the height of each question as one dissolves into the next, and once sent it keeps a record of what was said.
Live demo: https://mizzle.saddy.me/docs/components/ai/questionnaire
## Installation
```bash
npx shadcn@latest add @mizzle/questionnaire
```
## Usage
```tsx
import { Questionnaire } from "@/components/mizzle/ai/questionnaire"
reply(answers)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| questions | `{ id, title, description?, type?, options?, other?, optional? }[]` | - | What to ask, in order. |
| onSubmit | `(answers) => void` | - | Called with { [id]: { values, other } } when the last question is sent. |
| onAnswer | `(id, answer) => void` | - | Called whenever an answer changes, before the send. |
| onDismiss | `() => void` | - | Shows a close button. |
| submitLabel / sentLabel | `string` | `"Send" / "Answers sent"` | The last button, and the line once sent. |
---
Source: https://mizzle.saddy.me/docs/components/ai/marker.md
# Marker
> A line in a conversation that is not a message: what the agent is doing, what it did, or a labelled break.
Live demo: https://mizzle.saddy.me/docs/components/ai/marker
## Installation
```bash
npx shadcn@latest add @mizzle/marker
```
## Usage
```tsx
import { Marker, MarkerContent, MarkerIcon } from "@/components/mizzle/ai/marker"
import { Loader } from "@/components/mizzle/ai/loader"
Reading 4 files
Worked for 42s
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"default" \| "border" \| "separator"` | `"default"` | On Marker. A row, a row with a line under it, or a break. |
| render | `ReactElement \| function` | - | On Marker. Render it as a link or a button. |
| shimmer | `boolean` | `false` | On MarkerContent. Show it as in progress. |
---
Source: https://mizzle.saddy.me/docs/components/ai/shimmer.md
# Shimmer
> A band of light that passes over text while something is working. It is made from the text’s own colour, so it suits any text and anything inside it, icons included.
Live demo: https://mizzle.saddy.me/docs/components/ai/shimmer
## Installation
```bash
npx shadcn@latest add @mizzle/shimmer
```
## Usage
```tsx
import { Shimmer } from "@/components/mizzle/ai/shimmer"
Thinking…
Generating a response
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| active | `boolean` | `true` | Whether it shimmers. |
| duration | `number` | `2000` | Milliseconds for one sweep. |
| spread | `number` | `40` | Pixels either side of the band’s centre. |
| dim | `number` | `0.5` | How much of the text shows outside the band. |
| once | `boolean` | `false` | Sweep once and stop. |
---
Source: https://mizzle.saddy.me/docs/components/ai/loader.md
# Loader
> Sixteen dots in a square that swell and light up in a pattern: a scan, a wave, a twinkle, an orbit, a pulse, a spiral, rain or rising bars. Round, soft-cornered or square, in the text colour or a palette of your own, and small enough to sit beside a line of text.
Live demo: https://mizzle.saddy.me/docs/components/ai/loader
## Installation
```bash
npx shadcn@latest add @mizzle/loader
```
## Usage
```tsx
import { Loader } from "@/components/mizzle/ai/loader"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"scan" \| "wave" \| "twinkle" \| "orbit" \| "pulse" \| "spiral" \| "rain" \| "bars"` | `"scan"` | The pattern. |
| shape | `"dot" \| "rounded" \| "square"` | `"dot"` | Round dots, soft corners or sharp ones. |
| colors | `string[]` | - | One colour, or several spread across the square. Left out, the dots take the text colour. |
| size | `"sm" \| "md" \| "lg" \| "xl"` | `"md"` | 14, 18, 25 or 36 pixels across. |
| cycle | `number` | `1200` | Milliseconds for one pulse. |
| label | `string` | `"Loading"` | What screen readers hear. |
---
Source: https://mizzle.saddy.me/docs/components/ai/orb.md
# Orb
> An orb of fine dots that shows what an agent is doing. The same dots rearrange for each step it goes through: listening, thinking, searching, connecting, composing, imagining, shaping and speaking, each with a movement that means something. It works at 20 pixels beside a line of text and at any size on its own.
Live demo: https://mizzle.saddy.me/docs/components/ai/orb
## Installation
```bash
npx shadcn@latest add @mizzle/orb
```
## Usage
```tsx
import { Orb } from "@/components/mizzle/ai/orb"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| state | `"idle" \| "listening" \| "thinking" \| "searching" \| "connecting" \| "composing" \| "imagining" \| "shaping" \| "speaking"` | `"idle"` | What the assistant is doing, which sets how the dots are arranged. |
| size | `number` | `64` | Width and height in pixels. |
| level | `number \| RefObject` | `0` | How loud the voice is, from 0 to 1. Used while listening and speaking. |
| colors | `string[]` | - | Shades the dots from top to bottom. Left out, they take the text colour. |
| dots | `number` | - | How many dots. By default it follows the size. |
| dotSize | `number` | `1` | A multiplier on the size of each dot. |
| speed | `number` | `1` | How fast everything moves. |
| label | `string` | - | What screen readers hear. Without it the orb is hidden from them. |
---
Source: https://mizzle.saddy.me/docs/components/ai/image-generation.md
# Image Generation
> A placeholder that becomes the picture. A grid of soft tiles moves in a pattern of your choosing while the image is made, takes on its colours the moment it arrives, and swells from the middle until the tiles close into the photograph.
Live demo: https://mizzle.saddy.me/docs/components/ai/image-generation
## Installation
```bash
npx shadcn@latest add @mizzle/image-generation
```
## Usage
```tsx
import { ImageGeneration, ImageGenerationAction } from "@/components/mizzle/ai/image-generation"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src | `string \| null` | - | The finished image. Leave it out while generating. |
| progress | `number` | - | 0 to 1 if your API reports it. |
| estimatedDuration | `number` | `6000` | Milliseconds to pace itself to without progress. |
| aspect | `number` | `1` | Width over height. |
| caption | `string` | - | A status shown over the tiles while the image is made. |
| variant | `"cloud" \| "wave" \| "ripple" \| "scan" \| "twinkle" \| "rise"` | `"cloud"` | How the tiles move while the picture is made. |
| shape | `"rounded" \| "square" \| "dot"` | `"rounded"` | What each tile is. |
| cell | `number` | `22` | The size of one tile and its gap, in pixels. |
| colors | `string[]` | - | One colour or several for the waiting tiles. Left out, they take the text colour. |
| alt | `string` | - | What the picture shows, for the finished image. |
| children | `ReactNode` | - | Actions for the finished picture, such as ImageGenerationAction buttons. |
| label / href / download | `string / string / boolean \| string` | - | On ImageGenerationAction. Its name, and a link to open or save in place of a click. |
| onRevealComplete | `() => void` | - | Called once the picture has fully resolved. |
| onError | `() => void` | - | Called if the image fails to load. |
---
Source: https://mizzle.saddy.me/docs/components/ai/agent-fleet.md
# Agent Fleet
> Every lead agent you have running, in one column, with the sub-agents of the one you pick drawn out beside it. Lines grow from the lead to each helper, a helper's own helpers hang below it, and a card that needs you gets an Answer button.
Live demo: https://mizzle.saddy.me/docs/components/ai/agent-fleet
## Installation
```bash
npx shadcn@latest add @mizzle/agent-fleet
```
## Usage
```tsx
import { AgentFleet } from "@/components/mizzle/ai/agent-fleet"
open(agent)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| leads* | `FleetLead[]` | - | The lead agents, each with its subagents. A sub-agent with a parent hangs below that sub-agent. |
| title | `ReactNode` | `"Fleet"` | The heading. Counts, running agents and the total cost sit beside it. |
| defaultValue | `string` | - | The lead shown first. Defaults to the first. |
| value | `string` | - | The lead shown, when you control it. |
| onValueChange | `(id: string) => void` | - | Called when another lead is picked. |
| onAnswer | `(agent: FleetAgent) => void` | - | Shows an Answer button on sub-agents that need you. |
---
Source: https://mizzle.saddy.me/docs/components/ai/agent-tree.md
# Agent Tree
> An orchestrator and the agents it handed work to, joined by one bracket. Each agent with helpers of its own opens them below it on a branch, and folds them away again.
Live demo: https://mizzle.saddy.me/docs/components/ai/agent-tree
## Installation
```bash
npx shadcn@latest add @mizzle/agent-tree
```
## Usage
```tsx
import { AgentTree } from "@/components/mizzle/ai/agent-tree"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| agent* | `TreeAgent` | - | The orchestrator. Its children sit in a row; their children open below them. |
| title | `ReactNode` | `"Agents"` | The heading. The agent count, running agents and total cost sit beside it. |
| defaultExpanded | `string[]` | - | Ids of the agents open at first. Defaults to every one with helpers. |
| expanded | `string[]` | - | Ids of the open agents, when you control it. |
| onExpandedChange | `(expanded: string[]) => void` | - | Called when an agent is opened or folded. |
---
Source: https://mizzle.saddy.me/docs/components/ai/agent-handoff.md
# Agent Handoff
> A team of agents in a row, each with what it is doing now, and the queues between them. Work handed from one agent to the next glides from queue to queue; the newest items sit on top and the rest fade out under the edge.
Live demo: https://mizzle.saddy.me/docs/components/ai/agent-handoff
## Installation
```bash
npx shadcn@latest add @mizzle/agent-handoff
```
## Usage
```tsx
import { AgentHandoff } from "@/components/mizzle/ai/agent-handoff"
// Change agents or queues inside startTransition and items glide between queues
startTransition(() => setQueues(next))
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| agents* | `HandoffAgent[]` | - | The team, left to right: id, name, model, mark, cost, working, description and the task in hand. |
| queues* | `HandoffItem[][]` | - | One queue between each pair of agents. An item has a title, detail, tool and verdict. |
| activeItem | `string` | - | The id of the item to outline. |
| visible | `number` | `2` | Items shown in a queue before the rest fade out. |
| onSelectItem | `(item: HandoffItem) => void` | - | Called when an item is clicked. |
---
Source: https://mizzle.saddy.me/docs/components/ai/agent-inbox.md
# Agent Inbox
> Every agent run in one place, sorted into Waiting on you, Running and Done. Flip between a board and a list and the cards glide to their new places; a run that changes state glides to its new column.
Live demo: https://mizzle.saddy.me/docs/components/ai/agent-inbox
## Installation
```bash
npx shadcn@latest add @mizzle/agent-inbox
```
## Usage
```tsx
import { AgentInbox } from "@/components/mizzle/ai/agent-inbox"
open(item.id)}
/>
// Move items inside startTransition so they glide
startTransition(() => setItems(next))
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| items* | `InboxItem[]` | - | The runs: id, title, summary, column, failed, elapsed, searches, tools and an optional mark. |
| view | `"board" \| "list"` | - | The view, when you control it. |
| defaultView | `"board" \| "list"` | `"board"` | The view shown at first. |
| onViewChange | `(view: InboxView) => void` | - | Called when the switch is used. |
| onSelect | `(item: InboxItem) => void` | - | Called when a card is clicked. |
---
Source: https://mizzle.saddy.me/docs/components/ai/agent-run.md
# Agent Run
> One agent at work, small enough for a corner: the step it is on with its clock, a bar with a segment per step and a light that runs along the current one, the last steps it finished, and buttons to pause or stop it. Folds down to its header and bar.
Live demo: https://mizzle.saddy.me/docs/components/ai/agent-run
## Installation
```bash
npx shadcn@latest add @mizzle/agent-run
```
## Usage
```tsx
import { AgentRun } from "@/components/mizzle/ai/agent-run"
setPaused(!paused)}
onCancel={cancel}
onLog={openLog}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| steps* | `AgentRunStep[]` | - | Every step: id, title, tool and duration once done. |
| current* | `number` | - | The index of the step running now. Steps before it are done; steps.length means finished. |
| mark / name / subtitle / cost* | `Mark / string` | - | Who is running and what it has cost. Only mark and name are required. |
| elapsed | `string` | - | The clock on the current step. |
| paused | `boolean` | `false` | Stops the light and turns Pause into Resume. |
| history | `number` | `3` | How many finished steps are listed. |
| onPause / onCancel / onLog | `() => void` | - | Each button shows only when its handler is given. |
| defaultOpen / open / onOpenChange | `boolean / (open: boolean) => void` | `true` | Whether the steps and buttons are unfolded. |
---
Source: https://mizzle.saddy.me/docs/components/ai/agent-steps.md
# Agent Steps
> An agent's run as a timeline. Finished steps tick and join up along a rail, the current one spins with a live clock, and what it is doing right now branches off beneath it, one line at a time. A step that waits on you rings in amber and asks to be approved or denied.
Live demo: https://mizzle.saddy.me/docs/components/ai/agent-steps
## Installation
```bash
npx shadcn@latest add @mizzle/agent-steps
```
## Usage
```tsx
import { AgentSteps } from "@/components/mizzle/ai/agent-steps"
approve(step.id)}
onDeny={(step) => skip(step.id)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| title* | `ReactNode` | - | What the run is for. |
| steps* | `AgentStep[]` | - | Each with id, title and state: done, active, pending, approval or skipped. time shows on done steps, label beside the active one, startedAt ticks a live clock, items branch off while it is active. |
| onApprove | `(step: AgentStep) => void` | - | Shows an Approve button under a step that is waiting for approval. |
| onDeny | `(step: AgentStep) => void` | - | Shows a Deny button beside it. Mark the step skipped to cross it out. |
---
Source: https://mizzle.saddy.me/docs/components/ai/decision-tree.md
# Decision Tree
> A question an agent can't answer alone, with its options laid out as branches. The agent's suggestion is marked; choosing a branch glides its follow-up in beside it, and the numbers on the keys pick from the keyboard. Several waiting decisions page with the arrow keys.
Live demo: https://mizzle.saddy.me/docs/components/ai/decision-tree
## Installation
```bash
npx shadcn@latest add @mizzle/decision-tree
```
## Usage
```tsx
import { DecisionTree } from "@/components/mizzle/ai/decision-tree"
reply(decision.id, option.id, choice?.id)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| decisions* | `Decision[]` | - | Each with an agent, a question, optional risk and context, and options. An option leads to a followUp with choices, a single outcome, or a text box when other is set; picked marks the agent's choice. |
| title | `ReactNode` | `"Decisions"` | The heading. |
| onDecide | `(decision, option, choice?) => void` | - | Called when an option without a follow-up is picked, or a follow-up choice is. |
| onOther | `(decision, text) => void` | - | Called with what was written for Other. |
---
Source: https://mizzle.saddy.me/docs/components/ai/model-fallback.md
# Model Fallback
> One request routed down a list of models. A rate-limited model turns red and its wire goes dashed, the next one lights up with a signal flowing towards it, and the response node answers once a model gets through.
Live demo: https://mizzle.saddy.me/docs/components/ai/model-fallback
## Installation
```bash
npx shadcn@latest add @mizzle/model-fallback
```
## Usage
```tsx
import { ModelFallback } from "@/components/mizzle/ai/model-fallback"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| attempts* | `FallbackAttempt[]` | - | The models in the order they are tried: id, mark, model, provider and state ("pending" \| "trying" \| "failed" \| "success"), with an optional note, latency, cost and progress from 0 to 1. |
| title* | `ReactNode` | - | What the request is for. |
| route* | `string` | - | Shown in mono on the request node. |
| elapsed / cost | `string` | - | Shown next to the attempt count. |
| response | `ReactNode` | - | The line under Response once a model answers. |
---
Source: https://mizzle.saddy.me/docs/components/ai/judge-bracket.md
# Judge Bracket
> Candidate fixes play off in a bracket. Scores roll in as each match is judged, winners carry forward along solid lines while losers dim behind dotted ones, and the two finalists sit side by side for the last call.
Live demo: https://mizzle.saddy.me/docs/components/ai/judge-bracket
## Installation
```bash
npx shadcn@latest add @mizzle/judge-bracket
```
## Usage
```tsx
import { JudgeBracket } from "@/components/mizzle/ai/judge-bracket"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| rounds* | `JudgeRound[]` | - | Each round has a title and matches; each round has half the matches of the one before. A match holds two entrants (null for a seat not filled yet) and the index of its winner once judged. |
| task* | `ReactNode` | - | What the candidates are trying to solve. |
| finalists | `JudgeFinalist[]` | - | The two finalists compared below the bracket: mark, name, meta, summary and optional code. |
| judge | `ReactNode` | - | What the judge is doing, shimmering until the final is decided. |
| title | `ReactNode` | `"Judge"` | The heading. |
---
Source: https://mizzle.saddy.me/docs/components/ai/bot-avatar.md
# Bot Avatar
> A flat little character for an agent: a coloured circle, squircle, triangle or pill with two tall eyes that glance away and blink now and then, each bot on its own clock. Three of them gather into a group for a shared thread.
Live demo: https://mizzle.saddy.me/docs/components/ai/bot-avatar
## Installation
```bash
npx shadcn@latest add @mizzle/bot-avatar
```
## Usage
```tsx
import { BotAvatar, BotAvatarGroup } from "@/components/mizzle/ai/bot-avatar"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| shape | `"circle" \| "squircle" \| "triangle" \| "pill"` | `"circle"` | The body. |
| color | `"teal" \| "orange" \| "purple" \| "violet" \| "blue" \| "red" \| "pink" \| "green" \| string` | `"teal"` | One of the palette, or any CSS colour. |
| size | `number` | `32` | Width and height in pixels. On BotAvatarGroup, the size of the whole group. |
| eyes | `"dark" \| "light" \| string` | `"dark"` | The colour of the eyes. |
| eyeSize / eyeGap | `number` | `1 / 1` | Scale the eyes and the space between them. |
| eyeOffset | `number` | `0` | Move the eyes up or down, in units of a 40 unit grid. |
| gaze | `number` | `0` | Where the eyes rest, from -1 (left) to 1 (right). |
| seed | `string` | - | Sets when this bot glances and blinks, so a list does not move in step. Pass the agent's id to keep it stable. |
| animated | `boolean` | `true` | Let the eyes glance and blink, or keep them still. |
| bots* | `BotAvatarProps[]` | - | On BotAvatarGroup: up to three bots, drawn small and gathered together. |
---
Source: https://mizzle.saddy.me/docs/components/text/split-text.md
# Split Text
> Splits a string into words and characters you can style one by one. Words still wrap, spaces stay real, screen readers hear the sentence, and every piece knows its index, word and measured line.
Live demo: https://mizzle.saddy.me/docs/components/text/split-text
## Installation
```bash
npx shadcn@latest add @mizzle/split-text
```
## Usage
```tsx
import { SplitText } from "@/components/mizzle/text/split-text"
Every character knows its index.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children* | `string` | - | The text. |
| by | `"chars" \| "words"` | `"chars"` | Wrap each character, or stop at words. |
| as | `"p" \| "span" \| "h1" \| "h2" \| "h3" \| "div"` | `"p"` | Root element. |
| wordClassName | `string` | - | Classes on every word. |
| charClassName | `string` | - | Classes on every character. |
---
Source: https://mizzle.saddy.me/docs/components/text/text-reveal.md
# Text Reveal
> Text that arrives piece by piece: characters, words or lines. Each one fades, lifts a little and sharpens from a slight blur, so it reads as settling into focus. Pure CSS, no animation library.
Live demo: https://mizzle.saddy.me/docs/components/text/text-reveal
## Installation
```bash
npx shadcn@latest add @mizzle/text-reveal
```
## Usage
```tsx
import { TextReveal } from "@/components/mizzle/text/text-reveal"
Words rise into place, one after another.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children* | `string` | - | The text. |
| effect | `"fade" \| "rise" \| "blur" \| "mask"` | `"rise"` | How each piece arrives. |
| by | `"chars" \| "words" \| "lines"` | `"words"` | What moves as one piece. Ignored by mask, which uses lines. |
| stagger | `number` | `0.04` | Seconds between pieces. |
| delay | `number` | `0` | Seconds before the first piece. |
| duration | `number` | `0.5` | Seconds each piece takes. |
| from | `"first" \| "last" \| "center" \| "random"` | `"first"` | Where the stagger starts. |
| inView | `boolean` | `true` | Wait until scrolled into view. |
| once | `boolean` | `true` | Play once, or on every entry. |
---
Source: https://mizzle.saddy.me/docs/components/text/text-swap.md
# Text Swap
> Change a word without it blinking. The old word lifts away and blurs out as the new one rises in, and the space between them stretches to fit, so nothing beside it jumps.
Live demo: https://mizzle.saddy.me/docs/components/text/text-swap
## Installation
```bash
npx shadcn@latest add @mizzle/text-swap
```
## Usage
```tsx
import { TextSwap } from "@/components/mizzle/text/text-swap"
{saving ? "Saving" : "Saved"}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children | `string` | - | The text. Change it to swap. |
| duration | `number` | `150` | Milliseconds for each word’s half of the swap. |
| variant | `"lift" \| "fade"` | `"lift"` | Lift: the old text rises away blurring and the new one rises in after it. Fade: the two cross-fade in place, for text that should change without drawing the eye. |
---
Source: https://mizzle.saddy.me/docs/components/text/letter-swap.md
# Letter Swap
> On hover each letter slides out and a copy slides in, one after another, optionally into a different word. Pure CSS: the stagger plays forward on enter and back on leave, and can be interrupted anywhere.
Live demo: https://mizzle.saddy.me/docs/components/text/letter-swap
## Installation
```bash
npx shadcn@latest add @mizzle/letter-swap
```
## Usage
```tsx
import { LetterSwap } from "@/components/mizzle/text/letter-swap"
Hover me
Hello
See the work
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children* | `string` | - | The text at rest. |
| to | `string` | - | Text shown on hover. Defaults to the same text. |
| effect | `"slide" \| "flip"` | `"slide"` | Vertical slide, or a turn about the baseline. |
| direction | `"up" \| "down"` | `"up"` | Which way letters travel. |
| from | `"first" \| "last" \| "center" \| "random"` | `"first"` | Where the stagger starts. |
| stagger | `number` | `0.025` | Seconds between letters. |
| duration | `number` | `0.45` | Seconds each letter takes. |
| as | `"span" \| "a" \| "p" \| "div"` | `"span"` | Root element. Use `a` with `href` for a link. |
---
Source: https://mizzle.saddy.me/docs/components/text/scramble-text.md
# Scramble Text
> Text that resolves out of noise. A sweep crosses the string at a steady rate; characters behind it are final, characters ahead of it churn. Decoding, not glitching.
Live demo: https://mizzle.saddy.me/docs/components/text/scramble-text
## Installation
```bash
npx shadcn@latest add @mizzle/scramble-text
```
## Usage
```tsx
import { ScrambleText } from "@/components/mizzle/text/scramble-text"
DECODING IN PROGRESS
hover to scramble
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children* | `string` | - | The final text. |
| trigger | `"mount" \| "inView" \| "hover"` | `"inView"` | When to play. |
| duration | `number` | `1.2` | Seconds for the sweep to cross the string. |
| delay | `number` | `0` | Seconds before it starts. |
| characters | `string` | - | The noise alphabet. |
---
Source: https://mizzle.saddy.me/docs/components/text/typewriter.md
# Typewriter
> Types a list of phrases one after another, without the harshness: letters fade in and sharpen instead of popping, the rhythm is a little uneven like a person’s, and a finished phrase fades out as one instead of being backspaced.
Live demo: https://mizzle.saddy.me/docs/components/text/typewriter
## Installation
```bash
npx shadcn@latest add @mizzle/typewriter
```
## Usage
```tsx
import { Typewriter } from "@/components/mizzle/text/typewriter"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| words* | `string[]` | - | Phrases, typed in order. |
| speed | `number` | `0.055` | Seconds per character while typing. |
| pause | `number` | `1.8` | Seconds to hold a finished phrase. |
| loop | `boolean` | `true` | Go round again after the last phrase. |
| cursor | `boolean` | `false` | Show a gliding caret at the end of the text. |
| erase | `"fade" \| "backspace"` | `"fade"` | How a finished phrase leaves. |
| prefix | `string` | - | Text before the typed part, never erased. |
---
Source: https://mizzle.saddy.me/docs/components/text/dot-matrix.md
# Dot Matrix
> Text on a dot matrix, five dots wide and seven tall, like a departure board. Unlit dots stay faintly visible, and when the text changes the dots that differ flip in a wave from the left. No JavaScript animation.
Live demo: https://mizzle.saddy.me/docs/components/text/dot-matrix
## Installation
```bash
npx shadcn@latest add @mizzle/dot-matrix
```
## Usage
```tsx
import { DotMatrix } from "@/components/mizzle/text/dot-matrix"
ON TIME
{price}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| length | `number` | - | How many characters wide the board is. Defaults to the text’s length. |
| align | `"start" \| "center" \| "end"` | `"start"` | Where shorter text sits on a wider board. |
| dot | `number` | `4` | The size of a dot, in pixels. |
| gap | `number` | `2` | The space between dots, in pixels. |
| shape | `"round" \| "square"` | `"round"` | Round lamps, or square pixels. |
| inView | `boolean` | `true` | Light up when scrolled into view, or straight away. |
---
Source: https://mizzle.saddy.me/docs/components/text/highlight.md
# Highlight
> A mark made over a word or a phrase: a highlighter that wraps with the text, or a pen stroke under, around or round a word. Each is drawn when it comes into view. No JavaScript animation.
Live demo: https://mizzle.saddy.me/docs/components/text/highlight
## Installation
```bash
npx shadcn@latest add @mizzle/highlight
```
## Usage
```tsx
import { Highlight } from "@/components/mizzle/text/highlight"
Ship the smallest thing that teaches you something,
then write down why.
Once is enough.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| variant | `"marker" \| "underline" \| "box" \| "circle"` | `"marker"` | A highlighter, or one of three pen strokes. |
| color | `string` | - | Any CSS colour. Yellow for the marker and orange for the pen by default. |
| trigger | `"inView" \| "mount" \| "hover"` | `"inView"` | When to draw it. |
| delay | `number` | `0` | Seconds before it starts. |
| duration | `number` | - | Seconds it takes. Left out, the marker works it out from the length of the text. |
| once | `boolean` | `true` | Draw once, or every time it comes into view. |
---
Source: https://mizzle.saddy.me/docs/components/text/signature.md
# Signature
> Draws a signature, or any hand-drawn SVG, stroke by stroke at a steady pen speed, lifting between strokes. Pen centrelines are stroked; filled outlines are revealed as ink along their own path.
Live demo: https://mizzle.saddy.me/docs/components/text/signature
## Installation
```bash
npx shadcn@latest add @mizzle/signature
```
## Usage
```tsx
import { Signature } from "@/components/mizzle/text/signature"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| strokes* | `string[]` | - | One path `d` per pen stroke or filled shape, in drawing order. |
| viewBox* | `string` | - | The SVG viewBox the paths were drawn in. |
| fill | `boolean` | `false` | The paths are outlines of filled shapes; fill and reveal them. |
| duration | `number` | `2` | Seconds for the whole signature. |
| delay | `number` | `0` | Seconds before the first stroke. |
| lift | `number` | `0.08` | Seconds the pen is up between strokes. |
| strokeWidth | `number` | `3` | Pen width in viewBox units. With `fill` it is the revealing stroke and defaults to 6% of the viewBox’s shorter side; it must be wider than the thickest part of a shape. |
| color | `string` | `"currentColor"` | Ink colour. |
| inView | `boolean` | `true` | Wait until scrolled into view. |
| once | `boolean` | `true` | Draw once, or on every entry. |
---
Source: https://mizzle.saddy.me/docs/components/text/number-roll.md
# Number Roll
> A number whose digits roll to their new value. Each digit is a reel behind a soft-edged window: it rolls the way the number moved, streaks while it is fast, and digits fold in and out when the number changes length.
Live demo: https://mizzle.saddy.me/docs/components/text/number-roll
## Installation
```bash
npx shadcn@latest add @mizzle/number-roll
```
## Usage
```tsx
import { NumberRoll } from "@/components/mizzle/text/number-roll"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| value* | `number` | - | The number to show. Change it and the reels roll. |
| format | `Intl.NumberFormatOptions` | - | Currency, percent, compact, fraction digits and so on. |
| locale | `string \| string[]` | `"en-US"` | Locale for formatting. Fixed by default so that the server and the browser render the same digits; pass the visitor’s locale to localise. |
| duration | `number` | `1` | Seconds for the longest roll, through nine digits. Shorter rolls take less, down to about 70% for one step. |
| stagger | `number` | `0.04` | Seconds between neighbouring reels, left to right. |
| spin | `number` | `0` | Extra full turns each reel makes on entrance. |
| inView | `boolean` | `true` | Wait until scrolled into view to roll in. |
| once | `boolean` | `true` | Roll in once, or on every entry. |
---
Source: https://mizzle.saddy.me/docs/components/text/echo-text.md
# Echo Text
> Type with depth. Copies of the word stack behind it, each a step further back and a shade closer to the page, cut apart by a hairline of the page colour so the stack reads as a solid extrusion. They slide out from behind the word one after another. Pure CSS.
Live demo: https://mizzle.saddy.me/docs/components/text/echo-text
## Installation
```bash
npx shadcn@latest add @mizzle/echo-text
```
## Usage
```tsx
import { EchoText } from "@/components/mizzle/text/echo-text"
Echo
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children* | `string` | - | The text. |
| depth | `number` | `12` | How many copies stand behind it. |
| angle | `number` | `225` | Which way the stack runs, in degrees. 225 is up and to the left. |
| spread | `number` | `0.06` | The step between copies, in em. |
| trigger | `"inView" \| "mount" \| "hover"` | `"inView"` | When the copies slide out. On hover they go back when the pointer leaves. |
| once | `boolean` | `true` | Slide out once, or every time it comes into view. |
---
Source: https://mizzle.saddy.me/docs/components/text/sweep-text.md
# Sweep Text
> A band of colour sweeps across the text and leaves it written behind it. Give it several lines and it moves on to the next after each sweep, the width easing to fit. The colours ride on the text itself, so it sits inside any heading.
Live demo: https://mizzle.saddy.me/docs/components/text/sweep-text
## Installation
```bash
npx shadcn@latest add @mizzle/sweep-text
```
## Usage
```tsx
import { SweepText } from "@/components/mizzle/text/sweep-text"
Built for
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| text* | `string \| string[]` | - | The text, or several to cycle through. |
| colors | `string[]` | - | The colours in the band, left to right. |
| duration | `number` | `1.5` | Seconds for one sweep. |
| delay | `number` | `0` | Seconds before each sweep starts. |
| repeat | `boolean` | `false` | Sweep again after each pass, moving on to the next text. |
| repeatDelay | `number` | `0.5` | Seconds to rest between sweeps. |
| fixedWidth | `boolean` | `false` | Hold the width of the longest text instead of easing to each one. |
| inView | `boolean` | `true` | Wait until it scrolls into view. When false it starts on mount. |
| once | `boolean` | `true` | Sweep once, or every time it comes into view. |
---
Source: https://mizzle.saddy.me/docs/components/text/ink-bleed.md
# Ink Bleed
> Words that soak into the page. The ink arrives as a soft, ragged stain and draws itself together into crisp letters, the way ink spreads into paper and settles. The filter is removed once it has landed, so the text renders as plain text.
Live demo: https://mizzle.saddy.me/docs/components/text/ink-bleed
## Installation
```bash
npx shadcn@latest add @mizzle/ink-bleed
```
## Usage
```tsx
import { InkBleed } from "@/components/mizzle/text/ink-bleed"
Words that soak into the page
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| children* | `string` | - | The text. |
| trigger | `"inView" \| "mount"` | `"inView"` | When the ink lands. |
| duration | `number` | `1.4` | Seconds it takes to settle. |
| delay | `number` | `0` | Seconds before it starts. |
| once | `boolean` | `true` | Land once, or every time it comes into view. |
---
Source: https://mizzle.saddy.me/docs/components/effects/pixel-transition.md
# Pixel Transition
> Swap what is shown through a wall of pixels. Blocks cover the old content in dither order, the way old computers dissolved between screens, the content changes behind them, and they clear the same way. No JavaScript animation.
Live demo: https://mizzle.saddy.me/docs/components/effects/pixel-transition
## Installation
```bash
npx shadcn@latest add @mizzle/pixel-transition
```
## Usage
```tsx
import { PixelTransition } from "@/components/mizzle/effects/pixel-transition"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| view* | `string` | - | Names what is shown. Changing it runs the transition. |
| pattern | `"dither" \| "sweep" \| "bloom" \| "scatter"` | `"dither"` | The order the blocks turn on in. |
| cell | `number` | `24` | The size of a block, in pixels. |
| duration | `number` | `0.5` | Seconds to cover, and again to clear. |
| color | `string` | `"var(--foreground)"` | The blocks' colour. |
---
Source: https://mizzle.saddy.me/docs/components/effects/dissolve.md
# Dissolve
> Make an element come apart and drift away, in one of five looks: smoke, dust, pixels, vapor or embers. An edge crosses it, and what it passes breaks off in the element’s own colours, drawn sharp at screen resolution, then lifts away and thins out to nothing.
Live demo: https://mizzle.saddy.me/docs/components/effects/dissolve
## Installation
```bash
npx shadcn@latest add @mizzle/dissolve
```
## Usage
```tsx
import { useDissolve } from "@/components/mizzle/effects/dissolve"
function Item({ onRemove }) {
const [ref, dissolve] = useDissolve()
return (
dissolve().then(onRemove)}>Remove
)
}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| look | `"smoke" \| "dust" \| "pixels" \| "vapor" \| "embers"` | `"smoke"` | Smoke: specks that soften into a rising haze. Dust: specks blown away on the wind. Pixels: small square tiles that stream off. Vapor: a soft blur that evaporates. Embers: a glowing edge that burns across, with sparks. |
| duration | `number` | `1100` | Milliseconds for the edge to cross the element. |
| from | `"left" \| "right" \| "top" \| "bottom"` | `"left"` | The side it starts to crumble from. |
| signal | `AbortSignal` | - | On dissolve(): stops it and puts the element back. useDissolve stops on unmount. |
---
Source: https://mizzle.saddy.me/docs/components/effects/dither.md
# Dither
> Light drawn in two colours. A slow field of light, or a photograph, rendered the way a one-bit screen would: every dot is ink or nothing, and the shades are made by how thickly the ink is scattered. The pointer is a lamp.
Live demo: https://mizzle.saddy.me/docs/components/effects/dither
## Installation
```bash
npx shadcn@latest add @mizzle/dither
```
## Usage
```tsx
import { Dither } from "@/components/mizzle/effects/dither"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src | `string` | - | An image to dither. Without one, it draws drifting light. |
| pixel | `number` | `3` | The size of one dot, in pixels. |
| density | `number` | `0.5` | How much of the field is ink, from 0 to 1. |
| speed | `number` | `1` | How fast the light drifts. 0 holds it still. |
| interactive | `boolean` | `true` | Whether the pointer acts as a light. |
---
Source: https://mizzle.saddy.me/docs/components/effects/pixel-field.md
# Pixel Field
> A field of pixels that blooms under the pointer. Inside a card or a button, small squares spread out from where the pointer came in, keep twinkling, and draw back to where it left. Costs nothing when nobody is touching it.
Live demo: https://mizzle.saddy.me/docs/components/effects/pixel-field
## Installation
```bash
npx shadcn@latest add @mizzle/pixel-field
```
## Usage
```tsx
import { PixelField } from "@/components/mizzle/effects/pixel-field"
Deploy
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| gap | `number` | `8` | The distance from one pixel to the next, in pixels. |
| size | `number` | `3` | The largest a pixel gets, in pixels. |
| speed | `number` | `1` | How fast the bloom travels and the pixels twinkle. |
| active | `boolean` | - | Hold it on or off, instead of following the parent’s hover. |
---
Source: https://mizzle.saddy.me/docs/components/effects/glow.md
# Glow
> Soft coloured light that drifts around the inside edge of an element. It follows any rounded shape, brightens and quickens with a level you give it, such as a voice or typing, and spins up and coasts to a stop instead of switching.
Live demo: https://mizzle.saddy.me/docs/components/effects/glow
## Installation
```bash
npx shadcn@latest add @mizzle/glow
```
## Usage
```tsx
import { Glow } from "@/components/mizzle/effects/glow"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| active | `boolean` | - | Hold it on or off, instead of following the parent’s hover and focus. |
| level | `number \| RefObject` | `0.6` | How strong the light is, from 0 to 1. A ref is read every frame. |
| colors | `string[]` | `["oklch(0.7 0.19 45)"]` | The lights' colours, taken in turn. |
| strength | `number` | `0.8` | The opacity of the glow at full level. |
| speed | `number` | `1` | How fast the lights travel. |
| spread | `number` | - | How far the light reaches in from the edge, in pixels. Defaults to the element’s shorter side, up to 56. |
---
Source: https://mizzle.saddy.me/docs/components/effects/progressive-blur.md
# Progressive Blur
> A blur that gets stronger towards an edge, and a scroll area that wears one at each end: the ends blur and dissolve only while there is more to scroll that way. CSS only, on any background.
Live demo: https://mizzle.saddy.me/docs/components/effects/progressive-blur
## Installation
```bash
npx shadcn@latest add @mizzle/progressive-blur
```
## Usage
```tsx
import { ProgressiveBlur, ScrollBlur } from "@/components/mizzle/effects/progressive-blur"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| position | `"top" \| "bottom" \| "left" \| "right"` | `"bottom"` | On ProgressiveBlur: the edge the blur is strongest at. |
| size | `number \| string` | `64` | How deep the band is. Pixels, or any CSS length on ProgressiveBlur. ScrollBlur defaults to 48. |
| blur | `number` | `12` | The blur at the very edge, in pixels. ScrollBlur defaults to 8. |
| layers | `number` | `5` | How many layers, 2 to 8. More is smoother, at a small cost each. |
| orientation | `"vertical" \| "horizontal"` | `"vertical"` | On ScrollBlur: which way it scrolls. |
| viewportClassName | `string` | - | On ScrollBlur: classes for the element that scrolls, such as padding. |
---
Source: https://mizzle.saddy.me/docs/components/effects/print.md
# Print
> A photograph printed the way a press prints it. The picture is split into cyan, magenta, yellow and black, and each ink is laid down as its own screen of dots at its own angle, so the dots grow, merge and leave rosettes. Edges are a little ragged, the plates sit slightly out of register, and the paper has tooth. The pointer is a loupe.
Live demo: https://mizzle.saddy.me/docs/components/effects/print
## Installation
```bash
npx shadcn@latest add @mizzle/print
```
## Usage
```tsx
import { Print } from "@/components/mizzle/effects/print"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The image. Another origin must send CORS headers, since it is read by WebGL. |
| alt | `string` | - | What the picture shows, for screen readers. |
| size | `number` | `5` | The screen: the distance between dots, in pixels. |
| registration | `number` | `0.6` | How far the plates are out of register, in pixels. |
| paper | `string` | `"#f7f5ef"` | The colour of the stock. |
| inks | `[string, string, string, string]` | `process inks` | Cyan, magenta, yellow and black, in that order. |
| interactive | `boolean` | `true` | Whether a mouse or pen holds a loupe over it. |
---
Source: https://mizzle.saddy.me/docs/components/effects/engraving.md
# Engraving
> A picture cut in lines, like a banknote portrait. Parallel lines swell where the image is dark and thin out where it is light, bending a little over its forms, and a second set crosses them in the deepest shadows. The pointer is a loupe.
Live demo: https://mizzle.saddy.me/docs/components/effects/engraving
## Installation
```bash
npx shadcn@latest add @mizzle/engraving
```
## Usage
```tsx
import { Engraving } from "@/components/mizzle/effects/engraving"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The image. Another origin must send CORS headers, since it is read by WebGL. |
| alt | `string` | - | What the picture shows, for screen readers. |
| spacing | `number` | `5` | The distance between lines, in pixels. |
| angle | `number` | `-30` | The direction of the lines, in degrees. |
| ink | `string` | `"#1f1d1b"` | The colour of the lines. |
| paper | `string` | `"#f6f3ea"` | The colour of the stock. |
| interactive | `boolean` | `true` | Whether a mouse or pen holds a loupe over it. |
---
Source: https://mizzle.saddy.me/docs/components/effects/risograph.md
# Risograph
> A photograph printed in two spot inks on a stencil duplicator. Each ink is worked out so the two together come as close to the picture as they can, then laid down as fine grain with patches where the ink ran thin. The plates sit out of register, and the pointer drags them further apart.
Live demo: https://mizzle.saddy.me/docs/components/effects/risograph
## Installation
```bash
npx shadcn@latest add @mizzle/risograph
```
## Usage
```tsx
import { Risograph } from "@/components/mizzle/effects/risograph"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The image. Another origin must send CORS headers, since it is read by WebGL. |
| alt | `string` | - | What the picture shows, for screen readers. |
| inks | `[string, string]` | `muted blue and red` | The two inks. |
| paper | `string` | `"#f4f0e6"` | The colour of the stock. |
| grain | `number` | `1.5` | The size of one grain of ink, in pixels. |
| registration | `number` | `1.5` | How far the second plate is out of register, in pixels. |
| interactive | `boolean` | `true` | Whether a mouse or pen pulls the plates apart. |
---
Source: https://mizzle.saddy.me/docs/components/effects/print-transition.md
# Print Transition
> One picture prints over another. Change the src and the new image arrives as a halftone screen: dots grow across the old one in a sweep, a bloom from the centre or a scatter, until they merge into the whole picture.
Live demo: https://mizzle.saddy.me/docs/components/effects/print-transition
## Installation
```bash
npx shadcn@latest add @mizzle/print-transition
```
## Usage
```tsx
import { PrintTransition } from "@/components/mizzle/effects/print-transition"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The image. Another origin must send CORS headers, since it is read by WebGL. |
| alt | `string` | - | What the picture shows, for screen readers. |
| pattern | `"sweep" \| "bloom" \| "scatter"` | `"sweep"` | The order the dots grow in. |
| cell | `number` | `14` | The distance between dots, in pixels. |
| duration | `number` | `1.1` | Seconds the change takes. |
---
Source: https://mizzle.saddy.me/docs/components/effects/heatmap.md
# Heatmap
> A mark read as heat, after Paper Shaders. Its outline glows hot, a slow glow spreads around it and waves of heat roll through it, coloured along a ramp from cold to hot.
Live demo: https://mizzle.saddy.me/docs/components/effects/heatmap
## Installation
```bash
npx shadcn@latest add @mizzle/heatmap
```
## Usage
```tsx
import { Heatmap } from "@/components/mizzle/effects/heatmap"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The mark: dark on a light or clear ground. Another origin must send CORS headers, since it is read by WebGL. |
| alt | `string` | - | What the mark is, for screen readers. |
| colors | `string[]` | `["#11206a", "#1f3ba2", "#2f63e7", "#6bd7ff", "#ffe679", "#ff991e", "#ff4c00"]` | The ramp from cold to hot, up to ten colours. |
| background | `string` | `"#000000"` | The colour around the heat. |
| contour | `number` | `0.5` | How hot the outline runs, from 0 to 1. |
| angle | `number` | `0` | The direction the heat waves travel, in degrees. |
| noise | `number` | `0` | Grain in the heat, from 0 to 1. |
| innerGlow | `number` | `0.5` | How strongly the inside of the mark glows, from 0 to 1. |
| outerGlow | `number` | `0.5` | How far the glow spreads around the mark, from 0 to 1. |
| scale | `number` | `0.75` | The mark's size within the frame. |
| speed | `number` | `1` | How fast the heat moves; 0 holds it still. |
---
Source: https://mizzle.saddy.me/docs/components/effects/halftone-dots.md
# Halftone Dots
> A picture screened in dots, after Paper Shaders. Each dot grows where the picture is dark, on a square or hexagonal grid, as crisp dots, soft ones, holes or gooey drops that run together, with a little grain over the paper.
Live demo: https://mizzle.saddy.me/docs/components/effects/halftone-dots
## Installation
```bash
npx shadcn@latest add @mizzle/halftone-dots
```
## Usage
```tsx
import { HalftoneDots } from "@/components/mizzle/effects/halftone-dots"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The image. Another origin must send CORS headers, since it is read by WebGL. |
| alt | `string` | - | What the picture shows, for screen readers. |
| type | `"classic" \| "gooey" \| "holes" \| "soft"` | `"gooey"` | The shape of the dots. |
| grid | `"square" \| "hex"` | `"hex"` | How the dots are laid out. |
| size | `number` | `0.5` | The size of the grid, from 0 (fine) to 1 (coarse). |
| radius | `number` | `1.25` | How large the dots grow, from 0 to 2. |
| contrast | `number` | `0.4` | How sharply light and dark part, from 0 to 1. |
| ink | `string` | `"#2b2b2b"` | The colour of the dots. |
| paper | `string` | `"#f2f1e8"` | The colour behind them. |
| originalColors | `boolean` | `false` | Whether each dot takes the picture's own colour instead of the ink. |
| inverted | `boolean` | `false` | Whether the dots grow where the picture is light. |
| grain | `number` | `0.2` | Grain that wears the dots away, from 0 to 1. |
| grainOverlay | `number` | `0.2` | Grain laid over everything, from 0 to 1. |
| grainSize | `number` | `0.5` | The size of the grain, from 0 to 1. |
| fit | `"cover" \| "contain"` | `"cover"` | How the picture fills the frame. |
| scale | `number` | `1` | The picture's size within the frame. |
---
Source: https://mizzle.saddy.me/docs/components/effects/liquid-metal.md
# Liquid Metal
> A logo or shape cast in liquid chrome. Bright and dark bands flow across it, bending around its edges and parting into a little red and blue where the light splits, as if poured.
Live demo: https://mizzle.saddy.me/docs/components/effects/liquid-metal
## Installation
```bash
npx shadcn@latest add @mizzle/liquid-metal
```
## Usage
```tsx
import { LiquidMetal } from "@/components/mizzle/effects/liquid-metal"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src | `string` | - | The logo or image it shapes: its outline becomes the metal. Another origin must send CORS headers, since it is read by WebGL. Without it, the metal takes `shape`. |
| alt | `string` | - | What the picture shows, for screen readers. |
| shape | `"diamond" \| "circle" \| "daisy" \| "metaballs" \| "none"` | `"diamond"` | The shape when there is no src; none fills the frame. |
| background | `string` | `"#aaaaac"` | The colour behind the metal. |
| tint | `string` | `"#ffffff"` | A colour burned into the metal. |
| repetition | `number` | `2` | How many bands cross it. |
| softness | `number` | `0.1` | How soft the bands' edges are, from 0 to 1. |
| shiftRed | `number` | `0.3` | How far red splits from the bands, from -1 to 1. |
| shiftBlue | `number` | `0.3` | How far blue splits from the bands, from -1 to 1. |
| distortion | `number` | `0.07` | How much the bands wobble, from 0 to 1. |
| contour | `number` | `0.4` | How strongly the bands follow the edges, from 0 to 1. |
| angle | `number` | `70` | The direction of the bands, in degrees. |
| scale | `number` | `0.6` | The shape's size within the frame. |
| speed | `number` | `1` | How fast it flows; 0 holds it still. |
---
Source: https://mizzle.saddy.me/docs/components/effects/fluted-glass.md
# Fluted Glass
> A picture seen through ribbed glass. Each flute bends the image beside it, its edges catching a highlight and a shadow, in straight lines, waves, zigzags or a woven pattern.
Live demo: https://mizzle.saddy.me/docs/components/effects/fluted-glass
## Installation
```bash
npx shadcn@latest add @mizzle/fluted-glass
```
## Usage
```tsx
import { FlutedGlass } from "@/components/mizzle/effects/fluted-glass"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The image. Another origin must send CORS headers, since it is read by WebGL. |
| alt | `string` | - | What the picture shows, for screen readers. |
| shape | `"lines" \| "irregular-lines" \| "wave" \| "zigzag" \| "pattern"` | `"lines"` | The path the flutes run. |
| profile | `"prism" \| "lens" \| "contour" \| "cascade" \| "flat"` | `"prism"` | How each flute bends the image. |
| size | `number` | `0.5` | The width of the flutes, from 0 (wide) to 1 (fine). |
| angle | `number` | `0` | The direction of the flutes, in degrees. |
| distortion | `number` | `0.5` | How strongly each flute bends the image, from 0 to 1. |
| shift | `number` | `0` | Slides the image within each flute, from -1 to 1. |
| stretch | `number` | `0` | Stretches the image along the flutes, from 0 to 1. |
| blur | `number` | `0` | Blurs the image along the flutes, from 0 to 1. |
| edges | `number` | `0.25` | How soft the picture's edge is inside the glass, from 0 to 1. |
| shadows | `number` | `0.25` | The shadow in each flute, from 0 to 1. |
| highlights | `number` | `0.1` | The highlight on each flute's edge, from 0 to 1. |
| margin | `number` | `0` | Plain picture left around the glass, as a share of the frame. |
| grain | `number` | `0` | Grain that breaks up the distortion, from 0 to 1. |
| grainOverlay | `number` | `0` | Grain laid over everything, from 0 to 1. |
| scale | `number` | `1` | The picture's size within the frame. |
| background | `string` | `"transparent"` | The colour behind the picture. |
| shadow | `string` | `"#000000"` | The colour of the shadows. |
| highlight | `string` | `"#ffffff"` | The colour of the highlights. |
---
Source: https://mizzle.saddy.me/docs/components/effects/swarm-build.md
# Swarm Build
> Build content with a swarm of small multiplayer cursors. They gather, fan out and drag an outlined box over each marked block, with a live size badge and a soft placeholder, then the block fades in and the cursors drift off. It plays once as it scrolls into view, and the content stays in the page and readable the whole time.
Live demo: https://mizzle.saddy.me/docs/components/effects/swarm-build
## Installation
```bash
npx shadcn@latest add @mizzle/swarm-build
```
## Usage
```tsx
import { SwarmBuild } from "@/components/mizzle/effects/swarm-build"
Maya Okafor
Product designer in Lisbon.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| cursors | `number` | `4` | How many cursors work at once, from 1 to 6. Each has its own colour. |
| speed | `number` | `1` | A multiplier on every duration. 2 plays twice as fast. |
| autoPlay | `boolean` | `true` | Plays once when it scrolls into view. When false it stays built until replayKey changes. |
| replayKey | `React.Key` | - | Changing it plays the build again. |
| onComplete | `() => void` | - | Called when the cursors have left. |
---
Source: https://mizzle.saddy.me/docs/components/backgrounds/silk.md
# Silk
> Light folded like cloth. A slow field of fabric is shaded from a five-colour ramp mixed in OKLab, so every fold passes through colours that belong to the palette, with a gloss along each crest. The pointer presses into it.
Live demo: https://mizzle.saddy.me/docs/components/backgrounds/silk
## Installation
```bash
npx shadcn@latest add @mizzle/silk
```
## Usage
```tsx
import { Silk } from "@/components/mizzle/backgrounds/silk"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| colors | `string[]` | `midnight blues` | Five CSS colours from the deepest fold to the gloss. Variables and oklch() work. |
| folds | `number` | `1` | How tightly the cloth is folded. Above 1 is busier. |
| sheen | `number` | `1` | How much the crests shine. 0 is matte. |
| grain | `number` | `0.4` | Film grain, from 0 to 1. |
| speed | `number` | `1` | How fast it moves. 0 holds the picture still and stops drawing until something changes. |
| interactive | `boolean` | `true` | Whether a mouse or pen moves it. A finger never does, so scrolling on a phone stays free. |
---
Source: https://mizzle.saddy.me/docs/components/backgrounds/patterns.md
# Patterns
> Soft light seen through textured glass. A body of colour rises from below, mixed from your accents and the page behind it, so it follows light and dark mode and any theme. The glass is reeded, blocked, glazed or a mosaic, and the pointer presses the light aside.
Live demo: https://mizzle.saddy.me/docs/components/backgrounds/patterns
## Installation
```bash
npx shadcn@latest add @mizzle/patterns
```
## Usage
```tsx
import { Patterns } from "@/components/mizzle/backgrounds/patterns"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| colors | `string[]` | `blue, indigo, violet` | Three accents, from the left of the light to the right. |
| pattern | `"reeds" \| "blocks" \| "glazed" \| "mosaic"` | `"reeds"` | The glass the light is seen through. |
| place | `"rise" \| "band" \| "full"` | `"rise"` | Where the light stands: rising off the bottom edge, as a band with bare page below it, or over the whole box. |
| speed | `number` | `1` | How fast it moves. 0 holds the picture still and stops drawing until something changes. |
| interactive | `boolean` | `true` | Whether a mouse or pen moves it. A finger never does, so scrolling on a phone stays free. |
---
Source: https://mizzle.saddy.me/docs/components/backgrounds/dither-field.md
# Dither Field
> A drifting field printed through an 8×8 ordered dither. Inks are mixed in OKLab from the page colour toward your accent, so it follows light and dark mode, and each cell snaps to whole device pixels so it stays crisp. The pointer is a lamp that thickens the ink.
Live demo: https://mizzle.saddy.me/docs/components/backgrounds/dither-field
## Installation
```bash
npx shadcn@latest add @mizzle/dither-field
```
## Usage
```tsx
import { DitherField } from "@/components/mizzle/backgrounds/dither-field"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| color | `string` | `muted blue` | The strongest ink. Lighter inks are mixed from it toward the page colour. |
| size | `number` | `4` | Cell size in CSS pixels, rounded to whole device pixels. |
| shape | `"square" \| "dot"` | `"square"` | How each cell is printed. |
| levels | `number` | `3` | How many inks, from 1 (two-tone) to 4. |
| speed | `number` | `1` | How fast it moves. 0 holds the picture still and stops drawing until something changes. |
| interactive | `boolean` | `true` | Whether a mouse or pen moves it. A finger never does, so scrolling on a phone stays free. |
---
Source: https://mizzle.saddy.me/docs/components/media/pixel-reveal.md
# Pixel Reveal
> An image that resolves out of big pixels. It arrives as a handful of coloured blocks and sharpens in steps, each one halving the blocks, until it is the picture. A real image sits underneath the whole time.
Live demo: https://mizzle.saddy.me/docs/components/media/pixel-reveal
## Installation
```bash
npx shadcn@latest add @mizzle/pixel-reveal
```
## Usage
```tsx
import { PixelReveal } from "@/components/mizzle/media/pixel-reveal"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The image. |
| alt* | `string` | - | What the image shows, for people who cannot see it. |
| trigger | `"inView" \| "mount" \| "hover"` | `"inView"` | When it sharpens. |
| steps | `number[]` | `[48, 24, 12, 6, 3]` | Block sizes to step through, largest first. |
| interval | `number` | `130` | Milliseconds the first step is held. Later steps are held for less. |
| aspect | `string` | `"4/3"` | The frame’s shape, as a CSS aspect ratio. |
---
Source: https://mizzle.saddy.me/docs/components/media/video-player.md
# Video Player
> A silent, looping preview that opens into a near full screen player. The player has the title and a link along the top, one row of controls along the bottom, a line you can scrub, and every key you would expect. It all gets out of the way while you watch.
Live demo: https://mizzle.saddy.me/docs/components/media/video-player
## Installation
```bash
npx shadcn@latest add @mizzle/video-player
```
## Usage
```tsx
import { VideoPlayer } from "@/components/mizzle/media/video-player"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| src* | `string` | - | The video. |
| title | `string` | - | Shown on the preview and along the top of the player. |
| link | `{ href, label, icon? }` | - | An external link in the player’s top bar. |
| tracks | `{ src, srclang, label }[]` | - | Caption files. Adds the captions button and the C key. |
| aspect | `string` | `"16/9"` | The frame’s shape, as a CSS aspect ratio. |
| poster | `string` | - | An image shown until the video plays. |
| previewSrc | `string` | - | A lighter file to loop as the preview. |
| duration | `number` | - | The length in seconds, shown on the preview. Read from the video when there is no previewSrc. |
| label | `string` | `"Play"` | What the label by the pointer says. |
---
Source: https://mizzle.saddy.me/docs/components/media/video-hero.md
# Video Hero
> A banner for a show or a launch: the episode plays behind the words, blurred to a glow that fades to black at the sides. On top sit a title, a line about it, one clear button that opens the player, and the ways to follow along.
Live demo: https://mizzle.saddy.me/docs/components/media/video-hero
## Installation
```bash
npx shadcn@latest add @mizzle/video-hero
```
## Usage
```tsx
import { VideoHero } from "@/components/mizzle/media/video-hero"
}]}
episodes={[
{
id: "01",
title: "Episode 01",
description: "On why the best teams ship less and polish more.",
src: "/episode-01.mp4",
backdropSrc: "/episode-01-loop.mp4",
date: "Oct 11, 2026",
duration: "23 min",
},
]}
className="h-[560px]"
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| episodes* | `{ id, title, description?, src, backdropSrc?, poster?, date?, duration?, aspect?, tracks?, link? }[]` | - | What can be played, in order. |
| playLabel | `string` | `"Play"` | The button’s words. |
| shortcut | `string \| false` | `"p"` | The key that opens the player. |
| follow / followLabel | `{ href, label, icon }[] / string` | - | Where else to find the show, as round icon links. |
| index / defaultIndex / onIndexChange | `number` | `0` | Which episode is showing. |
---
Source: https://mizzle.saddy.me/docs/components/scroll/reveal.md
# Reveal
> Anything that arrives as it scrolls into view: a card, a paragraph, a section. It fades, rises a little and sharpens into focus; groups go one after another from a single trigger, and nothing inside is touched. No JavaScript animation.
Live demo: https://mizzle.saddy.me/docs/components/scroll/reveal
## Installation
```bash
npx shadcn@latest add @mizzle/reveal
```
## Usage
```tsx
import { Reveal, RevealGroup } from "@/components/mizzle/scroll/reveal"
import { Card } from "@/components/mizzle/primitives/card"
Arrives when a third of it is on screen.
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| effect | `"rise" \| "fade" \| "scale" \| "blur"` | `"rise"` | How it arrives. On a group, the default for its items. |
| delay | `number` | `0` | Seconds to wait before starting. |
| duration | `number` | `0.7` | Seconds it takes. |
| stagger | `number` | `0.07` | On RevealGroup: seconds between one item and the next. |
| inView | `boolean` | `true` | Start when scrolled into view, or straight away. |
| once | `boolean` | `true` | Play once, or every time it enters the viewport. |
| amount | `number` | `0.3` | How much must be on screen first, 0 to 1. A group defaults to 0.2. |
| as | `"div" \| "section" \| "article" \| "li" \| "ul" \| "ol" \| "span"` | `"div"` | The element to render. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/dynamic-island.md
# Dynamic Island
> A pill that changes shape to fit what it is showing. Give it a view key and some content: it glides to the new size from rest, taking longer for longer trips, and dissolves what is inside. Larger views sit on a raised card surface that grows with it. No animation library.
Live demo: https://mizzle.saddy.me/docs/components/widgets/dynamic-island
## Installation
```bash
npx shadcn@latest add @mizzle/dynamic-island
```
## Usage
```tsx
import { DynamicIsland } from "@/components/mizzle/widgets/dynamic-island"
setOpen(false)}
>
{open ? : }
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| view* | `string` | - | Names what the island is showing. Changing it morphs to the new content. |
| raised | `boolean` | `false` | Puts the content on a raised card surface inside the pill, for larger views. |
| onDismiss | `() => void` | - | Called on Escape or a click outside. |
| radius | `number` | `20` | Corner radius once the island is too tall to be a pill, in pixels. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/delete-button.md
# Delete Button
> A delete button you press and hold. A solid red fill sweeps in under a feathered edge, turning the label white as it passes, while the bin’s lid opens; let go early and it runs back, hold to the end and it deletes, shows a spinner while your promise runs, then a drawn check. Holding is the confirmation, so there is no dialog.
Live demo: https://mizzle.saddy.me/docs/components/widgets/delete-button
## Installation
```bash
npx shadcn@latest add @mizzle/delete-button
```
## Usage
```tsx
import { DeleteButton } from "@/components/mizzle/widgets/delete-button"
removeProject(id)} />
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| onConfirm | `() => void \| Promise` | - | Runs once the hold completes. Return a promise to show a pending state. |
| onCancel | `() => void` | - | Runs when a hold is let go before it completes. |
| holdDuration | `number` | `900` | How long to hold, in milliseconds. |
| label | `string` | `"Delete"` | The resting label. hintLabel, pendingLabel, doneLabel and failedLabel set the others. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/tick-slider.md
# Tick Slider
> A scroll progress indicator you can scrub. A slim red needle runs along a tray of hairline ticks as the page scrolls, and dragging the needle scrolls the page. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/components/widgets/tick-slider
## Installation
```bash
npx shadcn@latest add @mizzle/tick-slider
```
## Usage
```tsx
import { TickSlider } from "@/components/mizzle/widgets/tick-slider"
import { useScrollProgress } from "@/hooks/use-scroll-progress"
const [progress, scrollTo] = useScrollProgress()
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| value | `number` | - | The value, when you control it. defaultValue otherwise. |
| onValueChange | `(value: number) => void` | - | Called as the value changes. |
| min / max / step | `number` | `0 / 1 / 0.01` | The range, and the smallest change a drag or an arrow key makes. |
| ticks | `number` | `66` | How many ticks are drawn. |
| majorEvery | `number` | `5` | Every nth tick is brighter. |
| color | `string` | `"#ff4b4b"` | The needle’s colour. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/expandable-tabs.md
# Expandable Tabs
> An icon bar whose active tab says its name, and whose page grows out of the bar. The label, the highlight and the shell move as one, on one clock. No animation library.
Live demo: https://mizzle.saddy.me/docs/components/widgets/expandable-tabs
## Installation
```bash
npx shadcn@latest add @mizzle/expandable-tabs
```
## Usage
```tsx
import { ExpandableTabs } from "@/components/mizzle/widgets/expandable-tabs"
, content: },
{ id: "tasks", label: "Tasks", icon: , content: },
]}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| items* | `{ id, label, icon, content?, disabled? }[]` | - | The tabs. Leave content out to only widen the tab. |
| value | `string \| null` | - | The active tab, or null for the closed bar. defaultValue otherwise. |
| onValueChange | `(value: string \| null) => void` | - | Called when a tab opens or the bar closes. |
| collapsible | `boolean` | `true` | Whether the active tab, Escape and a click outside fold it back. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/panel-menu.md
# Panel Menu
> A menu built from stacked glass panels. Closed, it is a single bar. Open, the label flips, a tall body wipes down beneath it, and the link and language rows settle in after. Built on Base UI, animated in CSS.
Live demo: https://mizzle.saddy.me/docs/components/widgets/panel-menu
## Installation
```bash
npx shadcn@latest add @mizzle/panel-menu
```
## Usage
```tsx
import { PanelMenu } from "@/components/mizzle/widgets/panel-menu"
}
links={[{ label: "Tickets", href: "/tickets" }, { label: "Contact", href: "/contact" }]}
locales={["EN", "KO", "ES"]}
>
…
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| logo | `ReactNode` | - | The mark at the left of the bar. |
| links | `{ label: string; href: string }[]` | - | Small links in the row under the body. |
| locales | `string[]` | - | Language codes in the last row. Use locale and onLocaleChange to control it. |
| open | `boolean` | - | Whether it is open, when you control it. defaultOpen and onOpenChange as usual. |
| bodyHeight | `string` | `"min(58vh, 520px)"` | The body panel’s height while open. |
| accent | `string` | - | The active language’s text colour. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/prediction-market.md
# Prediction Market
> An order ticket for a yes or no market. Pick an outcome and a side, type an amount, and the shares, the payout and the return roll to their new values. Built from the card, the tabs, the button and the rolling numbers.
Live demo: https://mizzle.saddy.me/docs/components/widgets/prediction-market
## Installation
```bash
npx shadcn@latest add @mizzle/prediction-market
```
## Usage
```tsx
import { PredictionMarket } from "@/components/mizzle/widgets/prediction-market"
placeOrder(order)}
/>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| outcomes | `{ id, label, price, color?, history? }[]` | - | The outcomes. price is 0 to 1; history draws the chart and the change. |
| balance | `number` | `0` | Cash available for buying. |
| positions | `Record` | - | Shares held per outcome id, available for selling. |
| quickAmounts | `number[]` | `[10, 50, 100]` | Steps offered under the field. |
| onTrade | `(order) => void \| Promise` | - | Receives the order. Return a promise for a pending state. |
| currency / locale | `string` | `"USD" / "en-US"` | How money is written. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/stamp.md
# Stamp
> A rubber stamp for a decision: approved, paid, sent. The ink is worn in places, the frame is doubled, and it lands with a short press, from a little above and out of focus, without a bounce.
Live demo: https://mizzle.saddy.me/docs/components/widgets/stamp
## Installation
```bash
npx shadcn@latest add @mizzle/stamp
```
## Usage
```tsx
import { Stamp } from "@/components/mizzle/widgets/stamp"
Paid
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| stamped | `boolean` | `true` | Whether it is on the page. |
| color | `string` | `muted red` | The colour of the ink. |
| angle | `number` | `-8` | How crooked it lands, in degrees. |
| shape | `"rect" \| "round"` | `"rect"` | A box or a seal. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/sound.md
# Sound
> Every interface sound from @inklu/audio on one board, grouped by what it is for: press a name to hear it. The board plays in one of three themes, default, soft or mechanical. The sounds are synthesized, so there are no audio files to host.
Live demo: https://mizzle.saddy.me/docs/components/widgets/sound
## Installation
```bash
npx shadcn@latest add @mizzle/sound
```
## Usage
```tsx
import { Sound } from "@/components/mizzle/widgets/sound"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| theme | `"default" \| "soft" \| "mechanical"` | `"default"` | What the sounds are made of: crisp sine strikes, felt on wood, or switches and latches. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/like-button.md
# Like Button
> A heart that fills, dips and springs back when liked, throwing a spray of dots that lands differently every time, while the count rolls up. Unliking drains it quietly.
Live demo: https://mizzle.saddy.me/docs/components/widgets/like-button
## Installation
```bash
npx shadcn@latest add @mizzle/like-button
```
## Usage
```tsx
import { LikeButton } from "@/components/mizzle/widgets/like-button"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| count | `number` | - | The likes before this one. It rolls up by one when liked. |
| label | `string` | - | Text after the heart. |
| defaultLiked | `boolean` | `false` | Start liked. |
| liked | `boolean` | - | Whether it is liked, when you control it. |
| onLikedChange | `(liked: boolean) => void` | - | Called when it is liked or unliked. |
---
Source: https://mizzle.saddy.me/docs/components/widgets/copy-button.md
# Copy Button
> A button that copies a value to the clipboard. The copy icon swaps to a check with a quick blur and scale, a small Copied label rises above it and leaves, and it resets after a moment and tells screen readers. Pressing again restarts it. A failed copy shows nothing.
Live demo: https://mizzle.saddy.me/docs/components/widgets/copy-button
## Installation
```bash
npx shadcn@latest add @mizzle/copy-button
```
## Usage
```tsx
import { CopyButton } from "@/components/mizzle/widgets/copy-button"
Copy
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| value* | `string` | - | The text to copy. |
| onCopy | `(value: string) => void` | - | Called after the value is copied. |
| label | `string` | - | The accessible name. Defaults to Copy when the button has no text. |
| copiedLabel | `string` | `"Copied"` | The text of the label that rises above the button. |
| children | `ReactNode` | - | Visible text beside the icon. |
---
Source: https://mizzle.saddy.me/docs/components/illustrations/integrations-diagram.md
# Integrations
> Your app in the middle and four services around it, joined by routes with small ports. An event comes in along one route, the app lights up, and the answer goes out along the others. Put your own marks on the tiles.
Live demo: https://mizzle.saddy.me/docs/components/illustrations/integrations-diagram
## Installation
```bash
npx shadcn@latest add @mizzle/integrations-diagram
```
## Usage
```tsx
import { IntegrationsDiagram } from "@/components/mizzle/illustrations/integrations-diagram"
, , , ]}
>
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| services | `ReactNode[]` | - | Up to four marks for the tiles around the app. Defaults to a database, mail, a card and a chart. |
| children | `ReactNode` | - | The mark on the middle tile. Defaults to an app window. |
| accent | `string` | - | The one colour: signals, lit tiles and blinking ports. Any CSS colour, or set --diagram-accent from a class. |
| glyphs | `"solid" \| "line"` | `"solid"` | Which set the default marks are drawn in. |
| duration | `number` | - | Seconds one loop takes. |
| animated | `boolean` | `true` | Run the loop, or hold the still drawing. |
---
Source: https://mizzle.saddy.me/docs/components/illustrations/auth-diagram.md
# Authentication
> Three ways to sign in on the left, one check in the middle, your app on the right. Each turn a different method sends a signal, the lock becomes a tick that draws itself, and the app opens.
Live demo: https://mizzle.saddy.me/docs/components/illustrations/auth-diagram
## Installation
```bash
npx shadcn@latest add @mizzle/auth-diagram
```
## Usage
```tsx
import { AuthDiagram } from "@/components/mizzle/illustrations/auth-diagram"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| accent | `string` | - | The one colour: signals, lit tiles and blinking ports. Any CSS colour, or set --diagram-accent from a class. |
| glyphs | `"solid" \| "line"` | `"solid"` | Which set the default marks are drawn in. |
| duration | `number` | - | Seconds one loop takes. |
| animated | `boolean` | `true` | Run the loop, or hold the still drawing. |
---
Source: https://mizzle.saddy.me/docs/components/illustrations/payments-diagram.md
# Payments
> A card is charged, the payment clears, and three things follow: the money goes to the bank, a receipt goes out and your app is told. The coin turns into a tick while it all happens.
Live demo: https://mizzle.saddy.me/docs/components/illustrations/payments-diagram
## Installation
```bash
npx shadcn@latest add @mizzle/payments-diagram
```
## Usage
```tsx
import { PaymentsDiagram } from "@/components/mizzle/illustrations/payments-diagram"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| accent | `string` | - | The one colour: signals, lit tiles and blinking ports. Any CSS colour, or set --diagram-accent from a class. |
| glyphs | `"solid" \| "line"` | `"solid"` | Which set the default marks are drawn in. |
| duration | `number` | - | Seconds one loop takes. |
| animated | `boolean` | `true` | Run the loop, or hold the still drawing. |
---
Source: https://mizzle.saddy.me/docs/components/illustrations/diagram.md
# Diagram
> The parts the illustrations are made from: tiles, routes with ports, and a signal that travels them, all on one clock. Lay out your own in a few lines, with the glyph set or any icons you already use.
Live demo: https://mizzle.saddy.me/docs/components/illustrations/diagram
## Installation
```bash
npx shadcn@latest add @mizzle/diagram
```
## Usage
```tsx
import { Diagram, DiagramNode, DiagramRoute } from "@/components/mizzle/illustrations/diagram"
import { AppGlyph, BoltGlyph, CloudGlyph } from "@/components/mizzle/illustrations/diagram-glyphs"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| width / height | `number` | `400 / 300` | On Diagram: the size of the drawing, in units. |
| duration | `number` | `6` | On Diagram: seconds one loop takes. |
| animated | `boolean` | `true` | On Diagram: run the loop, or hold the still drawing. |
| accent | `string` | - | On Diagram: the one colour. Defaults to a blue, lighter in dark mode. |
| glyphs | `"solid" \| "line"` | `"solid"` | On Diagram: the style the glyph set draws in. Icons of your own are not affected. |
| x / y* | `number` | - | On DiagramNode: the centre of the tile. |
| size | `number` | `52` | On DiagramNode: the side of the tile. width and height set them apart. |
| icon | `number` | - | On DiagramNode: the size the glyph is drawn at. 28 by default, 40 on a tile of 68 units or more. |
| at | `number \| number[]` | - | On DiagramNode: when it lights. On DiagramRoute: when its signal leaves. Seconds into the loop. |
| hold | `number` | `1.4` | On DiagramNode: seconds it stays lit. |
| lit | `ReactNode` | - | On DiagramNode: shown in place of its children while it is lit. |
| points* | `[x, y][]` | - | On DiagramRoute: where it starts, turns and ends. |
| span | `number` | - | On DiagramRoute: seconds the signal takes. Defaults to 0.45 plus a second for every 220 units. |
| dashed | `boolean` | `false` | On DiagramRoute: a dashed line. |
| ports | `"both" \| "start" \| "end" \| "none"` | `"both"` | On DiagramRoute: which ends get a port. |
| radius | `number` | - | On DiagramNode: the corner of the tile, 22% of its side by default. On DiagramRoute: the curve of each turn, 8 by default. |
---
Source: https://mizzle.saddy.me/docs/components/illustrations/bot-face.md
# Bot Face
> Two eyes on a coloured panel. They drift, glance around, blink now and then, follow the pointer, and squish and wink when clicked. Runs only while on screen.
Live demo: https://mizzle.saddy.me/docs/components/illustrations/bot-face
## Installation
```bash
npx shadcn@latest add @mizzle/bot-face
```
## Usage
```tsx
import { BotFace } from "@/components/mizzle/illustrations/bot-face"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| color | `"blue" \| "orange"` | `"blue"` | The panel: blue to cyan, or red to orange. |
| background | `boolean` | `true` | Fill the box with the panel, or put the eyes on your own background in the text colour. |
| followPointer | `boolean` | `true` | The eyes follow the pointer while it is over the face. |
| label | `string` | - | What a screen reader says. |
---
Source: https://mizzle.saddy.me/docs/components/illustrations/folder.md
# Folder
> A blue folder standing upright, three dark sheets standing out of it behind a frosted front pocket. On hover the pocket tips forward and each sheet rises and fans out on its own.
Live demo: https://mizzle.saddy.me/docs/components/illustrations/folder
## Installation
```bash
npx shadcn@latest add @mizzle/folder
```
## Usage
```tsx
import { Folder } from "@/components/mizzle/illustrations/folder"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| label | `string` | - | What a screen reader says. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-app.md
# App
> An app window with a sidebar and three panels. The panels lift off toward you in layers, then settle back.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-app
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-app
```
## Usage
```tsx
import { IsometricApp } from "@/components/mizzle/isometrics/isometric-app"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"sky"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"App"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-chart.md
# Chart
> A bar chart on a plate. The bars grow to new values one after another while the trend line rides their tops.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-chart
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-chart
```
## Usage
```tsx
import { IsometricChart } from "@/components/mizzle/isometrics/isometric-chart"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"sage"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Chart"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-server.md
# Server
> Three rack units in a stack. Lights chase up the stack while the middle unit slides out on its rails and back.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-server
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-server
```
## Usage
```tsx
import { IsometricServer } from "@/components/mizzle/isometrics/isometric-server"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"sage"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Server"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-database.md
# Database
> Three disks stacked into a database. They part, their lights go round once and a ring pulses off the top before they settle.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-database
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-database
```
## Usage
```tsx
import { IsometricDatabase } from "@/components/mizzle/isometrics/isometric-database"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"iris"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Database"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-cloud.md
# Cloud
> A cloud of three lobes on a flat base. Three dashes rise from below into it, one after another.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-cloud
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-cloud
```
## Usage
```tsx
import { IsometricCloud } from "@/components/mizzle/isometrics/isometric-cloud"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"sky"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Cloud"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-workflow.md
# Workflow
> Three steps on a plate, joined by routes with ports. A packet runs from step to step, and each lights as it arrives.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-workflow
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-workflow
```
## Usage
```tsx
import { IsometricWorkflow } from "@/components/mizzle/isometrics/isometric-workflow"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"iris"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Workflow"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-chip.md
# Chip
> A processor with four pins a side. A light runs round the pins, then the die lifts and lights.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-chip
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-chip
```
## Usage
```tsx
import { IsometricChip } from "@/components/mizzle/isometrics/isometric-chip"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"iris"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Chip"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-shield.md
# Shield
> A shield with a raised face and a check. It lifts while the check clears and draws itself again.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-shield
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-shield
```
## Usage
```tsx
import { IsometricShield } from "@/components/mizzle/isometrics/isometric-shield"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"sage"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Shield"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-padlock.md
# Padlock
> A padlock with a keyhole and a shackle. The key turns, the shackle pops up and swings open, then it closes and locks.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-padlock
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-padlock
```
## Usage
```tsx
import { IsometricPadlock } from "@/components/mizzle/isometrics/isometric-padlock"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"iris"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Padlock"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-key.md
# Key
> A key lying flat. It lifts, turns a quarter as if in a lock, turns back and sets down.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-key
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-key
```
## Usage
```tsx
import { IsometricKey } from "@/components/mizzle/isometrics/isometric-key"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"butter"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Key"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-card.md
# Card
> Two payment cards, one on the other. The top card lifts and tilts as if tapped while its contactless mark pulses.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-card
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-card
```
## Usage
```tsx
import { IsometricCard } from "@/components/mizzle/isometrics/isometric-card"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"clay"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Card"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-bolt.md
# Bolt
> A lightning bolt raised on a rounded tile. It lifts off the tile while a ring spreads beneath it, then settles.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-bolt
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-bolt
```
## Usage
```tsx
import { IsometricBolt } from "@/components/mizzle/isometrics/isometric-bolt"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"butter"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Bolt"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-gears.md
# Gears
> Two meshed gears lying flat. The large one turns three teeth and the small one follows the other way.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-gears
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-gears
```
## Usage
```tsx
import { IsometricGears } from "@/components/mizzle/isometrics/isometric-gears"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"ash"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Gears"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-toggle.md
# Toggle
> A switch on a plate. The knob slides across, the track lights, and it slides back off.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-toggle
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-toggle
```
## Usage
```tsx
import { IsometricToggle } from "@/components/mizzle/isometrics/isometric-toggle"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"sky"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "standing"` | `"drawn"` | Standing stands it upright, its face toward you. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Toggle"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-laptop.md
# Laptop
> An open laptop with code on its screen. The code backspaces away and types back in, the cursor holding while it types.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-laptop
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-laptop
```
## Usage
```tsx
import { IsometricLaptop } from "@/components/mizzle/isometrics/isometric-laptop"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"bone"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Laptop"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-phone.md
# Phone
> A phone with a notification above a grid of apps. The notification rises away and a new one drops in.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-phone
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-phone
```
## Usage
```tsx
import { IsometricPhone } from "@/components/mizzle/isometrics/isometric-phone"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"rose"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Phone"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-envelope.md
# Envelope
> An envelope on its edge, flap and seal facing you. The flap swings up and back, and a letter rises out and sinks again.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-envelope
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-envelope
```
## Usage
```tsx
import { IsometricEnvelope } from "@/components/mizzle/isometrics/isometric-envelope"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"clay"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Envelope"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-folder.md
# Folder
> A file folder with three sheets inside. The cover tips open and the sheets rise one after another, then settle.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-folder
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-folder
```
## Usage
```tsx
import { IsometricFolder } from "@/components/mizzle/isometrics/isometric-folder"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"butter"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Folder"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-speaker.md
# Speaker
> A speaker cabinet with a woofer and a tweeter. Three beats push the cone out, each sending an arc from both sides.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-speaker
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-speaker
```
## Usage
```tsx
import { IsometricSpeaker } from "@/components/mizzle/isometrics/isometric-speaker"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"rose"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Speaker"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-camera.md
# Camera
> A camera with a zoom lens, a dial and a flash. It zooms out, focuses, blinks its timer twice, fires and zooms back in.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-camera
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-camera
```
## Usage
```tsx
import { IsometricCamera } from "@/components/mizzle/isometrics/isometric-camera"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"rose"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Camera"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/components/isometrics/isometric-stopwatch.md
# Stopwatch
> A stopwatch with a small dial for minutes. The crown starts it, the hand sweeps two turns, and the crown stops it.
Live demo: https://mizzle.saddy.me/docs/components/isometrics/isometric-stopwatch
## Installation
```bash
npx shadcn@latest add @mizzle/isometric-stopwatch
```
## Usage
```tsx
import { IsometricStopwatch } from "@/components/mizzle/isometrics/isometric-stopwatch"
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| ink | `"bone" \| "ash" \| "clay" \| "rose" \| "butter" \| "sage" \| "sky" \| "iris"` | `"clay"` | The line colour. Bone is the text colour; the rest are soft on dark and deepened on light. |
| line | `"full" \| "soft" \| "faint"` | `"full"` | How strong the line is: the ink, or softer and fainter. |
| facing | `"right" \| "left"` | `"right"` | Which way it faces. Left mirrors it. |
| pose | `"drawn" \| "lying"` | `"drawn"` | Lying lays it on its back, its top pointing away. |
| turned | `boolean` | `false` | Turns it toward you by about 23°, so its front shows more. |
| surface | `string` | - | The colour behind it. Faces are filled with it, so lines behind them stay hidden. Any CSS colour, or set --iso-base from a class. Defaults to the background. |
| active | `boolean` | - | Plays the animation each time it turns true. Left unset, it plays when its parent is hovered or focused. |
| label | `string` | `"Stopwatch"` | What screen readers announce. An empty string hides it from them. |
---
Source: https://mizzle.saddy.me/docs/blocks/ai.md
# AI
> A complete AI conversation, built from eighteen of the AI pieces working as one. Each turn is a prompt and a reply, the rail at the edge lists the questions asked so far and jumps back to any of them, the tray above the input is whatever needs you now, and the orb at the top is the agent’s presence. Answer its question by picking or by typing, start its plan or say what to change, watch the tasks tick off, then ask for the cover image, attach a file, record a voice note, or stop it halfway. Install it as one piece and swap the scripted agent for your own.
Live demo: https://mizzle.saddy.me/blocks/ai
## Installation
```bash
npx shadcn@latest add @mizzle/agent-demo
```
---
Source: https://mizzle.saddy.me/docs/blocks/chat.md
# Chat
> A group conversation, built from the nine chat pieces working as one. Messages from the same person run together under one name, a reply quotes what it answers, reactions sit on a bubble’s edge, a voice note plays in place and a poll fills as people vote. Days and unread messages are marked, someone joining gets a quiet line, and the composer sends text or a recording and shows it arriving, read and answered. Install it as one piece and wire the thread to your own messages.
Live demo: https://mizzle.saddy.me/blocks/chat
## Installation
```bash
npx shadcn@latest add @mizzle/chat-demo
```
---
Source: https://mizzle.saddy.me/docs/blocks/data-grid.md
# Data Grid
> A spreadsheet-style table on TanStack Table, assembled from the data pieces: toolbar with search and column picker, typed filters, the grid, a selection bar and a pager. Sort, pin, resize, reorder and hide columns from each header; select rows or drag out a range of cells and copy it; edit in place and save or discard the batch. Only the rows on screen are in the page, so three hundred rows cost the same as thirty.
Live demo: https://mizzle.saddy.me/blocks/data-grid
## Installation
```bash
npx shadcn@latest add @mizzle/data-grid
```
## Usage
```tsx
import { createColumnHelper } from "@tanstack/react-table"
import { DataGrid, useDataGrid } from "@/components/mizzle/data/data-grid"
import type { DataGridFeatures } from "@/utils/data-grid-features"
const helper = createColumnHelper()
const columns = helper.columns([
helper.accessor("id", { header: "Invoice", size: 120 }),
helper.accessor("customer", { header: "Customer", size: 200 }),
helper.accessor("amount", {
header: "Amount",
size: 120,
meta: { align: "end" },
}),
])
export function Invoices({ invoices }: { invoices: Invoice[] }) {
const table = useDataGrid({
columns,
data: invoices,
getRowId: (row) => row.id,
})
return
}
```
## Props
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| table* | `DataGridTable` | - | The table from useDataGrid. |
| rowHeight | `number` | `40` | Height of every body row, in pixels. |
| reorderable | `boolean` | `true` | Show the grip that drags a column to a new place. |
| onCellChange | `({ rowId, columnId, value, row }) => void` | - | Called when an edit is committed with a new value. |
| isCellDirty | `(rowId, columnId) => boolean` | - | Marks cells that hold an unsaved edit. |
| empty | `ReactNode` | `"No results"` | Shown under the header when there are no rows. |
| overscan | `number` | `8` | Rows kept mounted beyond each edge of the viewport. |
| children | `ReactNode` | - | Laid over the grid, which is where DataGridSelectionBar goes. |
| meta.align | `"start" \| "end"` | - | Column meta. End-align numbers and dates. |
| meta.editable / meta.editor | `boolean / "text" \| "number"` | - | Column meta. Allow editing, and which keypad it asks for. |
| meta.utility | `boolean` | - | Column meta. A column of controls: no menu, selection, resizing or export. |
| meta.locked / meta.label | `boolean / string` | - | Column meta. Keep a column from being dragged; name one whose header is not text. |