Combobox
Autocomplete input with a list of suggestions.
Installation
Complete the project setup first. The init command configures TypeScript, Vite, Tailwind CSS v4, and Preact compatibility.
CLI
Run init once using the installation guide, then add this component. The CLI copies the required source files and installs their exact dependencies with Bun.
bunx --bun github:LiasCode/shadcn-preact#main add comboboxAdd --dry-run to review the changes. Existing modified files are protected; use --overwrite only when you want to replace them.
Manual installation / degit (optional)
1. Install dependencies
bun add --exact @floating-ui/react-dom@2.1.9 class-variance-authority@0.7.1 cn@0.4.0 lucide-preact@1.55.0 preact@11.0.1 tw-animate-css@1.4.02. Copy the component with degit
Run this from your project root. It selects combobox.tsx, its local dependencies, and both licenses directly from the repository, then copies them into src/components/ui.
bunx degit@3.10.0 https://github.com/LiasCode/shadcn-preact#main ./.cache/shadcn-preact/combobox --files LICENSE.md,registry/ui/button.tsx,registry/ui/combobox.tsx,registry/ui/input-group.tsx,registry/ui/input.tsx,registry/ui/lib/utils.ts,registry/ui/primitives/LICENSE,registry/ui/primitives/button/Button.tsx,registry/ui/primitives/button/index.ts,registry/ui/primitives/combobox/index.ts,registry/ui/primitives/combobox/parts.tsx,registry/ui/primitives/direction-provider/index.tsx,registry/ui/primitives/field/control/FieldControl.tsx,registry/ui/primitives/input/Input.tsx,registry/ui/primitives/input/index.ts,registry/ui/primitives/internals/FieldPopupLifecycle.tsx,registry/ui/primitives/internals/FieldRootContext.ts,registry/ui/primitives/internals/FieldsetRootContext.ts,registry/ui/primitives/internals/FloatingFocusManager.tsx,registry/ui/primitives/internals/FloatingPortal.tsx,registry/ui/primitives/internals/FloatingTree.tsx,registry/ui/primitives/internals/FloatingTreeStore.ts,registry/ui/primitives/internals/FocusGuard.tsx,registry/ui/primitives/internals/LabelableContext.ts,registry/ui/primitives/internals/arrow.ts,registry/ui/primitives/internals/composite/root/CompositeRootContext.ts,registry/ui/primitives/internals/createBaseUIEventDetails.ts,registry/ui/primitives/internals/direction-context.ts,registry/ui/primitives/internals/empty.ts,registry/ui/primitives/internals/getReactElementRef.ts,registry/ui/primitives/internals/getStateAttributesProps.ts,registry/ui/primitives/internals/markOthers.ts,registry/ui/primitives/internals/mergeObjects.ts,registry/ui/primitives/internals/owner.ts,registry/ui/primitives/internals/popups/OverlayContext.ts,registry/ui/primitives/internals/popups/OverlayParts.tsx,registry/ui/primitives/internals/popups/OverlayRoot.tsx,registry/ui/primitives/internals/popups/PopupHandle.ts,registry/ui/primitives/internals/popups/getElementProps.ts,registry/ui/primitives/internals/resolveClassName.ts,registry/ui/primitives/internals/resolveRef.ts,registry/ui/primitives/internals/resolveStyle.ts,registry/ui/primitives/internals/resolveValueLabel.ts,registry/ui/primitives/internals/stateAttributesMapping.ts,registry/ui/primitives/internals/tabbable.ts,registry/ui/primitives/internals/types.ts,registry/ui/primitives/internals/useAnchorPositioning.ts,registry/ui/primitives/internals/useAnimationFrame.ts,registry/ui/primitives/internals/useAnimationsFinished.ts,registry/ui/primitives/internals/useButton.ts,registry/ui/primitives/internals/useControlled.ts,registry/ui/primitives/internals/useDismiss.ts,registry/ui/primitives/internals/useFloatingRootContext.ts,registry/ui/primitives/internals/useFocusableWhenDisabled.ts,registry/ui/primitives/internals/useHoverFloatingInteraction.ts,registry/ui/primitives/internals/useId.ts,registry/ui/primitives/internals/useIsoLayoutEffect.ts,registry/ui/primitives/internals/useMergedRefs.ts,registry/ui/primitives/internals/useOnMount.ts,registry/ui/primitives/internals/useOpenChangeComplete.ts,registry/ui/primitives/internals/usePopupTabExit.ts,registry/ui/primitives/internals/useRefWithInit.ts,registry/ui/primitives/internals/useRegisterFieldControl.ts,registry/ui/primitives/internals/useRenderElement.ts,registry/ui/primitives/internals/useScrollLock.ts,registry/ui/primitives/internals/useStableCallback.ts,registry/ui/primitives/internals/useTransitionStatus.ts,registry/ui/primitives/internals/visuallyHidden.ts,registry/ui/primitives/merge-props/index.ts,registry/ui/primitives/separator/Separator.tsx,registry/ui/primitives/separator/index.ts,registry/ui/textarea.tsx --force
mkdir -p ./src/components/ui
cp -R ./.cache/shadcn-preact/combobox/registry/ui/. ./src/components/ui/
cp ./.cache/shadcn-preact/combobox/LICENSE.md ./src/components/ui/LICENSE.mdThe temporary copy lives in .cache/shadcn-preact/combobox. Existing components stay in place; shared source files are updated from main.
Selected source files (71)
- button.tsx
- combobox.tsx
- input-group.tsx
- input.tsx
- lib/utils.ts
- primitives/LICENSE
- primitives/button/Button.tsx
- primitives/button/index.ts
- primitives/combobox/index.ts
- primitives/combobox/parts.tsx
- primitives/direction-provider/index.tsx
- primitives/field/control/FieldControl.tsx
- primitives/input/Input.tsx
- primitives/input/index.ts
- primitives/internals/FieldPopupLifecycle.tsx
- primitives/internals/FieldRootContext.ts
- primitives/internals/FieldsetRootContext.ts
- primitives/internals/FloatingFocusManager.tsx
- primitives/internals/FloatingPortal.tsx
- primitives/internals/FloatingTree.tsx
- primitives/internals/FloatingTreeStore.ts
- primitives/internals/FocusGuard.tsx
- primitives/internals/LabelableContext.ts
- primitives/internals/arrow.ts
- primitives/internals/composite/root/CompositeRootContext.ts
- primitives/internals/createBaseUIEventDetails.ts
- primitives/internals/direction-context.ts
- primitives/internals/empty.ts
- primitives/internals/getReactElementRef.ts
- primitives/internals/getStateAttributesProps.ts
- primitives/internals/markOthers.ts
- primitives/internals/mergeObjects.ts
- primitives/internals/owner.ts
- primitives/internals/popups/OverlayContext.ts
- primitives/internals/popups/OverlayParts.tsx
- primitives/internals/popups/OverlayRoot.tsx
- primitives/internals/popups/PopupHandle.ts
- primitives/internals/popups/getElementProps.ts
- primitives/internals/resolveClassName.ts
- primitives/internals/resolveRef.ts
- primitives/internals/resolveStyle.ts
- primitives/internals/resolveValueLabel.ts
- primitives/internals/stateAttributesMapping.ts
- primitives/internals/tabbable.ts
- primitives/internals/types.ts
- primitives/internals/useAnchorPositioning.ts
- primitives/internals/useAnimationFrame.ts
- primitives/internals/useAnimationsFinished.ts
- primitives/internals/useButton.ts
- primitives/internals/useControlled.ts
- primitives/internals/useDismiss.ts
- primitives/internals/useFloatingRootContext.ts
- primitives/internals/useFocusableWhenDisabled.ts
- primitives/internals/useHoverFloatingInteraction.ts
- primitives/internals/useId.ts
- primitives/internals/useIsoLayoutEffect.ts
- primitives/internals/useMergedRefs.ts
- primitives/internals/useOnMount.ts
- primitives/internals/useOpenChangeComplete.ts
- primitives/internals/usePopupTabExit.ts
- primitives/internals/useRefWithInit.ts
- primitives/internals/useRegisterFieldControl.ts
- primitives/internals/useRenderElement.ts
- primitives/internals/useScrollLock.ts
- primitives/internals/useStableCallback.ts
- primitives/internals/useTransitionStatus.ts
- primitives/internals/visuallyHidden.ts
- primitives/merge-props/index.ts
- primitives/separator/Separator.tsx
- primitives/separator/index.ts
- textarea.tsx
Usage
import {
Combobox,
ComboboxContent,
ComboboxEmpty,
ComboboxInput,
ComboboxItem,
ComboboxList,
} from "./components/ui/combobox"const frameworks = ["Next.js", "SvelteKit", "Nuxt.js", "Remix", "Astro"]
export function ExampleCombobox() {
return (
<Combobox items={frameworks}>
<ComboboxInput placeholder="Select a framework" />
<ComboboxContent>
<ComboboxEmpty>No items found.</ComboboxEmpty>
<ComboboxList>
{(item) => (
<ComboboxItem key={item} value={item}>
{item}
</ComboboxItem>
)}
</ComboboxList>
</ComboboxContent>
</Combobox>
)
}Examples
Example requirements
Also uses: Item.
Popup
You can trigger the combobox from a button or any other component by using the render prop. Move the ComboboxInput inside the ComboboxContent.
Example requirements
Also uses: Button.
Input Group
You can add an addon to the combobox by using the InputGroupAddon component inside the ComboboxInput.
Example requirements
Also uses: Input Group.
bun add --exact lucide-preact@1.55.0Reference
See the official Combobox documentation for composition patterns and API details. This page uses the Preact port and examples from the pinned upstream revision.
Component source