Install animated UI SDK components in three steps
Add animated components for Vercel's UI SDK to a React app with the shadcn CLI. Works with Next.js, Vite and React Router; no animation library needed.
You need React 19, Tailwind CSS v4 and a project set up for the shadcn CLI, so components.json exists. If it doesn't, run npx shadcn@latest init first.
Prefer to let your coding agent do it? Use the skill or the prompt.
Install one component
Add a component
npx shadcn@latest add @keyframery/tabsThis copies two files into your project and adds the motion tokens to your global CSS:
components/keyframery/tabs.tsx
components/keyframery/primitives/tabs.tsxUI SDK (@ui-sdk/react and @ui-sdk/core) is installed for you, pinned to the version the components are tested with. Keyframery is in shadcn's registry index, so the CLI finds @keyframery with nothing to set up first.
You should see a new components/keyframery/ folder.
Use it
import { Tabs, TabsList, TabsPanel, TabsPanels, TabsTab } from "@/components/keyframery/tabs"
export default function Settings() {
return (
<Tabs defaultValue="general">
<TabsList>
<TabsTab value="general">General</TabsTab>
<TabsTab value="billing">Billing</TabsTab>
</TabsList>
<TabsPanels>
<TabsPanel value="general">…</TabsPanel>
<TabsPanel value="billing">…</TabsPanel>
</TabsPanels>
</Tabs>
)
}You should see the key stretch across to the tab you click, and the panel slide in from that side.
Pick how it moves
Springy is the default. To change the feel of every component at once, set a motion style on <html>:
<html data-motion="calm">The values are calm, springy, snappy and playful. More in Motion styles.
Install everything
npx shadcn@latest add @keyframery/allEvery component, in one command. Your bundler only ships the ones you import.
Framework notes
Works in the App Router, with server rendering. Components that hold state are marked "use client" already.
With cacheComponents turned on, the three date components need one extra step. See Troubleshooting.
What the CLI adds to your CSS
The first component you install adds a small block of motion tokens to your global stylesheet: one speed setting, three easings, and the four motion styles. Every component reads them.
:root {
--kf-speed: 1;
--ease-house: cubic-bezier(0.22, 1, 0.36, 1);
--ease-spring: linear(/* a spring, written as a CSS easing */);
--ease-pop: linear(/* a livelier spring for small payoffs */);
}Next
- Already using UI SDK? Swap the import and keep your styling.
- Something not working? Troubleshooting.
Questions
Do I need to install UI SDK first?
No. The CLI installs @ui-sdk/react and @ui-sdk/core for you, pinned to the version the components are tested with.
Why does the CLI say Unknown registry "@keyframery"?
Your shadcn CLI didn't find @keyframery in shadcn's registry index. Register it once with npx shadcn@latest registry add "@keyframery=https://keyframery.com/r/{name}.json", then install again.
Will it overwrite my shadcn/ui components?
No. Keyframery installs into components/keyframery/. Nothing in components/ui/ is touched.
Introduction
Keyframery is the animated component library for Vercel's UI SDK: finished React components with motion in plain CSS, installed with one shadcn command.
Swap the import
Every Keyframery primitive has the same parts and props as its UI SDK component. Change one import line and the component animates. Your markup and styles stay.