One command. A polished hero. Live in seconds.

In good company

1. 01

   Scaffold the project

   Init command creates the folder structure, installs deps and sets up tsconfig. Under 10 seconds on a warm network.

   bash

   npx create-blockus-app my-project
   ✓ Installed 8 dependencies
   ✓ Configured tsconfig.json

2. 02

   Register your first block

   Add metadata and a dynamic import entry — the registry builder handles the rest automatically.

   ts

   // content/blocks-metadata.ts
   {
     id: "hero-01",
     category: "hero",
     name: "Centered hero",
     license: "free"
   }

3. 03

   Preview in the browser

   The dev server hot-reloads on every save. The iframe preview renders your block in isolation with no layout interference.

   bash

   pnpm dev
   
     Local:   http://localhost:3000
     Preview: /preview/hero-01

4. 04

   Build the registry

   One command re-derives imports, emits registry.json and writes per-block files under public/r. Consumers install directly via shadcn.

   bash

   pnpm registry:build
   ✓ Emitted 15 blocks
   ✓ Wrote public/r/*.json