Skip to contentKino
Skip to Content
Docs

Installation

What your project needs, how the shadcn CLI adds a component, and what it changes in your project.

Before you start

Kino installs into a React project set up for shadcn/ui: Tailwind CSS v4, and a components.json in the project's root. If you have one, go on to Add a component.

To start a new project on Base UI, run this and pick your framework:

npx shadcn@latest init --base base

shadcn's installation guides (opens in a new tab) cover each framework. A project set up with Radix works too: the CLI adds @base-ui/react beside it.

Add a component

Every component's page has its command, which installs it from its URL:

npx shadcn@latest add https://kinoui.com/r/button.json

The @kino namespace

To add components by name, add the namespace to your project once:

npx shadcn@latest registry add @kino=https://kinoui.com/r/{name}.json

It writes this to components.json:

components.json
{  "registries": {    "@kino": "https://kinoui.com/r/{name}.json"  }}

Then add any component by its name, several at a time if you like:

npx shadcn@latest add @kino/button @kino/dialog

What it adds

  • The component's file in components/kino/, beside shadcn/ui's components/ui/, so Kino never replaces a component you have.
  • The parts it builds on, in lib/: motion.tsx and motion-tokens.ts, which every component moves with, and one file for each family, such as popup.ts for popovers and menu.tsx for menus.
  • Its npm packages: @base-ui/react, and for most components motion and class-variance-authority.
  • Kino's theme item: rules at the end of your global CSS, for the feels, the density tokens and the shape tokens, and the success and warning colours in your theme.

The Installation section on each component's page, after the examples, lists exactly what its command adds. When a file is already in your project, the CLI asks before it replaces it.

Global CSS

Each component that moves, or reads Kino's sizes or corners, installs the theme item, which adds its rules to the file that tailwind.css names in components.json. They set how every component moves, how much room it takes, how round its corners are and the colours of success and warning:

  • The feels time each motion role, under data-feel. Crisp applies unless you set another.
  • The density tokens size controls, rows and surfaces, under data-density. Balanced applies unless you set another.
  • The shape tokens round the corners, under data-shape. Standard applies unless you set another.
  • The status colours, beside shadcn's --destructive red: --success green and --warning amber for icons, fills and tints, and --success-foreground and --warning-foreground for text in them, in light and dark. The CLI adds them to your theme's :root and .dark, and as Tailwind colours, such as text-success.

Set any of them on <html>, or on any element to change one part of a page:

tsx
<html lang='en' data-feel='calm' data-density='snug' data-shape='round'>

To change a value, add a rule of your own below Kino's rules:

css
:root {  --motion-press-scale: 0.95;}

Don't edit Kino's rules themselves, because the CLI writes them again whenever it adds a component that uses them. These are all of them:

globals.css
@theme inline {  --color-success: var(--success);  --color-success-foreground: var(--success-foreground);  --color-warning: var(--warning);  --color-warning-foreground: var(--warning-foreground);}:root {  --success: oklch(0.58 0.14 152);  --success-foreground: oklch(0.46 0.11 152);  --warning: oklch(0.64 0.145 60);  --warning-foreground: oklch(0.5 0.11 55);}.dark {  --success: oklch(0.72 0.16 152);  --success-foreground: oklch(0.8 0.13 152);  --warning: oklch(0.8 0.15 75);  --warning-foreground: oklch(0.86 0.12 80);}:root, [data-feel='crisp'] {  --motion-press-duration: 400ms;  --motion-press-easing: linear(0, 0.2531, 0.5773, 0.7868, 0.8991, 0.9541, 0.9797, 0.9912, 0.9963, 0.9984, 0.9993, 1, 1);  --motion-press-fade-easing: linear(0, 0.2531, 0.5773, 0.7868, 0.8991, 0.9541, 0.9797, 0.9912, 0.9963, 0.9984, 0.9993, 1, 1);  --motion-enter-duration: 500ms;  --motion-enter-easing: linear(0, 0.1316, 0.3585, 0.5628, 0.7162, 0.8217, 0.8906, 0.934, 0.9607, 0.9769, 0.9865, 0.9922, 0.9955, 0.9974, 0.9985, 0.9992, 1);  --motion-enter-fade-easing: linear(0, 0.1316, 0.3585, 0.5628, 0.7162, 0.8217, 0.8906, 0.934, 0.9607, 0.9769, 0.9865, 0.9922, 0.9955, 0.9974, 0.9985, 0.9992, 1);  --motion-exit-duration: 400ms;  --motion-exit-easing: linear(0, 0.2531, 0.5773, 0.7868, 0.8991, 0.9541, 0.9797, 0.9912, 0.9963, 0.9984, 0.9993, 1, 1);  --motion-exit-fade-easing: linear(0, 0.2531, 0.5773, 0.7868, 0.8991, 0.9541, 0.9797, 0.9912, 0.9963, 0.9984, 0.9993, 1, 1);  --motion-layout-duration: 650ms;  --motion-layout-easing: linear(0, 0.0832, 0.2471, 0.4185, 0.5681, 0.6879, 0.7789, 0.8458, 0.8937, 0.9275, 0.9509, 0.967, 0.978, 0.9853, 0.9903, 0.9936, 0.9958, 0.9972, 0.9982, 0.9988, 0.9992, 1);  --motion-layout-fade-easing: linear(0, 0.0832, 0.2471, 0.4185, 0.5681, 0.6879, 0.7789, 0.8458, 0.8937, 0.9275, 0.9509, 0.967, 0.978, 0.9853, 0.9903, 0.9936, 0.9958, 0.9972, 0.9982, 0.9988, 0.9992, 1);  --motion-morph-duration: 700ms;  --motion-morph-easing: linear(0, 0.0721, 0.2191, 0.3786, 0.5232, 0.6435, 0.7385, 0.8109, 0.8649, 0.9044, 0.9328, 0.9532, 0.9675, 0.9776, 0.9846, 0.9894, 0.9928, 0.9951, 0.9967, 0.9977, 0.9985, 0.999, 1);  --motion-morph-fade-easing: linear(0, 0.0721, 0.2191, 0.3786, 0.5232, 0.6435, 0.7385, 0.8109, 0.8649, 0.9044, 0.9328, 0.9532, 0.9675, 0.9776, 0.9846, 0.9894, 0.9928, 0.9951, 0.9967, 0.9977, 0.9985, 0.999, 1);  --motion-draw-duration: 600ms;  --motion-draw-easing: linear(0, 0.1061, 0.3018, 0.4922, 0.6466, 0.7613, 0.8422, 0.8975, 0.9342, 0.9582, 0.9737, 0.9836, 0.9898, 0.9937, 0.9961, 0.9976, 0.9985, 0.9991, 1, 1);  --motion-draw-fade-easing: linear(0, 0.1061, 0.3018, 0.4922, 0.6466, 0.7613, 0.8422, 0.8975, 0.9342, 0.9582, 0.9737, 0.9836, 0.9898, 0.9937, 0.9961, 0.9976, 0.9985, 0.9991, 1, 1);  --motion-press-scale: 0.97;}[data-feel='calm'] {  --motion-press-duration: 500ms;  --motion-press-easing: linear(0, 0.1495, 0.3955, 0.6061, 0.7562, 0.8542, 0.9148, 0.9512, 0.9724, 0.9846, 0.9914, 0.9953, 0.9974, 0.9986, 0.9992, 1, 1);  --motion-press-fade-easing: linear(0, 0.1495, 0.3955, 0.6061, 0.7562, 0.8542, 0.9148, 0.9512, 0.9724, 0.9846, 0.9914, 0.9953, 0.9974, 0.9986, 0.9992, 1, 1);  --motion-enter-duration: 700ms;  --motion-enter-easing: linear(0, 0.0791, 0.2369, 0.4041, 0.5522, 0.6723, 0.7649, 0.8339, 0.884, 0.9198, 0.945, 0.9625, 0.9746, 0.9829, 0.9885, 0.9923, 0.9949, 0.9966, 0.9977, 0.9985, 0.999, 1, 1);  --motion-enter-fade-easing: linear(0, 0.0791, 0.2369, 0.4041, 0.5522, 0.6723, 0.7649, 0.8339, 0.884, 0.9198, 0.945, 0.9625, 0.9746, 0.9829, 0.9885, 0.9923, 0.9949, 0.9966, 0.9977, 0.9985, 0.999, 1, 1);  --motion-exit-duration: 500ms;  --motion-exit-easing: linear(0, 0.1495, 0.3955, 0.6061, 0.7562, 0.8542, 0.9148, 0.9512, 0.9724, 0.9846, 0.9914, 0.9953, 0.9974, 0.9986, 0.9992, 1, 1);  --motion-exit-fade-easing: linear(0, 0.1495, 0.3955, 0.6061, 0.7562, 0.8542, 0.9148, 0.9512, 0.9724, 0.9846, 0.9914, 0.9953, 0.9974, 0.9986, 0.9992, 1, 1);  --motion-layout-duration: 800ms;  --motion-layout-easing: linear(0, 0.0507, 0.1614, 0.2915, 0.4192, 0.5342, 0.6326, 0.714, 0.7796, 0.8317, 0.8723, 0.9038, 0.9279, 0.9462, 0.96, 0.9704, 0.9781, 0.9839, 0.9882, 0.9913, 0.9937, 0.9954, 0.9966, 0.9975, 0.9982, 0.9987, 1);  --motion-layout-fade-easing: linear(0, 0.0507, 0.1614, 0.2915, 0.4192, 0.5342, 0.6326, 0.714, 0.7796, 0.8317, 0.8723, 0.9038, 0.9279, 0.9462, 0.96, 0.9704, 0.9781, 0.9839, 0.9882, 0.9913, 0.9937, 0.9954, 0.9966, 0.9975, 0.9982, 0.9987, 1);  --motion-morph-duration: 850ms;  --motion-morph-easing: linear(0, 0.0471, 0.1512, 0.2754, 0.399, 0.512, 0.6101, 0.6924, 0.7598, 0.814, 0.857, 0.8907, 0.9169, 0.9371, 0.9526, 0.9644, 0.9733, 0.9801, 0.9852, 0.989, 0.9918, 0.9939, 0.9955, 0.9967, 0.9976, 0.9982, 0.9987, 1);  --motion-morph-fade-easing: linear(0, 0.0471, 0.1512, 0.2754, 0.399, 0.512, 0.6101, 0.6924, 0.7598, 0.814, 0.857, 0.8907, 0.9169, 0.9371, 0.9526, 0.9644, 0.9733, 0.9801, 0.9852, 0.989, 0.9918, 0.9939, 0.9955, 0.9967, 0.9976, 0.9982, 0.9987, 1);  --motion-draw-duration: 750ms;  --motion-draw-easing: linear(0, 0.064, 0.1977, 0.3472, 0.4867, 0.6061, 0.7032, 0.7795, 0.838, 0.8821, 0.9148, 0.9389, 0.9564, 0.969, 0.9781, 0.9846, 0.9892, 0.9924, 0.9947, 0.9963, 0.9974, 0.9982, 0.9988, 0.9991, 1);  --motion-draw-fade-easing: linear(0, 0.064, 0.1977, 0.3472, 0.4867, 0.6061, 0.7032, 0.7795, 0.838, 0.8821, 0.9148, 0.9389, 0.9564, 0.969, 0.9781, 0.9846, 0.9892, 0.9924, 0.9947, 0.9963, 0.9974, 0.9982, 0.9988, 0.9991, 1);  --motion-press-scale: 0.98;}[data-feel='lively'] {  --motion-press-duration: 450ms;  --motion-press-easing: linear(0, 0.348, 0.8208, 1.0574, 1.0915, 1.0486, 1.0086, 0.9923, 0.9921, 0.9966, 0.9998, 1, 1.0006, 1.0002, 1);  --motion-press-fade-easing: linear(0, 0.348, 0.8208, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1);  --motion-enter-duration: 400ms;  --motion-enter-easing: linear(0, 0.1858, 0.5115, 0.7844, 0.9515, 1.0272, 1.046, 1.0381, 1.0232, 1.0104, 1.0025, 0.9988, 1);  --motion-enter-fade-easing: linear(0, 0.1858, 0.5115, 0.7844, 0.9515, 1, 1, 1, 1, 1, 1, 1, 1);  --motion-exit-duration: 400ms;  --motion-exit-easing: linear(0, 0.2175, 0.5207, 0.7361, 0.8631, 0.9317, 0.9668, 0.9842, 0.9926, 0.9966, 0.9984, 0.9993, 1);  --motion-exit-fade-easing: linear(0, 0.2175, 0.5207, 0.7361, 0.8631, 0.9317, 0.9668, 0.9842, 0.9926, 0.9966, 0.9984, 0.9993, 1);  --motion-layout-duration: 550ms;  --motion-layout-easing: linear(0, 0.1195, 0.3552, 0.5913, 0.7781, 0.9047, 0.9789, 1.0152, 1.0275, 1.0271, 1.0212, 1.0142, 1.0083, 1.004, 1.0013, 0.9999, 1, 1);  --motion-layout-fade-easing: linear(0, 0.1195, 0.3552, 0.5913, 0.7781, 0.9047, 0.9789, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1);  --motion-morph-duration: 750ms;  --motion-morph-easing: linear(0, 0.0933, 0.2963, 0.5237, 0.7258, 0.8803, 0.9831, 1.0409, 1.065, 1.0669, 1.0566, 1.0415, 1.0265, 1.0139, 1.0049, 0.9992, 0.9963, 1, 0.9957, 0.9966, 0.9976, 0.9986, 0.9993, 0.9999, 1);  --motion-morph-fade-easing: linear(0, 0.0933, 0.2963, 0.5237, 0.7258, 0.8803, 0.9831, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1);  --motion-draw-duration: 500ms;  --motion-draw-easing: linear(0, 0.1316, 0.3585, 0.5628, 0.7162, 0.8217, 0.8906, 0.934, 0.9607, 0.9769, 0.9865, 0.9922, 0.9955, 0.9974, 0.9985, 0.9992, 1);  --motion-draw-fade-easing: linear(0, 0.1316, 0.3585, 0.5628, 0.7162, 0.8217, 0.8906, 0.934, 0.9607, 0.9769, 0.9865, 0.9922, 0.9955, 0.9974, 0.9985, 0.9992, 1);  --motion-press-scale: 0.96;}:root, [data-density='balanced'] {  --control-height: 2.25rem;  --control-height-xs: 1.5rem;  --control-height-sm: 2rem;  --control-height-lg: 2.5rem;  --control-padding: 0.625rem;  --row-padding: 1rem;  --surface-padding: 1rem;  --surface-padding-lg: 1.25rem;  --surface-gap: 1rem;}[data-density='snug'] {  --control-height: 2rem;  --control-height-xs: 1.5rem;  --control-height-sm: 1.75rem;  --control-height-lg: 2.25rem;  --control-padding: 0.5rem;  --row-padding: 0.625rem;  --surface-padding: 0.75rem;  --surface-padding-lg: 1rem;  --surface-gap: 0.75rem;}[data-density='airy'] {  --control-height: 2.5rem;  --control-height-xs: 1.75rem;  --control-height-sm: 2.25rem;  --control-height-lg: 2.75rem;  --control-padding: 0.875rem;  --row-padding: 1.25rem;  --surface-padding: 1.25rem;  --surface-padding-lg: 1.5rem;  --surface-gap: 1.25rem;}:root, [data-shape='standard'] {  --control-radius: var(--radius-md);  --control-radius-sm: min(var(--radius-md), 10px);  --control-radius-xs: min(var(--radius-md), 8px);  --control-radius-capped: var(--radius-md);  --list-radius: var(--radius-lg);  --item-radius: max(0px, calc(var(--radius-md) - 2px));  --surface-radius: var(--radius-xl);  --surface-radius-lg: var(--radius-2xl);}[data-shape='round'] {  --control-radius: 9999px;  --control-radius-sm: 9999px;  --control-radius-xs: 9999px;  --control-radius-capped: 1.25rem;  --list-radius: 1.25rem;  --item-radius: calc(var(--list-radius) - 4px);  --surface-radius: 1.5rem;  --surface-radius-lg: 2rem;}

Icons

Components draw their icons from the library that iconLibrary names in components.json: Lucide, Tabler, Phosphor, Hugeicons or Remix Icon. The CLI writes each icon from that library when it adds the component.

To switch libraries later, change iconLibrary, install the new library's package, and add your components again with --overwrite. That replaces any edits you made to their files.

Install by hand

Each component's Installation section has a Manual tab with every step:

  1. Install the npm packages it lists.
  2. Copy its files, and the files of the parts it builds on, to the paths shown.
  3. Paste the CSS rules at the end of your global CSS, once.

The files import from @/components and @/lib, as shadcn/ui's default aliases do, and draw their icons from Lucide. If your aliases or your icon library differ, change the imports to match. The CLI does both for you.

Troubleshooting

The CLI says Unknown registry "@kino". Your project doesn't have the namespace yet. Add it, or install from the URL on the component's page.

A component has no height, or snaps without moving. Kino's rules aren't in the CSS your app loads. Check that tailwind.css in components.json names your global CSS file, then add the component again, or paste the rules at the end of that file.

Icons come from the wrong library. The CLI writes icons when it adds a component, so components added before you changed iconLibrary keep the old ones. Add them again with --overwrite.

A popup opens behind part of the page. Base UI renders popups at the end of <body>, so an element of yours with a high z-index can sit over them. Base UI's quick start (opens in a new tab) recommends giving your app's root element its own stacking context:

css
.root {  isolation: isolate;}