Skip to content

shadcn.io is an independent project built on shadcn/ui

Free

Command with Status Indicators for React

An open command menu of four services, each with a colored dot and a state such as Running, Warning, or Stopped.

The menu is already open under Services. API Server and Database say Running, Cache Server says Warning, and Queue Worker says Stopped. Each row starts with a colored dot.

Show the word with the color so the state is not color alone. A Status is enough when the dot sits on the page, not in a menu. In React, Base UI does not run the item.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.

Anatomy

Command anatomy: root, input, group label, list, item, shortcut

Usage

<Command className="h-auto w-full max-w-lg rounded-lg border shadow-md">
  <CommandInput placeholder="Search services..." />
  <CommandList>
    <CommandEmpty>No services found.</CommandEmpty>
    <CommandGroup heading="Services">
      {items.map((item) => (
        <CommandItem key={item.value}>
          <span
            aria-hidden="true"
            className={cn("size-3 shrink-0 rounded-full", item.dot)}
          />
          <span className="flex-1">{item.label}</span>
          <span className="text-muted-foreground text-xs">{item.status}</span>
        </CommandItem>
      ))}
    </CommandGroup>
  </CommandList>
</Command>

FAQ

How is this menu placed on the page?

Command has h-auto w-full max-w-lg rounded-lg border shadow-md: it sits in the page flow, up to a max width, with a border and a shadow. The list is always open and there is no trigger.

How is the colored status dot built?

Each dot is a span with size-3 shrink-0 rounded-full and a theme color: bg-success for API Server and Database, bg-warning for Cache Server, and bg-destructive for Queue Worker. It's hidden from screen readers, because the state is written out beside it.

Where does Running or Stopped go?

The service name's span has flex-1, which pushes the state to the end of the row. The state is a span with text-muted-foreground text-xs that reads Running, Warning or Stopped.

What appears when nothing matches the search?

CommandEmpty in the list says "No services found." It shows only when the search leaves nothing.

How do I run an item from this menu in React?

These items don't run anything yet. Pass onSelect to each CommandItem.

How do the keys work in this menu?

The arrow keys move through the items, Enter runs the highlighted one, and typing filters the list. CommandInput shows "Search services..." until someone types. Command filters and ranks the items by their text on its own.

API Reference

Command

Sets placeholder="Search services..." and heading="Services". The rest is on the Command page.