Keyframery

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/tabs

This copies two files into your project and adds the motion tokens to your global CSS:

components/keyframery/tabs.tsx
components/keyframery/primitives/tabs.tsx

UI 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

app/settings/page.tsx
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/all

Every 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

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.

On this page