Requirements

A block is standalone TypeScript — no runtime, no wrapper library. But it drops into a project that already has these three things. Check them off before you install anything.

• React 19

  Blocks are written for the current React. Next.js 15+ ships it.

• Tailwind CSS v4

  Styling is Tailwind utilities only — v4, with the new @theme setup.

• shadcn/ui, initialized

  Blocks build on shadcn primitives (Button, Card…) and your CSS tokens. This is the step people miss.

Initialize shadcn/ui first

If your project doesn't have a components.jsonyet, shadcn isn't set up. Run this from your project root and follow the prompts — it creates the config, the CSS variables and the cn() helper every block relies on:

npx shadcn@latest init

New to shadcn? See the official installation guide. Once components.json exists, you're ready.