UI Components

Chip Group

Selectable chip pills for filtering and tagging. Supports single or multi-select, size/color/variant combinations, count badges, removable chips, icons, and disabled options.

Quick Preview

Selected: all

Installation

// Copy from
src/components/ui/ChipGroup.tsx

Usage

'use client'
import { useState } from 'react'
import { ChipGroup } from '@/components/ui/ChipGroup'

// Single-select
export function FilterBar() {
  const [filter, setFilter] = useState<string | undefined>('all')
  return (
    <ChipGroup
      options={[
        { value: 'all',   label: 'All' },
        { value: 'react', label: 'React' },
        { value: 'vue',   label: 'Vue' },
        { value: 'svelte',label: 'Svelte' },
      ]}
      value={filter}
      onChange={setFilter}
    />
  )
}

// Multi-select
export function TagPicker() {
  const [tags, setTags] = useState<string[]>([])
  return (
    <ChipGroup
      multi
      options={[
        { value: 'ts',    label: 'TypeScript', icon: '🔷' },
        { value: 'react', label: 'React',       icon: '⚛️'  },
        { value: 'next',  label: 'Next.js',     icon: '▲'  },
      ]}
      value={tags}
      onChange={setTags}
    />
  )
}

Examples

Single-select (default)

Click a chip to select it; click again to deselect.

selected: all

Multi-select

Pass multi prop to allow multiple selections.

selected: [ui, forms]

With icons

Add an icon string or emoji to each option.

selected: [ts, react]

Size variants

size="sm" | "md" | "lg"

Color variants

color="primary" | "blue" | "violet" | "orange"

Visual variant

variant="filled" | "outline" | "soft"

With count badge

showCount displays a small badge with the option count.

Removable chips

removable allows deselecting via an × button on selected chips.

selected: [css, ts]

Disabled chips

Pass disabled: true on individual options.

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 ui component named Chip Group in React/Next.js.
Goal: recreate the same overall UI and behavior as the Chip Group reference from a component gallery.
What it needs to communicate: Selectable chip pills for filtering and tagging. Supports single or multi-select, size/color/variant combinations, count badges, removable chips, icons, and disabled options..

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:
- Keep the API concise and reusable.
- Make visual states feel polished and consistent across variants and sizes.
- 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: ChipOption[] — required — Array of selectable chip items
- multi: boolean — Enable multi-selection; omit or false for single-select
- value: string | string[] — Controlled selected value(s)
- defaultValue: string | string[] — Uncontrolled initial selection
- onChange: (value: string | string[] | undefined) => void — Fires on selection change
- size: 'sm' | 'md' | 'lg' — default 'md' — Chip size
- variant: 'filled' | 'outline' | 'soft' — default 'filled' — Visual style
- color: 'primary' | 'gray' | 'blue' | 'violet' | 'orange' — default 'primary' — Active color theme
- showCount: boolean — default false — Show count badge per chip
- removable: boolean — default false — Show × to deselect on selected chips
- className: string — Additional CSS classes for the wrapper

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

Feature expectations:
- Single and multi-select modes
- Filled, outline, and soft visual variants
- 5 color themes
- 3 sizes (sm / md / lg)
- Count badge per chip
- Removable chips (×)
- Icon and emoji support
- Disabled individual chips
- Fully accessible (role="checkbox")

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`*	`ChipOption[]`	-	Array of selectable chip items
`multi`	`boolean`	-	Enable multi-selection; omit or false for single-select
`value`	`string \| string[]`	-	Controlled selected value(s)
`defaultValue`	`string \| string[]`	-	Uncontrolled initial selection
`onChange`	`(value: string \| string[] \| undefined) => void`	-	Fires on selection change
`size`	`'sm' \| 'md' \| 'lg'`	`'md'`	Chip size
`variant`	`'filled' \| 'outline' \| 'soft'`	`'filled'`	Visual style
`color`	`'primary' \| 'gray' \| 'blue' \| 'violet' \| 'orange'`	`'primary'`	Active color theme
`showCount`	`boolean`	`false`	Show count badge per chip
`removable`	`boolean`	`false`	Show × to deselect on selected chips
`className`	`string`	-	Additional CSS classes for the wrapper