Get started with makeui
makeui is a free library of animated React components you copy into your own project. This page covers setup, installing a component, theming and motion.
Introduction
Most component libraries ship as a package you depend on and fight with. makeui does the opposite: one command copies the source file into your project, so you can read it, change it and keep it. It is built on the shadcn/ui registry format, Tailwind CSS and Motion.
Requirements
You need a React project with Tailwind CSS and the shadcn setup (it adds the cn helper at @/lib/utils).
# new Next.js app
pnpm create next-app@latest my-app
# shadcn setup (adds components.json and lib/utils.ts)
pnpm dlx shadcn@latest initInstall a component
Run the CLI with the component's registry URL. Swap pnpm dlx for npx, yarn dlx or bunx --bun if you prefer.
pnpm dlx shadcn@latest add https://makeui.xyz/r/spring-switch.jsonThe file lands in components/ui/spring-switch.tsx and motion is installed if you do not have it. Import it and use it:
import { SpringSwitch } from "@/components/ui/spring-switch"
export default function Page() {
return <SpringSwitch label="Notifications" />
}Every component manages its own state out of the box. To drive one yourself, pass the controlled prop (value, checked, liked or copied) and listen with onChange.
Manual install
No CLI? Install the dependencies, make sure cn exists, then copy the source from the component page into components/ui.
pnpm add motion lucide-react clsx tailwind-mergeimport { clsx, type ClassValue } from "clsx"
import { twMerge } from "tailwind-merge"
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs))
}Theming
Components use Tailwind's neutral palette with dark: variants, so they follow your dark mode. To match your brand, change the classes right in the file. It is your code. If you use Tailwind v4 with a class-based dark mode, add this once:
@custom-variant dark (&:where(.dark, .dark *));Motion and accessibility
Springs and timings are tuned so you do not have to. Switches, tabs and buttons are realbutton elements with the right role and aria-* attributes and visible focus rings. For looping effects, wrap your app with MotionConfig to respect the visitor's reduced motion setting:
"use client"
import { MotionConfig } from "motion/react"
export function Providers({ children }: { children: React.ReactNode }) {
return <MotionConfig reducedMotion="user">{children}</MotionConfig>
}Components
7 components so far, with more on the way.
- ViewSpring SwitchAn accessible toggle switch for React with a spring thumb and a press-down feel. Keyboard and screen reader friendly.
- ViewLike ButtonA like button with a heart pop and a particle burst, built with Motion and Tailwind CSS. No extra assets.
- ViewNumber RollAn odometer-style animated number for React. Each digit scrolls to its value, perfect for counters and stats.
- ViewCopy ButtonA copy-to-clipboard button for React where the icon morphs into a check and the label rolls to Copied.
- ViewDockA macOS-style dock for React. Icons grow smoothly as the pointer nears them. Bring your own SVG icons.
- ViewOTP InputA one-time code input for React. Paste, autofill and backspace work, with success and error states.
- ViewSliding TabsSegmented tabs for React with a pill that slides to the active tab. Arrow-key navigation included.
Pages and illustrations
Besides components, makeui has page sections (hero, CTA, footer, with contact on the way) and illustrations (small animated micro-interactions). They install the same way, into components/blocks and components/illustrations.
pnpm dlx shadcn@latest add https://makeui.xyz/r/hero-section.json
pnpm dlx shadcn@latest add https://makeui.xyz/r/paper-plane-send.jsonUse with AI
Every component, page section and illustration has a plain .md file with the description, install command, usage and full source. On its page, press Copy .md and paste it into any AI chat, or use Open in to send it to Claude, ChatGPT, v0 or Cursor. The same file is served at a stable URL:
https://makeui.xyz/md/components/spring-switch.md
https://makeui.xyz/md/pages/hero-section.md
https://makeui.xyz/md/illustrations/paper-plane-send.mdSearch
Press ⌘K (or Ctrl K, or /) anywhere to search every component, page section and illustration, and to jump to any page.
FAQ
What is makeui?
makeui is a free library of copy-paste animated React components for Next.js, Tailwind CSS and shadcn/ui. Each component is a single file with the motion already tuned, and you own the code once it is in your project.
Is makeui free?
Yes. Every component is free and open source. You can support the project from the Support button in the navbar.
How do I install a makeui component?
Run the shadcn CLI with the component's registry URL, for example: pnpm dlx shadcn@latest add https://makeui.xyz/r/spring-switch.json. The CLI copies the source into components/ui and installs the dependencies.
Does makeui work without Next.js?
Yes. The components are plain React with Tailwind CSS classes and the Motion library, so they work in Vite, Remix, Astro with React, or any React 18+ setup that uses Tailwind.
Which animation library does makeui use?
Motion (the successor to Framer Motion), imported from motion/react. Small effects use CSS transitions.
Do the components support dark mode and reduced motion?
Components use Tailwind's dark: variants and neutral palette, so they follow your dark mode setup. Looping animations pause when the visitor prefers reduced motion.
Can I use makeui in commercial projects?
Yes. The code is yours to use, change and ship in personal and commercial projects.