Installation

After forking the template, install dependencies with Vite+ and start the local docs app.

vp install
vp dev

Open the local URL from Vite+ to preview your docs, registry catalog, and install pages.

Customize the Registry

Update registry/config.ts before publishing your fork. This file controls the public registry identity, namespace, description, homepage, repository URL, and generated install URLs.

Add Registry Items

Scaffold new installable items under registry/items/** with the starter script.

bun --bun ./scripts/new.ts --type registry:ui --name example-card --description "A compact card component."

You can also run bun --bun ./scripts/new.ts for an interactive prompt. Use --target for registry:page, registry:file, custom alias installs such as @ui/ai/prompt-input.tsx, or targeted registry:item files.

The scaffold creates the item source, _registry.mdx metadata and usage docs, and an optional _preview.tsx preview. Public documentation pages live directly in registry/docs/.

Verify Changes

Run the registry doctor after item changes, check the files you touched, and build before publishing.

bun --bun ./scripts/doctor.ts
vp check --fix <touched-file>
vp build