# ui.anuragroy.dev

> HeroUI-inspired UI components distributed as a shadcn-compatible registry. Built with Base UI, Tailwind CSS, and the shadcn registry format. Visual design is inspired by HeroUI — this is not a wrapper around `@heroui/react` and is not an npm component package.

This is a copy-into-your-app registry, not a versioned npm UI kit. The consumer project should already be a shadcn-compatible React + Tailwind app (`components.json` plus CSS color variables). The shadcn CLI writes files into the app; after install they are ordinary local source. Edit them freely.

Install a component by pointing the CLI at a registry JSON URL. Replace `<name>` with a kebab-case item from the catalog (for example `button`, `text-field`, `prompt-input`):

```bash
npx shadcn@latest add https://ui.anuragroy.dev/r/<name>.json
```

Add several items in one command by passing multiple URLs. If this site is unavailable, the same files live on GitHub: `https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/<name>.json`. The machine index of every item is `/r/registry.json`.

How to navigate this site:
- Human catalog: `/component`
- HTML docs (preview + API): `/component/<name>`
- Markdown twin of each docs page (prefer this for agents): `/component/<name>.md`
- Registry item (source files, npm deps, registry deps, optional CSS): `/r/<name>.json`
- This file is the map. `/llms-full.txt` concatenates every component markdown doc for a single fetch.

Conventions for coding agents:
- Default import after install: `import { Button } from "@/components/ui/button"` (or the `ui` alias in the consumer `components.json`).
- Behavior primitives are Base UI (`@base-ui/react`), not Radix. Compose a custom trigger with the `render` prop — `<ModalTrigger render={<Button />}>Open</ModalTrigger>`. Do not use Radix `asChild`.
- Styling is Tailwind CSS v4 + `class-variance-authority` variants + `cn()` from the registry `utils` item (`clsx` + `tailwind-merge`).
- Tokens are standard shadcn CSS variables. HeroUI mapping: accent → `--primary`, default → `--secondary`, danger → `--destructive`, surface → `--card`, overlay → `--popover`. Soft Alert/Chip/Badge variants also read `--success` / `--warning` (and `-foreground`).
- The look is a fixed HeroUI-inspired language: pill buttons, soft surfaces, large radii, a light press scale. It is not a multi-style theme pack.
- Color components use `react-aria-components`. Calendars and date pickers use `react-day-picker` and `date-fns`. Icons are `lucide-react`. Code highlighting uses `shiki` via the `highlight` helper.
- `dropdown` is a friendlier alias of `menu` — prefer `dropdown` for typical menus. `error-message` re-exports `field-error`. Prefer `text-field` (label + description + error) over a bare `input` in forms.
- Toasts: mount `ToastProvider` and `Toaster` once near the app root, then `useToast().add({ title, description })`.
- The showcase site runs on Next.js 15 (App Router) + React 19. Installed components do not require Next.js; they need React, Tailwind, and the CSS variables.

When implementing UI, fetch the component markdown (or `/llms-full.txt`) for usage and API, then install from the registry JSON. Do not invent Radix-style or `@heroui/react` APIs.

## Docs
- [Component catalog](https://ui.anuragroy.dev/component): Human index grouped by category.
- [Full markdown docs](https://ui.anuragroy.dev/llms-full.txt): Every component’s install, import, usage, API, and notes in one file.
- [Registry index](https://ui.anuragroy.dev/r/registry.json): shadcn registry JSON (`name`: `anurag`) listing every item.
- [README](https://github.com/anurag-roy/ui.anuragroy.dev/blob/main/README.md): Install commands, theme token table, and local-dev notes.

## Buttons
- [Button](https://ui.anuragroy.dev/component/button.md): Pill button with soft variants. Imports `Button`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/button.json`. Source: https://ui.anuragroy.dev/r/button.json.
- [Button Group](https://ui.anuragroy.dev/component/button-group.md): Grouped buttons sharing size/variant. Imports `ButtonGroup`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/button-group.json`. Source: https://ui.anuragroy.dev/r/button-group.json.
- [Close Button](https://ui.anuragroy.dev/component/close-button.md): Icon close button for overlays. Imports `CloseButton`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/close-button.json`. Source: https://ui.anuragroy.dev/r/close-button.json.
- [Toggle Button](https://ui.anuragroy.dev/component/toggle-button.md): Pressable toggle button. Imports `ToggleButton`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/toggle-button.json`. Source: https://ui.anuragroy.dev/r/toggle-button.json.
- [Toggle Button Group](https://ui.anuragroy.dev/component/toggle-button-group.md): Group of mutually exclusive toggles. Imports `ToggleButtonGroup`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/toggle-button-group.json`. Source: https://ui.anuragroy.dev/r/toggle-button-group.json.

## Forms
- [Input](https://ui.anuragroy.dev/component/input.md): Soft shadowed text input. Imports `Input`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/input.json`. Source: https://ui.anuragroy.dev/r/input.json.
- [Textarea](https://ui.anuragroy.dev/component/textarea.md): Multi-line text input. Imports `Textarea`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/textarea.json`. Source: https://ui.anuragroy.dev/r/textarea.json.
- [Text Field](https://ui.anuragroy.dev/component/text-field.md): Labeled field with description and error. Imports `TextField`, `TextFieldLabel`, `TextFieldInput`, `TextFieldDescription`, `TextFieldError`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/text-field.json`. Source: https://ui.anuragroy.dev/r/text-field.json.
- [Search Field](https://ui.anuragroy.dev/component/search-field.md): Search input with clear action. Imports `SearchField`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/search-field.json`. Source: https://ui.anuragroy.dev/r/search-field.json.
- [Number Field](https://ui.anuragroy.dev/component/number-field.md): Numeric stepper field. Imports `NumberField`, `NumberFieldDecrement`, `NumberFieldGroup`, `NumberFieldIncrement`, `NumberFieldInput`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/number-field.json`. Source: https://ui.anuragroy.dev/r/number-field.json.
- [Input Group](https://ui.anuragroy.dev/component/input-group.md): Input with prefix/suffix addons. Imports `InputGroup`, `InputGroupAddon`, `InputGroupButton`, `InputGroupInput`, `InputGroupText`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/input-group.json`. Source: https://ui.anuragroy.dev/r/input-group.json.
- [Input Otp](https://ui.anuragroy.dev/component/input-otp.md): One-time password input. Imports `InputOTP`, `InputOTPGroup`, `InputOTPSeparator`, `InputOTPSlot`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/input-otp.json`. Source: https://ui.anuragroy.dev/r/input-otp.json.
- [Checkbox](https://ui.anuragroy.dev/component/checkbox.md): Accessible checkbox. Imports `Checkbox`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/checkbox.json`. Source: https://ui.anuragroy.dev/r/checkbox.json.
- [Checkbox Group](https://ui.anuragroy.dev/component/checkbox-group.md): Group of checkboxes. Imports `CheckboxGroup`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/checkbox-group.json`. Source: https://ui.anuragroy.dev/r/checkbox-group.json.
- [Radio](https://ui.anuragroy.dev/component/radio.md): Radio control. Imports `Radio`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/radio.json`. Source: https://ui.anuragroy.dev/r/radio.json.
- [Radio Group](https://ui.anuragroy.dev/component/radio-group.md): Group of radios. Imports `RadioGroup`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/radio-group.json`. Source: https://ui.anuragroy.dev/r/radio-group.json.
- [Switch](https://ui.anuragroy.dev/component/switch.md): Toggle switch. Imports `Switch`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/switch.json`. Source: https://ui.anuragroy.dev/r/switch.json.
- [Switch Group](https://ui.anuragroy.dev/component/switch-group.md): Stacked switches. Imports `SwitchGroup`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/switch-group.json`. Source: https://ui.anuragroy.dev/r/switch-group.json.
- [Slider](https://ui.anuragroy.dev/component/slider.md): Range slider. Imports `Slider`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/slider.json`. Source: https://ui.anuragroy.dev/r/slider.json.
- [Label](https://ui.anuragroy.dev/component/label.md): Form label. Imports `Label`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/label.json`. Source: https://ui.anuragroy.dev/r/label.json.
- [Description](https://ui.anuragroy.dev/component/description.md): Helper description text. Imports `Description`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/description.json`. Source: https://ui.anuragroy.dev/r/description.json.
- [Field Error](https://ui.anuragroy.dev/component/field-error.md): Field validation error. Imports `FieldError`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/field-error.json`. Source: https://ui.anuragroy.dev/r/field-error.json.
- [Error Message](https://ui.anuragroy.dev/component/error-message.md): Alias for field error. Imports `ErrorMessage`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/error-message.json`. Source: https://ui.anuragroy.dev/r/error-message.json.
- [Fieldset](https://ui.anuragroy.dev/component/fieldset.md): Fieldset with legend. Imports `Fieldset`, `FieldsetLegend`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/fieldset.json`. Source: https://ui.anuragroy.dev/r/fieldset.json.
- [Form](https://ui.anuragroy.dev/component/form.md): Accessible form root. Imports `Form`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/form.json`. Source: https://ui.anuragroy.dev/r/form.json.

## Pickers
- [Select](https://ui.anuragroy.dev/component/select.md): Select menu. Imports `Select`, `SelectContent`, `SelectItem`, `SelectTrigger`, `SelectValue`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/select.json`. Source: https://ui.anuragroy.dev/r/select.json.
- [Combo Box](https://ui.anuragroy.dev/component/combo-box.md): Filterable combo box. Imports `ComboBox`, `ComboBoxContent`, `ComboBoxEmpty`, `ComboBoxInput`, `ComboBoxInputGroup`, `ComboBoxItem`, `ComboBoxLabel`, `ComboBoxList`, `ComboBoxTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/combo-box.json`. Source: https://ui.anuragroy.dev/r/combo-box.json.
- [Autocomplete](https://ui.anuragroy.dev/component/autocomplete.md): Autocomplete input. Imports `Autocomplete`, `AutocompleteClear`, `AutocompleteContent`, `AutocompleteEmpty`, `AutocompleteIcon`, `AutocompleteInput`, `AutocompleteInputGroup`, `AutocompleteItem`, `AutocompleteList`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/autocomplete.json`. Source: https://ui.anuragroy.dev/r/autocomplete.json.
- [List Box](https://ui.anuragroy.dev/component/list-box.md): Standalone list box. Imports `ListBox`, `ListBoxItem`, `ListBoxSection`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/list-box.json`. Source: https://ui.anuragroy.dev/r/list-box.json.
- [Tag](https://ui.anuragroy.dev/component/tag.md): Selectable / dismissible tag. Imports `Tag`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/tag.json`. Source: https://ui.anuragroy.dev/r/tag.json.
- [Tag Group](https://ui.anuragroy.dev/component/tag-group.md): Group of tags. Imports `TagGroup`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/tag-group.json`. Source: https://ui.anuragroy.dev/r/tag-group.json.

## Overlays
- [Modal](https://ui.anuragroy.dev/component/modal.md): Centered modal dialog. Imports `Modal`, `ModalContent`, `ModalDescription`, `ModalFooter`, `ModalHeader`, `ModalTitle`, `ModalTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/modal.json`. Source: https://ui.anuragroy.dev/r/modal.json.
- [Alert Dialog](https://ui.anuragroy.dev/component/alert-dialog.md): Confirmation dialog. Imports `AlertDialog`, `AlertDialogAction`, `AlertDialogCancel`, `AlertDialogContent`, `AlertDialogDescription`, `AlertDialogFooter`, `AlertDialogHeader`, `AlertDialogTitle`, `AlertDialogTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/alert-dialog.json`. Source: https://ui.anuragroy.dev/r/alert-dialog.json.
- [Drawer](https://ui.anuragroy.dev/component/drawer.md): Bottom drawer / sheet. Imports `Drawer`, `DrawerClose`, `DrawerContent`, `DrawerDescription`, `DrawerFooter`, `DrawerHeader`, `DrawerTitle`, `DrawerTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/drawer.json`. Source: https://ui.anuragroy.dev/r/drawer.json.
- [Popover](https://ui.anuragroy.dev/component/popover.md): Floating popover. Imports `Popover`, `PopoverContent`, `PopoverDescription`, `PopoverTitle`, `PopoverTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/popover.json`. Source: https://ui.anuragroy.dev/r/popover.json.
- [Tooltip](https://ui.anuragroy.dev/component/tooltip.md): Contextual tooltip. Imports `Tooltip`, `TooltipContent`, `TooltipProvider`, `TooltipTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/tooltip.json`. Source: https://ui.anuragroy.dev/r/tooltip.json.
- [Toast](https://ui.anuragroy.dev/component/toast.md): Toast notifications. Imports `ToastProvider`, `Toaster`, `useToast`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/toast.json`. Source: https://ui.anuragroy.dev/r/toast.json.
- [Menu](https://ui.anuragroy.dev/component/menu.md): Dropdown menu primitives. Imports `Menu`, `MenuItem`, `MenuPopup`, `MenuPortal`, `MenuPositioner`, `MenuTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/menu.json`. Source: https://ui.anuragroy.dev/r/menu.json.
- [Dropdown](https://ui.anuragroy.dev/component/dropdown.md): Dropdown menu aliases. Imports `Dropdown`, `DropdownItem`, `DropdownMenu`, `DropdownSeparator`, `DropdownTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/dropdown.json`. Source: https://ui.anuragroy.dev/r/dropdown.json.

## Navigation & layout
- [Accordion](https://ui.anuragroy.dev/component/accordion.md): Expandable accordion. Imports `Accordion`, `AccordionContent`, `AccordionItem`, `AccordionTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/accordion.json`. Source: https://ui.anuragroy.dev/r/accordion.json.
- [Disclosure](https://ui.anuragroy.dev/component/disclosure.md): Single disclosure / collapsible. Imports `Disclosure`, `DisclosureContent`, `DisclosureTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/disclosure.json`. Source: https://ui.anuragroy.dev/r/disclosure.json.
- [Disclosure Group](https://ui.anuragroy.dev/component/disclosure-group.md): Grouped disclosures. Imports `DisclosureGroup`, `DisclosureGroupContent`, `DisclosureGroupItem`, `DisclosureGroupTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/disclosure-group.json`. Source: https://ui.anuragroy.dev/r/disclosure-group.json.
- [Tabs](https://ui.anuragroy.dev/component/tabs.md): Pill segmented tabs. Imports `Tabs`, `TabsIndicator`, `TabsList`, `TabsPanel`, `TabsTab`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/tabs.json`. Source: https://ui.anuragroy.dev/r/tabs.json.
- [Breadcrumbs](https://ui.anuragroy.dev/component/breadcrumbs.md): Breadcrumb navigation. Imports `BreadcrumbEllipsis`, `BreadcrumbItem`, `BreadcrumbLink`, `BreadcrumbList`, `BreadcrumbPage`, `BreadcrumbSeparator`, `Breadcrumbs`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/breadcrumbs.json`. Source: https://ui.anuragroy.dev/r/breadcrumbs.json.
- [Pagination](https://ui.anuragroy.dev/component/pagination.md): Pagination controls. Imports `Pagination`, `PaginationContent`, `PaginationEllipsis`, `PaginationItem`, `PaginationLink`, `PaginationNext`, `PaginationPrevious`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/pagination.json`. Source: https://ui.anuragroy.dev/r/pagination.json.
- [Link](https://ui.anuragroy.dev/component/link.md): Styled link. Imports `Link`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/link.json`. Source: https://ui.anuragroy.dev/r/link.json.
- [Card](https://ui.anuragroy.dev/component/card.md): Surface card with header/body/footer. Imports `Card`, `CardContent`, `CardDescription`, `CardFooter`, `CardHeader`, `CardTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/card.json`. Source: https://ui.anuragroy.dev/r/card.json.
- [Surface](https://ui.anuragroy.dev/component/surface.md): Elevated surface container. Imports `Surface`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/surface.json`. Source: https://ui.anuragroy.dev/r/surface.json.
- [Separator](https://ui.anuragroy.dev/component/separator.md): Visual separator. Imports `Separator`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/separator.json`. Source: https://ui.anuragroy.dev/r/separator.json.
- [Toolbar](https://ui.anuragroy.dev/component/toolbar.md): Toolbar container. Imports `Toolbar`, `ToolbarButton`, `ToolbarGroup`, `ToolbarSeparator`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/toolbar.json`. Source: https://ui.anuragroy.dev/r/toolbar.json.
- [Header](https://ui.anuragroy.dev/component/header.md): Page header layout. Imports `Header`, `HeaderActions`, `HeaderBrand`, `HeaderInner`, `HeaderNav`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/header.json`. Source: https://ui.anuragroy.dev/r/header.json.
- [Empty State](https://ui.anuragroy.dev/component/empty-state.md): Empty state placeholder. Imports `EmptyState`, `EmptyStateActions`, `EmptyStateDescription`, `EmptyStateIcon`, `EmptyStateTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/empty-state.json`. Source: https://ui.anuragroy.dev/r/empty-state.json.
- [Scroll Shadow](https://ui.anuragroy.dev/component/scroll-shadow.md): Scroll edge fade shadows. Imports `ScrollShadow`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/scroll-shadow.json`. Source: https://ui.anuragroy.dev/r/scroll-shadow.json.

## Data display & feedback
- [Avatar](https://ui.anuragroy.dev/component/avatar.md): User avatar. Imports `Avatar`, `AvatarFallback`, `AvatarImage`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/avatar.json`. Source: https://ui.anuragroy.dev/r/avatar.json.
- [Badge](https://ui.anuragroy.dev/component/badge.md): Status badge. Imports `Badge`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/badge.json`. Source: https://ui.anuragroy.dev/r/badge.json.
- [Chip](https://ui.anuragroy.dev/component/chip.md): Dismissible chip. Imports `Chip`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/chip.json`. Source: https://ui.anuragroy.dev/r/chip.json.
- [Alert](https://ui.anuragroy.dev/component/alert.md): Inline alert. Imports `Alert`, `AlertDescription`, `AlertIndicator`, `AlertTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/alert.json`. Source: https://ui.anuragroy.dev/r/alert.json.
- [Table](https://ui.anuragroy.dev/component/table.md): Data table primitives. Imports `Table`, `TableBody`, `TableCaption`, `TableCell`, `TableHead`, `TableHeader`, `TableRow`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/table.json`. Source: https://ui.anuragroy.dev/r/table.json.
- [Progress Bar](https://ui.anuragroy.dev/component/progress-bar.md): Linear progress. Imports `ProgressBar`, `ProgressBarTrack`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/progress-bar.json`. Source: https://ui.anuragroy.dev/r/progress-bar.json.
- [Progress Circle](https://ui.anuragroy.dev/component/progress-circle.md): Circular progress. Imports `ProgressCircle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/progress-circle.json`. Source: https://ui.anuragroy.dev/r/progress-circle.json.
- [Meter](https://ui.anuragroy.dev/component/meter.md): Meter gauge. Imports `Meter`, `MeterLabel`, `MeterTrack`, `MeterValue`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/meter.json`. Source: https://ui.anuragroy.dev/r/meter.json.
- [Spinner](https://ui.anuragroy.dev/component/spinner.md): Loading spinner. Imports `Spinner`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/spinner.json`. Source: https://ui.anuragroy.dev/r/spinner.json.
- [Skeleton](https://ui.anuragroy.dev/component/skeleton.md): Loading skeleton. Imports `Skeleton`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/skeleton.json`. Source: https://ui.anuragroy.dev/r/skeleton.json.
- [Kbd](https://ui.anuragroy.dev/component/kbd.md): Keyboard key. Imports `Kbd`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/kbd.json`. Source: https://ui.anuragroy.dev/r/kbd.json.
- [Typography](https://ui.anuragroy.dev/component/typography.md): Typography helpers. Imports `TypographyH1`, `TypographyH2`, `TypographyH3`, `TypographyH4`, `TypographyP`, `TypographyLead`, `TypographyMuted`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/typography.json`. Source: https://ui.anuragroy.dev/r/typography.json.

## Date & time
- [Calendar](https://ui.anuragroy.dev/component/calendar.md): Month calendar. Imports `Calendar`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/calendar.json`. Source: https://ui.anuragroy.dev/r/calendar.json.
- [Range Calendar](https://ui.anuragroy.dev/component/range-calendar.md): Date range calendar. Imports `RangeCalendar`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/range-calendar.json`. Source: https://ui.anuragroy.dev/r/range-calendar.json.
- [Date Field](https://ui.anuragroy.dev/component/date-field.md): Simplified date field. Imports `DateField`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/date-field.json`. Source: https://ui.anuragroy.dev/r/date-field.json.
- [Time Field](https://ui.anuragroy.dev/component/time-field.md): Simplified time field. Imports `TimeField`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/time-field.json`. Source: https://ui.anuragroy.dev/r/time-field.json.
- [Date Picker](https://ui.anuragroy.dev/component/date-picker.md): Popover date picker. Imports `DatePicker`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/date-picker.json`. Source: https://ui.anuragroy.dev/r/date-picker.json.
- [Date Range Picker](https://ui.anuragroy.dev/component/date-range-picker.md): Popover range picker. Imports `DateRangePicker`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/date-range-picker.json`. Source: https://ui.anuragroy.dev/r/date-range-picker.json.
- [Calendar Year Picker](https://ui.anuragroy.dev/component/calendar-year-picker.md): Year grid picker. Imports `CalendarYearPicker`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/calendar-year-picker.json`. Source: https://ui.anuragroy.dev/r/calendar-year-picker.json.

## Colors
- [Color Area](https://ui.anuragroy.dev/component/color-area.md): 2D color area. Imports `ColorArea`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/color-area.json`. Source: https://ui.anuragroy.dev/r/color-area.json.
- [Color Slider](https://ui.anuragroy.dev/component/color-slider.md): Color channel slider. Imports `ColorSlider`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/color-slider.json`. Source: https://ui.anuragroy.dev/r/color-slider.json.
- [Color Swatch](https://ui.anuragroy.dev/component/color-swatch.md): Color swatch. Imports `ColorSwatch`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/color-swatch.json`. Source: https://ui.anuragroy.dev/r/color-swatch.json.
- [Color Swatch Picker](https://ui.anuragroy.dev/component/color-swatch-picker.md): Swatch selection grid. Imports `ColorSwatchPicker`, `ColorSwatchPickerItem`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/color-swatch-picker.json`. Source: https://ui.anuragroy.dev/r/color-swatch-picker.json.
- [Color Field](https://ui.anuragroy.dev/component/color-field.md): Color text field. Imports `ColorField`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/color-field.json`. Source: https://ui.anuragroy.dev/r/color-field.json.
- [Color Picker](https://ui.anuragroy.dev/component/color-picker.md): Composed color picker. Imports `ColorPicker`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/color-picker.json`. Source: https://ui.anuragroy.dev/r/color-picker.json.
- [Color Input Group](https://ui.anuragroy.dev/component/color-input-group.md): Hex / channel inputs. Imports `ColorInputGroup`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/color-input-group.json`. Source: https://ui.anuragroy.dev/r/color-input-group.json.

## AI & chat
- [Message Scroller](https://ui.anuragroy.dev/component/message-scroller.md): Conversation viewport that follows streams and holds your place. Imports `MessageScroller`, `MessageScrollerButton`, `MessageScrollerContent`, `MessageScrollerItem`, `MessageScrollerProvider`, `MessageScrollerViewport`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/message-scroller.json`. Source: https://ui.anuragroy.dev/r/message-scroller.json.
- [Message](https://ui.anuragroy.dev/component/message.md): Message row with avatar, alignment, header, and footer. Imports `Message`, `MessageAvatar`, `MessageContent`, `MessageFooter`, `MessageHeader`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/message.json`. Source: https://ui.anuragroy.dev/r/message.json.
- [Bubble](https://ui.anuragroy.dev/component/bubble.md): Conversational surface with variants, grouping, and reactions. Imports `Bubble`, `BubbleContent`, `BubbleGroup`, `BubbleReactions`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/bubble.json`. Source: https://ui.anuragroy.dev/r/bubble.json.
- [Attachment](https://ui.anuragroy.dev/component/attachment.md): File and image attachment with upload state and actions. Imports `Attachment`, `AttachmentAction`, `AttachmentActions`, `AttachmentContent`, `AttachmentDescription`, `AttachmentGroup`, `AttachmentMedia`, `AttachmentTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/attachment.json`. Source: https://ui.anuragroy.dev/r/attachment.json.
- [Marker](https://ui.anuragroy.dev/component/marker.md): Status notes, date separators, and system rows. Imports `Marker`, `MarkerContent`, `MarkerIcon`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/marker.json`. Source: https://ui.anuragroy.dev/r/marker.json.
- [Prompt Input](https://ui.anuragroy.dev/component/prompt-input.md): Auto-growing composer with tools, model picker, and send/stop. Imports `PromptInput`, `PromptInputBody`, `PromptInputSubmit`, `PromptInputTextarea`, `PromptInputToolbar`, `PromptInputTools`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/prompt-input.json`. Source: https://ui.anuragroy.dev/r/prompt-input.json.
- [Questionnaire](https://ui.anuragroy.dev/component/questionnaire.md): Multi-step questions with single, multiple, and freeform answers. Imports `Questionnaire`, `QuestionnaireActions`, `QuestionnaireChoice`, `QuestionnaireChoices`, `QuestionnaireItem`, `QuestionnaireNext`, `QuestionnairePrevious`, `QuestionnaireProgress`, `QuestionnaireSubmit`, `QuestionnaireTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/questionnaire.json`. Source: https://ui.anuragroy.dev/r/questionnaire.json.
- [Streaming Response](https://ui.anuragroy.dev/component/streaming-response.md): Assistant answer with completion actions and sources. Imports `StreamingResponse`, `StreamingResponseAction`, `StreamingResponseActions`, `StreamingResponseContent`, `StreamingResponseSources`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/streaming-response.json`. Source: https://ui.anuragroy.dev/r/streaming-response.json.
- [Citations](https://ui.anuragroy.dev/component/citations.md): Inline citation markers and a collapsible source list. Imports `Citation`, `CitationIndex`, `CitationItem`, `CitationLink`, `CitationList`, `CitationTitle`, `CitationUrl`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/citations.json`. Source: https://ui.anuragroy.dev/r/citations.json.
- [Image Generation](https://ui.anuragroy.dev/component/image-generation.md): Generated image surface from queued work to a finished result. Imports `ImageGeneration`, `ImageGenerationActions`, `ImageGenerationLabel`, `ImageGenerationMedia`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/image-generation.json`. Source: https://ui.anuragroy.dev/r/image-generation.json.
- [Agent Loading](https://ui.anuragroy.dev/component/agent-loading.md): Shimmer, cycling phrases, progress, and pixel-grid waits. Imports `AgentLoading`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/agent-loading.json`. Source: https://ui.anuragroy.dev/r/agent-loading.json.
- [Agent Todo](https://ui.anuragroy.dev/component/agent-todo.md): Collapsible agent task plan with live status marks. Imports `AgentTodo`, `AgentTodoHeader`, `AgentTodoItem`, `AgentTodoList`, `AgentTodoProgress`, `AgentTodoTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/agent-todo.json`. Source: https://ui.anuragroy.dev/r/agent-todo.json.
- [Agent Activity](https://ui.anuragroy.dev/component/agent-activity.md): Expandable reasoning, search, code, and tool traces. Imports `AgentActivity`, `AgentActivityContent`, `AgentActivityItem`, `AgentActivityMeta`, `AgentActivityTrigger`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/agent-activity.json`. Source: https://ui.anuragroy.dev/r/agent-activity.json.
- [Tool Chip](https://ui.anuragroy.dev/component/tool-chip.md): Compact chips for tool calls and their status. Imports `ToolChip`, `ToolChipGroup`, `ToolChipLabel`, `ToolChipMeta`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/tool-chip.json`. Source: https://ui.anuragroy.dev/r/tool-chip.json.
- [Tool Result](https://ui.anuragroy.dev/component/tool-result.md): Collapsible execution output for tools and terminal work. Imports `ToolResult`, `ToolResultHeader`, `ToolResultOutput`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/tool-result.json`. Source: https://ui.anuragroy.dev/r/tool-result.json.
- [Tool Approval](https://ui.anuragroy.dev/component/tool-approval.md): Allow once, remember, or deny a paused tool call. Imports `ToolApproval`, `ToolApprovalButtons`, `ToolApprovalDescription`, `ToolApprovalDetails`, `ToolApprovalHeader`, `ToolApprovalTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/tool-approval.json`. Source: https://ui.anuragroy.dev/r/tool-approval.json.
- [Approval Card](https://ui.anuragroy.dev/component/approval-card.md): Human-in-the-loop decision surface for reviews and questions. Imports `ApprovalCard`, `ApprovalCardActions`, `ApprovalCardContent`, `ApprovalCardDescription`, `ApprovalCardHeader`, `ApprovalCardTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/approval-card.json`. Source: https://ui.anuragroy.dev/r/approval-card.json.
- [Code Block](https://ui.anuragroy.dev/component/code-block.md): Shiki-highlighted code surface with line numbers and copy. Imports `CodeBlock`, `CodeBlockContent`, `CodeBlockCopy`, `CodeBlockHeader`, `CodeBlockTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/code-block.json`. Source: https://ui.anuragroy.dev/r/code-block.json.
- [File Diff](https://ui.anuragroy.dev/component/file-diff.md): Shiki-highlighted added and removed lines with live change counts. Imports `FileDiff`, `FileDiffBody`, `FileDiffFilename`, `FileDiffHeader`, `FileDiffLine`, `FileDiffStats`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/file-diff.json`. Source: https://ui.anuragroy.dev/r/file-diff.json.
- [Recommendation Card](https://ui.anuragroy.dev/component/recommendation-card.md): Agent suggestion with a confidence meter and actions. Imports `RecommendationCard`, `RecommendationCardActions`, `RecommendationCardConfidence`, `RecommendationCardDescription`, `RecommendationCardTitle`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/recommendation-card.json`. Source: https://ui.anuragroy.dev/r/recommendation-card.json.
- [Context Card](https://ui.anuragroy.dev/component/context-card.md): Retrieved knowledge chunks with their sources. Imports `ContextCard`, `ContextCardContent`, `ContextCardGroup`, `ContextCardHeader`, `ContextCardMeta`, `ContextCardSource`. Install: `npx shadcn@latest add https://ui.anuragroy.dev/r/context-card.json`. Source: https://ui.anuragroy.dev/r/context-card.json.

## Libraries
- [utils](https://ui.anuragroy.dev/r/utils.json): Shared `cn()` helper. Pulled in automatically by almost every UI item.
- [highlight](https://ui.anuragroy.dev/r/highlight.json): Shiki helper used by `code-block` and `file-diff`. Dual-theme token colors.

## Optional
- [GitHub repository](https://github.com/anurag-roy/ui.anuragroy.dev): Source for the registry and this site.
- [Base UI](https://base-ui.com): Unstyled primitives these components wrap. Use `render`, not `asChild`.
- [shadcn registry docs](https://ui.shadcn.com/docs/registry): Format of `/r/*.json` and the CLI add flow.
- [HeroUI](https://heroui.com): Visual inspiration only — do not import `@heroui/react`.
