Motion Primitives Grid Notes
Composable, minimal React motion building blocks — animated groups, text effects, morphing dialogs, docks and carousels — built on Motion and Tailwind CSS.
Install and prerequisites
npx shadcn@latest add "https://motion-primitives.com/c/text-effect.json"motionlucide-reactRequires Tailwind CSS, motion, lucide-react and a cn utility in @/lib/utils. Items install via direct .json URLs.
Framework setup
Word-by-word TextEffect with reduced-motion fallback
Animate by per="word" or per="line" (avoid per="char" on long headings) and keep the full text accessible.
"use client";
import { TextEffect } from "@/components/ui/text-effect";
export function AnimatedLead({ children }: { children: string }) {
return (
<TextEffect per="word" preset="fade-in-blur" className="text-lg text-muted-foreground">
{children}
</TextEffect>
);
}Gotchas for agents
Install by full JSON URL
Motion Primitives components are hosted at
https://motion-primitives.com/c/<name>.json. Pass the full URL tonpx shadcn@latest addunless you have configured a custom@motion-primitivesentry incomponents.json.Beta API surface
Because components are copied directly into your repo and the library is in beta, pin
motion(14.x) and review prop types when adding new primitives that share internal helpers.MorphingPopover / MorphingDialog layoutId collisions
Components that rely on Motion's shared
layoutIdwill cross-animate across the page if rendered multiple times without a uniqueuniqueIdor<LayoutGroup id={...}>wrapper.
Accessibility and reduced motion
Reduced motion
Wrap primitives in <MotionConfig reducedMotion="user"> so preset="fade-in-blur" or slide variants drop their spatial movement under reduced motion.
Keyboard and screen readers
For MorphingDialog and Accordion, verify Escape closes modals, focus returns to the trigger on close, and aria-expanded / aria-controls attributes stay intact.
More Grid Notes
- shadcn/uiCopy-in React components built on Base UI or Radix UI and Tailwind CSS v4, plus an official MCP server that searches and installs from any namespaced registry.
- React BitsAnimated text effects, shaders, cursors and interactive backgrounds installed as source code in four variants (`-JS-CSS`, `-JS-TW`, `-TS-CSS`, `-TS-TW`).
- Magic UIOver 150 animated landing-page components — marquees, Bento grids, shimmer buttons, globes and device mocks — built with React, Tailwind CSS and Motion.
- Aceternity UIDramatic landing-page hero sections, 3D card perspectives, spotlights, beams and macbook scroll effects built with React 19, Tailwind CSS v4 and Motion.
- coss uiOpen-source React components built on Base UI (`@base-ui/react`) and Tailwind CSS v4 (formerly Origin UI; `originui.com` redirects here).
- Fancy ComponentsExperimental, playful React components — letter swaps, variable-font hover effects, physics gravity, gooey SVG filters and image trails — built with Tailwind CSS and Motion.



