Installation

What your project needs, how to copy a component into it, and the dependencies it may need.

Requirements

  • React and Next.js App Router (Vite and other React + Tailwind setups also work)
  • TypeScript
  • Tailwind CSS
  • clsx and tailwind-merge, for the cn helper
  • motion, only for components that import it

Versions the catalog uses

The catalog itself is built and previewed with these versions, from its package.json.

json
{
  "react": "^19.0.0",
  "react-dom": "^19.0.0",
  "next": "^15.5.28",
  "motion": "^12.42.2",
  "tailwindcss": "^3.4.16",
  "typescript": "^5.7.2"
}

Add the cn helper

Copied components import cn from @/lib/utils. Install its two packages first.

bash
npm install clsx tailwind-merge

Create src/lib/utils.ts

Create this file. If the same function is already there, do not add a second one.

ts
import { clsx, type ClassValue } from "clsx"
import { twMerge } from "tailwind-merge"

export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs))
}

Copy a component into your project

  1. Open the item page in the catalog and watch the live preview.
  2. Press Copy for Cursor. The clipboard gets the instructions, the live preview URL, the files, and the npm install line together.
  3. Paste all of it into a new Cursor Agent chat or Claude chat, and add where the section should go.
text
Put this section on app/page.tsx.
Keep the files and import paths from the copy, and run the npm install line.
Do not redesign it.

Components are free to copy with no account. Blocks and Templates need a 30-Day Pass or Lifetime.

Dependencies

Install only the packages in the copy's npm install line. react, react-dom, and next are left out, because your app already has them.

A component that animates with motion imports it from "motion/react". In that case the install line includes motion.

bash
npm install motion

Install lucide-react only when the copied files import it.

More detail is in What your project needs and Install the dependencies.