Command

Import

import {
  Command,
  CommandDialog,
  CommandEmpty,
  CommandGroup,
  CommandInput,
  CommandItem,
  CommandList,
  CommandSeparator,
  CommandShortcut,
} from "@timelycare/helix-ui"

Props

interface CommandProps {
  className?: string
  children: React.ReactNode
}

interface CommandInputProps {
  placeholder?: string
  value?: string
  onValueChange?: (value: string) => void
  className?: string
}

interface CommandItemProps {
  value?: string
  disabled?: boolean
  onSelect?: () => void
  className?: string
  children: React.ReactNode
}

interface CommandGroupProps {
  heading?: string
  className?: string
  children: React.ReactNode
}

Variants

Item Types

Styling

Container

Command Input

Command Group

Group Heading

Command Item

Command Shortcut

Command Separator

Command Empty

States

Icons

Item Icon Size: size-4 (16×16px) with text-muted-foreground

Check Icon Size: size-4 (16×16px)

Common Patterns

Basic Command Menu

<Command className="rounded-md border shadow-md">
  <CommandInput placeholder="Type a command or search..." />
  <CommandList>
    <CommandEmpty>No results found.</CommandEmpty>
    <CommandGroup heading="Suggestions">
      <CommandItem>
        <Calendar className="size-4 text-muted-foreground" />
        Calendar
      </CommandItem>
      <CommandItem>
        <Smile className="size-4 text-muted-foreground" />
        Search Emoji
      </CommandItem>
      <CommandItem>
        <Calculator className="size-4 text-muted-foreground" />
        Calculator
      </CommandItem>
    </CommandGroup>
  </CommandList>
</Command>

With Keyboard Shortcuts

<CommandItem className="gap-2">
  <User className="size-4 text-muted-foreground" />
  Profile
  <CommandShortcut>⌘P</CommandShortcut>
</CommandItem>

Multiple Groups with Separator

<Command>
  <CommandInput placeholder="Type a command..." />
  <CommandList>
    <CommandGroup heading="Suggestions">
      <CommandItem>Calendar</CommandItem>
      <CommandItem>Search Emoji</CommandItem>
    </CommandGroup>
    <CommandSeparator />
    <CommandGroup heading="Settings">
      <CommandItem>Profile</CommandItem>
      <CommandItem>Billing</CommandItem>
      <CommandItem>Settings</CommandItem>
    </CommandGroup>
  </CommandList>
</Command>

Command Dialog (⌘K Pattern)

function CommandPalette() {
  const [open, setOpen] = useState(false)

  useEffect(() => {
    const down = (e: KeyboardEvent) => {
      if (e.key === "k" && (e.metaKey || e.ctrlKey)) {
        e.preventDefault()
        setOpen((open) => !open)
      }
    }
    document.addEventListener("keydown", down)
    return () => document.removeEventListener("keydown", down)
  }, [])

  return (
    <CommandDialog open={open} onOpenChange={setOpen}>
      <CommandInput placeholder="Type a command or search..." />
      <CommandList>
        <CommandEmpty>No results found.</CommandEmpty>
        <CommandGroup heading="Suggestions">
          <CommandItem onSelect={() => setOpen(false)}>
            <Calendar className="size-4 text-muted-foreground" />
            Calendar
          </CommandItem>
        </CommandGroup>
      </CommandList>
    </CommandDialog>
  )
}

With Selection State

const [selectedValue, setSelectedValue] = useState("")

<Command>
  <CommandInput placeholder="Search..." />
  <CommandList>
    <CommandGroup heading="Options">
      {options.map((option) => (
        <CommandItem
          key={option.value}
          onSelect={() => setSelectedValue(option.value)}
          className="gap-2"
        >
          {option.label}
          <Check
            className={cn(
              "ml-auto size-4",
              selectedValue === option.value ? "opacity-100" : "opacity-0"
            )}
          />
        </CommandItem>
      ))}
    </CommandGroup>
  </CommandList>
</Command>

Accessibility

• ARIA combobox/listbox pattern
• Arrow Up/Down navigates items
• Enter selects current item
• Escape closes dialog
• Type-to-search filters in real-time
• Screen readers announce item count and selection

Gotchas

See Also

• Related Components: Combobox (search select), Dialog (command palette dialog)
• Accessibility: Navigation Accessibility — Command/listbox patterns

Last updated: February 9, 2026