Primitive / Atomstable
Status Dot
Colored status indicator with optional label and pulse state.
@glinui/uiComponent: status-dot
Installation
Install from the package for shared ownership or from the registry for copy-paste control.
Package Manager
pnpm add @glinui/ui @glinui/tokensRegistry
pnpm dlx @glinui/cli@latest add status-dotUsage
HealthyDegradedDown
TSX
1import { StatusDot } from "@glinui/ui"23export function Demo() {4 return (5 <div className="space-y-2">6 <StatusDot status="success" label="Healthy" />7 <StatusDot status="warning" label="Degraded" />8 <StatusDot status="danger" label="Down" pulse />9 </div>10 )11}
Accessibility
- Pair status color with text for non-color-only communication.
- Optional pulse animation is reduced-motion safe.
ARIA Attributes
- `aria-live="polite"` when representing dynamic system state
Reduced Motion
Pulse animation uses `motion-safe` and disables with reduced-motion preferences.
Affected properties
opacityAPI Reference
| Prop | Type | Required | Default | Description |
|---|---|---|---|---|
status | "neutral" | "info" | "success" | "warning" | "danger" | No | neutral | Dot color semantic. |
size | "sm" | "md" | "lg" | No | md | Dot and label size scale. |
pulse | "true" | "false" | No | false | Enable subtle pulse animation on the indicator. |
label | string | No | - | Optional status label text. |
Source
Import directly from the package or browse the source on GitHub. Click any file to view it.
Generated API Snapshot
Beta
Generated API Snapshot
BetaAuto-extracted from TypeScript source in packages/ui/src/components/status-dot.tsx. This section is in beta and may lag behind hand-curated docs. Regenerate with pnpm --filter @glinui/docs api:generate.
Generated: 2026-02-19T17:59:28.468Z · Full index: /docs/api-metadata
Primary Props Type
StatusDotProps
StatusDotProps
| Prop | Type | Required | Default | Description |
|---|---|---|---|---|
label | string | No | - | - |
pulse | "true" | "false" | No | false | Variant option from dotVariants. |
size | "sm" | "md" | "lg" | No | "md" | Variant option from statusDotVariants. |
status | "neutral" | "info" | "success" | "warning" | "danger" | No | "neutral" | Variant option from dotVariants. |