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 baseshadcn'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.jsonThe @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}.jsonIt writes this to 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/dialogWhat it adds
- The component's file in
components/kino/, beside shadcn/ui'scomponents/ui/, so Kino never replaces a component you have. - The parts it builds on, in
lib/:motion.tsxandmotion-tokens.ts, which every component moves with, and one file for each family, such aspopup.tsfor popovers andmenu.tsxfor menus. - Its npm packages:
@base-ui/react, and for most componentsmotionandclass-variance-authority. - Kino's
themeitem: 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
--destructivered:--successgreen and--warningamber for icons, fills and tints, and--success-foregroundand--warning-foregroundfor text in them, in light and dark. The CLI adds them to your theme's:rootand.dark, and as Tailwind colours, such astext-success.
Set any of them on <html>, or on any element to change one part of a page:
<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:
: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:
@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:
- Install the npm packages it lists.
- Copy its files, and the files of the parts it builds on, to the paths shown.
- 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:
.root { isolation: isolate;}