Status Dot

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/tokens

Registry

pnpm dlx @glinui/cli@latest add status-dot

Usage

HealthyDegradedDown
TSX
1import { StatusDot } from "@glinui/ui"
2
3export 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

opacity

API Reference

PropTypeRequiredDefaultDescription
status"neutral" | "info" | "success" | "warning" | "danger"NoneutralDot color semantic.
size"sm" | "md" | "lg"NomdDot and label size scale.
pulse"true" | "false"NofalseEnable subtle pulse animation on the indicator.
labelstringNo-Optional status label text.

Source

Import directly from the package or browse the source on GitHub. Click any file to view it.

Import

import { StatusDot } from "@glinui/ui"

Source Files

Dependencies

@glinui/ui

Generated API Snapshot

Beta

Auto-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

PropTypeRequiredDefaultDescription
labelstringNo--
pulse"true" | "false"NofalseVariant 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.