Skip to content
Design System
GitHub

Autocomplete

v0.23.1Beta

A text field that suggests as you type: filter, arrows, Enter, groups, server search with loading.

Autocomplete default

Install
npx shadcn add @syncrobotic/autocomplete

Also installs: lucide-react, @syncrobotic/cn, @syncrobotic/field, @syncrobotic/popover, @syncrobotic/spinner, @syncrobotic/use-debounce

Overview

A text field with a list of suggestions that narrows as you type, for picking one value from many.

When to use

  • Picking a robot, site, user or dataset from a long list.
  • Searching a server as you type, with a loading state.
  • Grouped suggestions, such as robots by kind.

Use something else

  • Fewer than about 10 options: Select.
  • A command that does something: Command.
  • Free text with no list: Input.

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

Offline robots cannot take tasks.

Autocomplete groups

Autocomplete no trigger

Autocomplete server search

Autocomplete small

The site is set by the robot's map and cannot change during a mission.

Autocomplete disabled

Autocomplete in form

Pick a dock. The robot needs somewhere to charge.

Autocomplete error

Autocomplete long list

Autocomplete recent

Every robot belongs to one site.

Autocomplete required

Autocomplete descriptions

Usage rules

  • For picking one of many known values; for free text use Input.
  • Disabled options stay in the list so people see why they cannot pick them.
  • Inside a Field it takes the label, note and error.

Changelog

  • 0.23.12026-11-21A new selection writes its label into the field in the render that brings it instead of an effect later, so it is safe under the React Compiler.
  • 0.23.02026-11-20Every word it says can be translated without editing the source: labels (AutocompleteLabels: placeholder, empty, searching, searchingStatus, clear, showAll, suggestions). placeholder and emptyText still work and win over it.
  • 0.17.32026-11-19Disabled: the field keeps its grey fill with a --border edge, so in dark mode it no longer looks enabled; its words use the new --disabled (3:1 on every surface).

How to upgrade