Components / feedback

StatusDot

Live Status Indicator - Square Instrument Dot, Tracked Label

01 Preview

02 Usage

Small status indicator - a square instrument dot in a semantic tone with an optional uppercase micro-label; set live to blink it as an active signal.

<StatusDot tone="accent" live>Live</StatusDot>
<StatusDot tone="ok">Operational</StatusDot>
<StatusDot tone="err">Offline</StatusDot>
<StatusDot tone="info" />

Tones: accent | ok | warn | err | info. The dot is decorative; the label carries the meaning, so give live/critical states a label. live freezes to a steady dot under reduced-motion. Keep labels to one or two words.

03 Props

PropTypeDefaultNotes
tone 'accent' | 'ok' | 'warn' | 'err' | 'info' accent Dot colour.
live boolean false Blink the dot to read as a live signal. Uses the `.ddk-blink` motion utility, which the OS "reduce motion" setting freezes to a steady dot.
children React.ReactNode Optional uppercase micro-label. Omit for a bare dot.

Also accepts every attribute of React.HTMLAttributes<HTMLSpanElement> — they are spread onto the root element. className is merged, not replaced, and ref is forwarded.

04 Import

import { StatusDot } from '@denizarsan/darsan.design';
import '@denizarsan/darsan.design/styles.css';