Docs

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).

terminal
# new Next.js app
pnpm create next-app@latest my-app

# shadcn setup (adds components.json and lib/utils.ts)
pnpm dlx shadcn@latest init

Install a component

Run the CLI with the component's registry URL. Swap pnpm dlx for npx, yarn dlx or bunx --bun if you prefer.

terminal
pnpm dlx shadcn@latest add https://makeui.xyz/r/spring-switch.json

The file lands in components/ui/spring-switch.tsx and motion is installed if you do not have it. Import it and use it:

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

terminal
pnpm add motion lucide-react clsx tailwind-merge
lib/utils.ts
import { 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:

app/globals.css
@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:

app/providers.tsx
"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.

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.

terminal
pnpm dlx shadcn@latest add https://makeui.xyz/r/hero-section.json
pnpm dlx shadcn@latest add https://makeui.xyz/r/paper-plane-send.json

Use 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:

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.md

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.