Ballmac UI home

Status Dot

A compact status indicator that always pairs its color with a visible label.

Workspace syncAll systems online

Installation

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

Usage

import { StatusDot } from "@/components/ballmac/status-dot"

The full example is in the Code tab above.

Examples

States and variants

AvailableIn a meetingAwayOffline

API reference

PropTypeDefault
label*

Visible status text; color is never the only cue.

string—
status

Semantic status tone.

"online" | "busy" | "away" | "offline""online"
pulse

Gently pulse active statuses; stops for reduced motion.

booleanfalse
announce

Announce a changed status to assistive technology.

booleanfalse

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
NoneStatus is expressed in visible text

Use with AI

A compact status indicator that always pairs its color with a visible label. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Status Dot (@ballmac/status-dot) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Show presence or service state
  • Label a live operational status

Not for

  • Use badge for category labels

Registry JSON: https://ui.ballmac.com/r/status-dot.json

Credits

Free to use in personal and commercial projects.

npm
None
Registry
shadcn/utils