Docs
Two things to know: how to point your project at this registry, and what's inside it. Everything is consumed through the standard shadcn CLI.
Configure your project
Add the registry to your components.json under registries, then expose the bearer token via env. Install the theme before components.
12345678910'Authorization': 'Bearer ${KAOTYPR_UI_REGISTRY_TOKEN}'}}}}
The {name} placeholder is replaced by the CLI when you install @kaotypr-ui/<component>. Headers are sent with every fetch — keep the token out of source control.
KAOTYPR_UI_REGISTRY_TOKEN=your-bearer-token-hereAsk the registry owner for the bearer token. The CLI reads env vars referenced as ${NAME} in the headers block.
- 01Add the registries blockDrop the @kaotypr-ui entry into components.json — alongside any other registries you already use.
- 02Export the tokenSet KAOTYPR_UI_REGISTRY_TOKEN in your shell or .env.local before invoking the CLI.
- 03Install the themepnpm dlx shadcn@latest add @kaotypr-ui/kaotypr-theme. Import ../lib/kaotypr-ui.css in app/globals.css after Tailwind and tw-animate-css, before your overrides. This also works for src/app with src/lib; adjust for a custom lib alias.
- 04Load fonts and install componentsLoad Fredoka, Fira Code, and Schoolbell as --font-fredoka, --font-fira-code, and --font-schoolbell (or use approved brand fonts). Install components, then wire ThemeProvider and DensityProvider when needed. See the README for Next.js setup and safe theme updates.
What's available
71 items total — 67 components, 2 hooks, 1 lib utilities, 1 theme. Search by name, copy the install command, or grab everything in one go.
pnpm dlx shadcn@latest add @kaotypr-ui/utils @kaotypr-ui/use-copy-to-clipboard @kaotypr-ui/use-mobile @kaotypr-ui/accordion @kaotypr-ui/alert @kaotypr-ui/alert-dialog @kaotypr-ui/aspect-ratio @kaotypr-ui/avatar @kaotypr-ui/badge @kaotypr-ui/breadcrumb @kaotypr-ui/button @kaotypr-ui/button-group @kaotypr-ui/calendar @kaotypr-ui/card @kaotypr-ui/carousel @kaotypr-ui/chart @kaotypr-ui/checkbox @kaotypr-ui/collapsible @kaotypr-ui/color-picker @kaotypr-ui/combobox @kaotypr-ui/command @kaotypr-ui/context-menu @kaotypr-ui/copy-button @kaotypr-ui/data-combobox @kaotypr-ui/data-multi-combobox @kaotypr-ui/data-table @kaotypr-ui/date-picker @kaotypr-ui/date-range-picker @kaotypr-ui/density @kaotypr-ui/dialog @kaotypr-ui/direction @kaotypr-ui/drawer @kaotypr-ui/dropdown-menu @kaotypr-ui/empty @kaotypr-ui/field @kaotypr-ui/hover-card @kaotypr-ui/input @kaotypr-ui/input-group @kaotypr-ui/input-otp @kaotypr-ui/item @kaotypr-ui/json-viewer @kaotypr-ui/kbd @kaotypr-ui/label @kaotypr-ui/menubar @kaotypr-ui/native-select @kaotypr-ui/navigation-menu @kaotypr-ui/pagination @kaotypr-ui/popover @kaotypr-ui/progress @kaotypr-ui/radio-group @kaotypr-ui/resizable @kaotypr-ui/scroll-area @kaotypr-ui/select @kaotypr-ui/separator @kaotypr-ui/sheet @kaotypr-ui/sidebar @kaotypr-ui/skeleton @kaotypr-ui/slider @kaotypr-ui/sonner @kaotypr-ui/spinner @kaotypr-ui/switch @kaotypr-ui/table @kaotypr-ui/tabs @kaotypr-ui/textarea @kaotypr-ui/theme @kaotypr-ui/time-picker @kaotypr-ui/timeline @kaotypr-ui/toggle @kaotypr-ui/toggle-group @kaotypr-ui/tooltip- Utilities
@kaotypr-ui/utilsUtility functions including cn() for merging class names.
pnpm dlx shadcn@latest add @kaotypr-ui/utils - Use Copy To Clipboard
@kaotypr-ui/use-copy-to-clipboardCopy text to the clipboard and track a temporary copied state.
pnpm dlx shadcn@latest add @kaotypr-ui/use-copy-to-clipboard - Use Mobile
@kaotypr-ui/use-mobileDetect whether the viewport is narrower than the mobile breakpoint.
pnpm dlx shadcn@latest add @kaotypr-ui/use-mobile - Accordion
@kaotypr-ui/accordionOrganize content into expandable sections with triggers and panels.
pnpm dlx shadcn@latest add @kaotypr-ui/accordion - Alert
@kaotypr-ui/alertDisplay a message with a title, description, optional action, and status variant.
pnpm dlx shadcn@latest add @kaotypr-ui/alert - Alert Dialog
@kaotypr-ui/alert-dialogAsk for confirmation in a modal dialog with action and cancel controls.
pnpm dlx shadcn@latest add @kaotypr-ui/alert-dialog - Aspect Ratio
@kaotypr-ui/aspect-ratioKeep content within a container at a specified width-to-height ratio.
pnpm dlx shadcn@latest add @kaotypr-ui/aspect-ratio - Avatar
@kaotypr-ui/avatarDisplay a user image with a fallback, badge, or grouped avatars.
pnpm dlx shadcn@latest add @kaotypr-ui/avatar - Badge
@kaotypr-ui/badgeShow a compact label with a choice of visual variants.
pnpm dlx shadcn@latest add @kaotypr-ui/badge - Breadcrumb
@kaotypr-ui/breadcrumbShow a navigation trail with links, separators, and the current page.
pnpm dlx shadcn@latest add @kaotypr-ui/breadcrumb - Button
@kaotypr-ui/buttonTrigger an action with configurable visual and size variants.
pnpm dlx shadcn@latest add @kaotypr-ui/button - Button Group
@kaotypr-ui/button-groupGroup related buttons and labels with optional separators.
pnpm dlx shadcn@latest add @kaotypr-ui/button-group - Calendar
@kaotypr-ui/calendarSelect dates in a calendar with customizable day rendering.
pnpm dlx shadcn@latest add @kaotypr-ui/calendar - Card
@kaotypr-ui/cardCompose a content container with header, title, description, action, body, and footer.
pnpm dlx shadcn@latest add @kaotypr-ui/card - Carousel
@kaotypr-ui/carouselPresent a scrollable sequence of items with previous and next controls.
pnpm dlx shadcn@latest add @kaotypr-ui/carousel - Chart
@kaotypr-ui/chartWrap Recharts charts with configured colors, tooltips, and legends.
pnpm dlx shadcn@latest add @kaotypr-ui/chart - Checkbox
@kaotypr-ui/checkboxSelect or clear an individual option with a checkbox.
pnpm dlx shadcn@latest add @kaotypr-ui/checkbox - Collapsible
@kaotypr-ui/collapsibleReveal or hide content using a trigger.
pnpm dlx shadcn@latest add @kaotypr-ui/collapsible - Color Picker
@kaotypr-ui/color-pickerChoose a hexadecimal color using a picker, text input, or swatches, with optional alpha.
pnpm dlx shadcn@latest add @kaotypr-ui/color-picker - Combobox
@kaotypr-ui/comboboxCompose searchable selection controls with lists, groups, and chips.
pnpm dlx shadcn@latest add @kaotypr-ui/combobox - Command
@kaotypr-ui/commandBuild a searchable command list or command dialog with grouped actions.
pnpm dlx shadcn@latest add @kaotypr-ui/command - Context Menu
@kaotypr-ui/context-menuShow a menu of actions, choices, and submenus from a context trigger.
pnpm dlx shadcn@latest add @kaotypr-ui/context-menu - Copy Button
@kaotypr-ui/copy-buttonCopy a string to the clipboard and briefly show a confirmation icon.
pnpm dlx shadcn@latest add @kaotypr-ui/copy-button - Data Combobox
@kaotypr-ui/data-comboboxSelect one option from searchable data, with grouping, loading, and optional responsive drawer presentation.
pnpm dlx shadcn@latest add @kaotypr-ui/data-combobox - Data Multi Combobox
@kaotypr-ui/data-multi-comboboxSelect multiple options from searchable data, with selection badges, grouping, and loading support.
pnpm dlx shadcn@latest add @kaotypr-ui/data-multi-combobox - Data Table
@kaotypr-ui/data-tableRender typed data and column definitions with optional pagination, row selection, and column resizing.
pnpm dlx shadcn@latest add @kaotypr-ui/data-table - Date Picker
@kaotypr-ui/date-pickerChoose a date from a calendar, optionally including time and accepting Date or string values.
pnpm dlx shadcn@latest add @kaotypr-ui/date-picker - Date Range Picker
@kaotypr-ui/date-range-pickerChoose a start and end date from a calendar, optionally including times.
pnpm dlx shadcn@latest add @kaotypr-ui/date-range-picker - Density
@kaotypr-ui/densityProvide comfortable or compact density to a subtree and toggle between the two.
pnpm dlx shadcn@latest add @kaotypr-ui/density - Dialog
@kaotypr-ui/dialogPresent content in a modal dialog with trigger, close control, header, and footer.
pnpm dlx shadcn@latest add @kaotypr-ui/dialog - Direction
@kaotypr-ui/directionProvide and read text direction for a component subtree.
pnpm dlx shadcn@latest add @kaotypr-ui/direction - Drawer
@kaotypr-ui/drawerPresent content in a drawer with overlay, trigger, and close controls.
pnpm dlx shadcn@latest add @kaotypr-ui/drawer - Dropdown Menu
@kaotypr-ui/dropdown-menuShow actions, checkboxes, radio choices, and submenus in a dropdown.
pnpm dlx shadcn@latest add @kaotypr-ui/dropdown-menu - Empty
@kaotypr-ui/emptyCompose an empty state with media, title, description, and supporting content.
pnpm dlx shadcn@latest add @kaotypr-ui/empty - Field
@kaotypr-ui/fieldArrange form controls with labels, descriptions, errors, and grouped fieldsets.
pnpm dlx shadcn@latest add @kaotypr-ui/field - Hover Card
@kaotypr-ui/hover-cardShow supplementary content in a card when interacting with a trigger.
pnpm dlx shadcn@latest add @kaotypr-ui/hover-card - Input
@kaotypr-ui/inputEnter a value in a styled HTML input.
pnpm dlx shadcn@latest add @kaotypr-ui/input - Input Group
@kaotypr-ui/input-groupCombine an input or textarea with addons, buttons, and text.
pnpm dlx shadcn@latest add @kaotypr-ui/input-group - Input Otp
@kaotypr-ui/input-otpEnter a one-time code in grouped slots with optional separators.
pnpm dlx shadcn@latest add @kaotypr-ui/input-otp - Item
@kaotypr-ui/itemCompose a list item with media, content, actions, header, and footer.
pnpm dlx shadcn@latest add @kaotypr-ui/item - Json Viewer
@kaotypr-ui/json-viewerInspect JSON objects in an expandable tree with optional line numbers, truncation, and copy controls.
pnpm dlx shadcn@latest add @kaotypr-ui/json-viewer - Kbd
@kaotypr-ui/kbdDisplay keyboard keys and groups of shortcuts.
pnpm dlx shadcn@latest add @kaotypr-ui/kbd - Label
@kaotypr-ui/labelAssociate a styled label with a form control.
pnpm dlx shadcn@latest add @kaotypr-ui/label - Menubar
@kaotypr-ui/menubarCompose a horizontal menu bar with actions, choices, and submenus.
pnpm dlx shadcn@latest add @kaotypr-ui/menubar - Native Select
@kaotypr-ui/native-selectChoose an option using a styled native select with option groups.
pnpm dlx shadcn@latest add @kaotypr-ui/native-select - Navigation Menu
@kaotypr-ui/navigation-menuCompose site navigation with links, triggers, and expandable content.
pnpm dlx shadcn@latest add @kaotypr-ui/navigation-menu - Pagination
@kaotypr-ui/paginationCompose page navigation links with previous, next, and ellipsis controls.
pnpm dlx shadcn@latest add @kaotypr-ui/pagination - Popover
@kaotypr-ui/popoverDisplay anchored content with an optional title and description.
pnpm dlx shadcn@latest add @kaotypr-ui/popover - Progress
@kaotypr-ui/progressShow the completion of a task as a progress bar.
pnpm dlx shadcn@latest add @kaotypr-ui/progress - Radio Group
@kaotypr-ui/radio-groupChoose one option from a group of radio buttons.
pnpm dlx shadcn@latest add @kaotypr-ui/radio-group - Resizable
@kaotypr-ui/resizableArrange panels with draggable handles for resizing.
pnpm dlx shadcn@latest add @kaotypr-ui/resizable - Scroll Area
@kaotypr-ui/scroll-areaContain overflowing content with styled scrollbars.
pnpm dlx shadcn@latest add @kaotypr-ui/scroll-area - Select
@kaotypr-ui/selectChoose one option from a dropdown list with groups and labels.
pnpm dlx shadcn@latest add @kaotypr-ui/select - Separator
@kaotypr-ui/separatorVisually divide content horizontally or vertically.
pnpm dlx shadcn@latest add @kaotypr-ui/separator - Sheet
@kaotypr-ui/sheetPresent content in a panel that slides in over the page.
pnpm dlx shadcn@latest add @kaotypr-ui/sheet - Sidebar
@kaotypr-ui/sidebarCompose a responsive application sidebar with navigation groups, menus, and controls.
pnpm dlx shadcn@latest add @kaotypr-ui/sidebar - Skeleton
@kaotypr-ui/skeletonShow a placeholder surface while content is loading.
pnpm dlx shadcn@latest add @kaotypr-ui/skeleton - Slider
@kaotypr-ui/sliderSelect a value or range using draggable slider thumbs.
pnpm dlx shadcn@latest add @kaotypr-ui/slider - Sonner
@kaotypr-ui/sonnerRender Sonner toast notifications using the current theme.
pnpm dlx shadcn@latest add @kaotypr-ui/sonner - Spinner
@kaotypr-ui/spinnerShow a rotating indicator for an ongoing operation.
pnpm dlx shadcn@latest add @kaotypr-ui/spinner - Switch
@kaotypr-ui/switchTurn a setting on or off with a switch.
pnpm dlx shadcn@latest add @kaotypr-ui/switch - Table
@kaotypr-ui/tableCompose a table with headers, rows, cells, footer, and caption.
pnpm dlx shadcn@latest add @kaotypr-ui/table - Tabs
@kaotypr-ui/tabsSwitch between panels using a list of tab triggers.
pnpm dlx shadcn@latest add @kaotypr-ui/tabs - Textarea
@kaotypr-ui/textareaEnter multiline text in a styled textarea.
pnpm dlx shadcn@latest add @kaotypr-ui/textarea - Theme
@kaotypr-ui/themeProvide light and dark theme settings and a toggle using next-themes.
pnpm dlx shadcn@latest add @kaotypr-ui/theme - Time Picker
@kaotypr-ui/time-pickerChoose a time with configurable units, steps, bounds, and optional meridiem.
pnpm dlx shadcn@latest add @kaotypr-ui/time-picker - Timeline
@kaotypr-ui/timelineArrange dated events vertically or horizontally with titles and descriptions.
pnpm dlx shadcn@latest add @kaotypr-ui/timeline - Toggle
@kaotypr-ui/toggleSwitch a single button between pressed and unpressed states.
pnpm dlx shadcn@latest add @kaotypr-ui/toggle - Toggle Group
@kaotypr-ui/toggle-groupSelect one or more toggle buttons in a group.
pnpm dlx shadcn@latest add @kaotypr-ui/toggle-group - Tooltip
@kaotypr-ui/tooltipShow brief contextual content anchored to a trigger.
pnpm dlx shadcn@latest add @kaotypr-ui/tooltip - Kaotypr Theme
@kaotypr-ui/kaotypr-themeInstall the canonical Kaotypr tokens, variants, density rules, and skeleton animation once before adding components.
pnpm dlx shadcn@latest add @kaotypr-ui/kaotypr-theme