Skip to content
VenusUI
Get started

Status Dot

A colored status indicator with a label and an optional live pulse.

Preview

Installation

npx shadcn@latest add @venusui/status-dot

Run this in a project set up with shadcn. If you haven’t set it up yet, run npx shadcn@latest init first.

Files added to your project

Paths use the default shadcn aliases. The CLI follows the aliases in your components.json.

  • @/components/ui/status-dot.tsx

Usage

The code behind the preview above.

status-dot-demo.tsx

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

export default function StatusDotDemo() {
  return (
    <div className="flex flex-wrap items-center gap-5">
      <StatusDot status="online" pulse />
      <StatusDot status="away" />
      <StatusDot status="busy" />
      <StatusDot status="offline" />
    </div>
  )
}

API reference

PropTypeDefaultDescription
status"online" | "busy" | "away" | "offline"—Status to show. Required.
labelstring | falsestatus nameVisible text; false keeps it for screen readers only.
pulsebooleanfalsePulse the dot.

All <span> props except children.

Requirements

  • Tailwind CSS v4. Works in Server Components.

Customization

  • Add statuses by extending the STATUS map.

Accessibility

  • Always has text, so status never relies on color alone. The pulse stops with reduced motion.

Troubleshooting

No pulse.
It uses Tailwind’s built-in animate-ping; check reduced motion isn’t on.
Unknown registry "@venusui"
Your shadcn CLI couldn’t find the namespace in the shadcn registry index. Use the latest CLI (npx shadcn@latest), install by URL, or register it with its address: npx shadcn@latest registry add @venusui=https://venusui.com/r/{name}.json.
No components.json found
Run npx shadcn@latest init in your project first.
Loading preview

Analog Clock

Data display

A station clock whose needle waits at twelve; drag the minute hand to set it by hand.

Loading preview

Avatar Stack

Data display

Overlapping avatars with a +N counter that spread apart on hover.

Loading preview

Bookshelf

Interactive

Books on a wooden shelf whose spines lift on hover and pull out when selected, with a matching cover.