Recipient field

FREE

Who an email goes to, a chip per person.

Every shadcn style · one file

Installation

pnpm dlx shadcn@latest add https://notchset.dev/r/recipient-field.json

Free, no account or key. One command for every shadcn style. With the @notchset registry added, @notchset/<name> works too.

Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested

Install by hand

1. Add the packages
pnpm add @base-ui/react@^1 lucide-react@^1
2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/recipient-field.tsx
- lib/notchset/popup.ts
- lib/notchset/portal.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), Avatar, Field

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.

Usage

Import it and pass your content. The props that matter most are listed next.

Example

"use client";
import * as React from "react";
import { RecipientField, type Recipient } from "@/components/ui/notchset/recipient-field";

const PEOPLE: Recipient[] = [
  { id: "ana", name: "Ana Ruiz", email: "ana@airtable.com" },
  { id: "kevin", name: "Kevin Ito", email: "kevin@airtable.com" },
  { id: "priya", name: "Priya Shah", email: "priya@sentry.io" },
  { id: "marcus", name: "Marcus Bell", email: "marcus@calendly.com" },
  { id: "lena", name: "Lena Ortiz", email: "lena@framer.com" },
];

export default function RecipientFieldDemo() {
  const [to, setTo] = React.useState<Recipient[]>([PEOPLE[0]!, PEOPLE[1]!]);
  return (
    <label className="flex w-full max-w-[560px] flex-col gap-1.5 text-[length:var(--ns-text-small)] text-[var(--ns-ink-2)]">
      <span>
        To <span className="text-[var(--ns-ink-3)]">· {to.length}</span>
      </span>
      <RecipientField aria-label="To" people={PEOPLE} value={to} onValueChange={setTo} />
    </label>
  );
}