UI Components

Command Menu

A ⌘K command palette with fuzzy search, grouped items, keyboard navigation, and shortcut badges.

Quick Preview

or press ⌘K

Installation

npm install cmdk

// Copy CommandMenu.tsx to your components/ui/ folder
// src/components/ui/CommandMenu.tsx

Usage

import { CommandMenu, CommandItem } from '@/components/ui/CommandMenu'

const items: CommandItem[] = [
  {
    id: 'settings',
    label: 'Settings',
    description: 'Manage your preferences',
    icon: <Settings size={14} />,
    shortcut: '⌘,',
    group: 'Navigation',
    onSelect: () => router.push('/settings'),
  },
]

// Controlled usage
const [open, setOpen] = useState(false)

<Button onClick={() => setOpen(true)}>Open</Button>
<CommandMenu
  items={items}
  open={open}
  onOpenChange={setOpen}
  registerShortcut={false}
/>

// Or use registerShortcut to auto-bind ⌘K / Ctrl+K
<CommandMenu items={items} registerShortcut />

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a ui component named Command Menu in React/Next.js.
Goal: recreate the same overall UI and behavior as the Command Menu reference from a component gallery.
What it needs to communicate: A ⌘K command palette with fuzzy search, grouped items, keyboard navigation, and shortcut badges..

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Keep the API concise and reusable.
- Make visual states feel polished and consistent across variants and sizes.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- items: CommandItem[] — required — Array of command items to display
- open: boolean — Controlled open state
- onOpenChange: (open: boolean) => void — Called when open state changes
- placeholder: string — default "Type a command…" — Input placeholder text
- emptyMessage: string — default "No results found." — Message when no results match
- registerShortcut: boolean — default true — Binds ⌘K / Ctrl+K to open the menu

Reference usage patterns:
- No examples were documented. Infer a sensible default presentation and one richer usage example.

Feature expectations:
- Fuzzy search filtering via cmdk
- Grouped items with section headings
- Keyboard navigation (arrows + Enter)
- ⌘K / Ctrl+K shortcut registration
- Shortcut badges display
- Portal rendering (fixed overlay)
- Escape to close

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`items`*	`CommandItem[]`	-	Array of command items to display
`open`	`boolean`	-	Controlled open state
`onOpenChange`	`(open: boolean) => void`	-	Called when open state changes
`placeholder`	`string`	`"Type a command…"`	Input placeholder text
`emptyMessage`	`string`	`"No results found."`	Message shown when no results match
`registerShortcut`	`boolean`	`true`	Binds ⌘K / Ctrl+K to open the menu

CommandItem Props

Prop	Type	Default	Description
`id`*	`string`	-	Unique identifier
`label`*	`string`	-	Display label and search text
`onSelect`*	`() => void`	-	Called when item is selected
`description`	`string`	-	Secondary description text
`icon`	`React.ReactNode`	-	Icon shown before label
`shortcut`	`string`	-	Keyboard shortcut badge (display only)
`group`	`string`	`"General"`	Group name for organizing items

← Back to UI Components