Forms

Combobox

A searchable dropdown select with filtering, clear button, disabled options, and optional description text.

Quick Preview

Fruit

Installation

// Copy Combobox.tsx to your components/forms/ folder
// src/components/forms/Combobox.tsx

Usage

import { Combobox } from '@/components/forms/Combobox'

const options = [
  { value: 'next', label: 'Next.js' },
  { value: 'remix', label: 'Remix' },
  { value: 'astro', label: 'Astro', disabled: true },
]

const [framework, setFramework] = useState('')

<Combobox
  options={options}
  value={framework}
  onChange={setFramework}
  placeholder="Select a framework…"
  label="Framework"
/>

Examples

Frameworks with disabled option

Framework

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 forms component named Combobox in React/Next.js.
Goal: recreate the same overall UI and behavior as the Combobox reference from a component gallery.
What it needs to communicate: A searchable dropdown select with filtering, clear button, disabled options, and optional description text..

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:
- Support label, helper, error, disabled, and validation states.
- Ensure keyboard usability and accessible form semantics.
- 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:
- options: ComboboxOption[] — required — Array of selectable options
- value: string — Controlled selected value
- onChange: (value: string) => void — Called when selection changes
- placeholder: string — default "Select an option…" — Trigger placeholder
- searchPlaceholder: string — default "Search…" — Search input placeholder
- disabled: boolean — default false — Disables the combobox
- label: string — Label above the trigger
- emptyMessage: string — default "No options found." — Message when search has no results

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

Feature expectations:
- Searchable with live filtering
- Clear button to reset selection
- Disabled individual options
- Descriptions on options
- Checkmark for selected item
- Click-outside to close
- Focus search on open

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
`options`*	`ComboboxOption[]`	-	Array of selectable options
`value`	`string`	-	Controlled selected value
`onChange`	`(value: string) => void`	-	Called when selection changes
`placeholder`	`string`	`"Select an option…"`	Trigger button placeholder
`searchPlaceholder`	`string`	`"Search…"`	Search input placeholder
`disabled`	`boolean`	`false`	Disables the entire combobox
`label`	`string`	-	Label rendered above the trigger
`emptyMessage`	`string`	`"No options found."`	Message when search has no results

← Back to Forms