Installation

Install Animate UI and animate your shadcn/ui components.

Install the packages

npm install @animate-ui/react motion
pnpm add @animate-ui/react motion
yarn add @animate-ui/react motion
bun add @animate-ui/react motion

@animate-ui/react uses the primitive library your components already depend on (radix-ui, @base-ui/react or react-aria-components).

Animate your components

Run the CLI in your project. It finds your shadcn/ui components through components.json, swaps their primitive imports for Animate UI's and removes the CSS animation classes Motion replaces.

npx @animate-ui/cli@latest animate all
pnpm dlx @animate-ui/cli@latest animate all
yarn dlx @animate-ui/cli@latest animate all
bun x @animate-ui/cli@latest animate all

Animate one component at a time by naming it, and preview the changes with --dry-run:

npx @animate-ui/cli@latest animate accordion --dry-run
pnpm dlx @animate-ui/cli@latest animate accordion --dry-run
yarn dlx @animate-ui/cli@latest animate accordion --dry-run
bun x @animate-ui/cli@latest animate accordion --dry-run

Change the pace (optional)

Every animation follows the same timing. Wrap your app in AnimateUIProvider to make it all faster or slower:

import { AnimateUIProvider } from '@animate-ui/react/provider';

export default function Layout({ children }: { children: React.ReactNode }) {
  return <AnimateUIProvider tempo={1.2}>{children}</AnimateUIProvider>;
}

tempo multiplies every duration: 0.8 feels crisper, 1.2 more relaxed. Without the provider, the defaults apply.

Choose how checks animate (optional)

Checks draw themselves: their stroke is drawn when they're checked and erased when they're unchecked, like a pen. Only checking and unchecking animate them: a check already there when the page loads, or when a dialog, a menu or a list opens, shows at rest. checkAnimation="pop" makes them pop instead: in from half their size out of a light blur, and back out. In a single selection (a select, a combobox, a menu's radio items), the check then glides from the item it leaves to the chosen one.

<AnimateUIProvider checkAnimation="pop">{children}</AnimateUIProvider>

It applies to every check inside: checkboxes, and the checks of menus, selects, comboboxes and lists. A check's own animation prop wins over it. Nested providers keep what they don't set: an inner <AnimateUIProvider tempo={0.8}> keeps the outer checkAnimation.

Built by Skyleen. The source code is available on GitHub.

Last updated: 10/27/2026