Multi-select
Freev1.0.0Pick several options from a list, with select all and a summary on the trigger.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { MultiSelect, type MultiSelectOption } from "@/components/ui/notchset/multi-select";
const suites: MultiSelectOption[] = [
{ value: "planner-core", label: "planner-core", weight: 1200 },
{ value: "citations", label: "citations", weight: 420 },
{ value: "safety", label: "safety", weight: 310 },
];
export function SuitePicker() {
const [picked, setPicked] = React.useState<string[]>(["planner-core"]);
return <MultiSelect options={suites} value={picked} onValueChange={setPicked} label="EVAL SUITES" />;
}Props
options–{ value, label, weight? }[]The list; weight is its share.
value / onValueChange–string[]Controlled.
chips–numberShown before +N (2).
summary–(picked, whole, count) => ReactNodeThe line under the ruler.
Anatomy
- No primitive needed: one file serves both builds.
- The panel stays open while you toggle.
- Chips read in the options' order.
MultiSelectdata-slot="multi-select"The trigger and panel.
Source
components/ui/notchset/multi-select.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/multi-select.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/multi-select.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/multi-select.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Choosing several of a known list, where their sizes matter
Use something else when
- Free-form values: use Token Field
Mistakes to avoid
- Give weights if sizes matter; without them the ruler splits evenly
Agents find it by
- multi select, multiselect, checklist dropdown, choose many, filters, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/multi-select.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- ↓ / Enter / Space
- Open
- ↑ / ↓
- Move
- Space / Enter
- Toggle
- Esc / Tab
- Close
Accessibility
- role=combobox over a multiselectable listbox; aria-selected per option
- Backspace while closed removes the last pick
Motion
- Toggle
- The check draws in (220ms); a new chip pops in
- Ruler
- Picked segments thicken to 4px (300ms)
Responsive
- Fills its container; chips give way to +N rather than wrap.
Performance
- Synchronous over your options; the ruler is a handful of SVG lines.
Changelog
v1.0.0 · 2026-10-02
First release
