インストール

プロジェクトに必要なもの、コンポーネントのコピー手順、必要になる依存パッケージ。

必要なもの

  • React と Next.js の App Router(Vite など、ほかの React + Tailwind 構成でも使えます)
  • TypeScript
  • Tailwind CSS
  • cn ヘルパー用の clsx と tailwind-merge
  • motion(読み込んでいるコンポーネントだけ)

カタログが使っているバージョン

カタログ自体は、次のバージョンで作り、プレビューしています(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"
}

cn ヘルパーを置く

コピーしたコンポーネントは、@/lib/utils から cn を読み込みます。先に 2 つのパッケージを入れます。

bash
npm install clsx tailwind-merge

src/lib/utils.ts を作る

次のファイルを作ります。同じ関数がすでにあるなら、新しく足さないでください。

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

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

コンポーネントをプロジェクトにコピーする

  1. カタログで項目のページを開き、ライブプレビューで動きを確かめます。
  2. Copy for Cursor を押します。指示文、プレビューの URL、ファイル、npm install の行がまとめてコピーされます。
  3. 新しい Cursor Agent か Claude のチャットに全文を貼り、置き場所を書き足します。
text
このセクションを app/page.tsx に置いてください。
コピーにあるファイルと import のパスはそのまま使い、npm install の行を実行してください。
デザインは変えないでください。

コンポーネントのコピーはアカウントなしで無料です。Blocks と Templates には 30日パスか Lifetime が必要です。

依存パッケージ

入れるのは、コピーの npm install の行にあるパッケージだけです。react、react-dom、next はアプリに入っている前提なので、行には出てきません。

motion で動かすコンポーネントは、"motion/react" から読み込みます。その場合は、install の行に motion が入ります。

bash
npm install motion

lucide-react は、コピーしたファイルが読み込んでいるときだけ入れます。

詳しくはプロジェクトに必要なものと依存パッケージを入れるにあります。