videorc/ui

Status Dot

Ambient status. The glass dot in its tone, pulsing while something runs, beside a quiet label. It replaces a loud header badge.

RecordingReadyReconnectingEncoder stoppedIdle

Installation

$ pnpm dlx shadcn@latest add @videorc/status-dot

It brings Status word with it.

Usage

import { StatusDot } from "@/components/status-dot";
<StatusDot label="Recording" pulse tone="live" />

It takes the same tones as Status Badge: live is recording and on air, error a failure. The label is a word in sentence case, already mapped from its state; a raw value throws under test.

Use it for ambient state in a header, a status bar or a row's meta. Use a Status Badge when the state needs a chip of its own.

Examples

In a header

The dot sits beside a window's or a pane's title and says what it's doing, without competing with the title.

Captions readerListening

Theming

Token or attributeMeaning
glass-dotThe 6 px dot with its halo and glow
motion-safe:animate-pingThe pulse; reduced motion stills it
tone-*The tone, through --chip-tone
data-tonegood, warn, error, live or neutral

Accessibility

Only the label is read; the dot is decoration. A dot with no label says nothing to a screen reader, so give the state a word somewhere nearby.

API reference

Prop

Type