scn-stack

Commands

Command	Description
`npx create-scn-stack`	Scaffold a new registry project
`npx create-scn-stack init`	Add a registry to an existing project
`npx create-scn-stack add-component <name>`	Add a component to an existing registry
`npx create-scn-stack add-hook <name>`	Add a hook to an existing registry
`npx create-scn-stack add-block <name>`	Add a block to an existing registry

When you run npx create-scn-stack, you'll be guided through these options:

Prompt	Description	Default
Registry name	Identifier for your registry (e.g., `my-ui`)	`my-ui`
Project location	Folder to create the registry in	`./<registry-name>`
Style	shadcn/ui style variant	`New York`
Homepage	URL where the registry will be hosted	`https://<name>.com`
Framework	Web framework for the project	`Next.js`
Documentation	Docs engine to include	`Fumadocs`
Starter components	Pre-built example components	`Button, Card, Badge`
Namespace	Registry namespace for `@name/component` installs	`@<name>`
Package manager	Package manager to use	Auto-detected
AI skills	Install shadcn skill + registry skill	`Yes`

All prompts can be pre-filled via flags. Use --yes to skip prompts entirely.

npx create-scn-stack my-ui --yes
npx create-scn-stack my-ui --framework nextjs --docs fumadocs --pm pnpm
npx create-scn-stack my-ui --yes --no-skills

Flag	Values
`--name <name>`	Registry name
`--directory <path>`	Project location
`--style <style>`	`new-york` \| `default`
`--homepage <url>`	Registry homepage URL
`--framework <fw>`	`nextjs` \| `vite` \| `react-router` \| `tanstack-start`
`--docs <engine>`	`fumadocs` \| `mintlify` \| `starlight` \| `none`
`--components <set>`	`essentials` \| `minimal` \| `none`
`--namespace <ns>`	Namespace (e.g., `@my-ui`)
`--pm <pm>`	`pnpm` \| `npm` \| `yarn` \| `bun`
`--skills`	Include AI skills
`--no-skills`	Skip AI skills
`-y, --yes`	Skip all prompts, use defaults
`-h, --help`	Show help

Add a component to an existing registry project:

npx create-scn-stack add-component input
npx create-scn-stack add-component dialog -d "A modal dialog component."

This creates:

Flag	Description
`--description, -d`	Component description

Add a hook to an existing registry project:

npx create-scn-stack add-hook use-toggle
npx create-scn-stack add-hook use-media-query -d "A media query hook."

This creates:

Hook names must start with use-.

Flag	Description
`--description, -d`	Hook description

Add a block to an existing registry project:

npx create-scn-stack add-block login-form
npx create-scn-stack add-block dashboard-header -d "A dashboard header block."

This creates:

Flag	Description
`--description, -d`	Block description

Framework	Description
Next.js	App Router with Tailwind v4. Recommended for most registries.
Vite	React + Vite with Tailwind v4. Lightweight, fast builds.
React Router	React Router v7 with SSR support.
TanStack Start	TanStack Start with file-based routing.

Engine	Description
Fumadocs	Standard for shadcn registries. Full docs with MDX, search, dark mode. Requires Next.js.
Mintlify	Hosted docs platform. Works with any framework.
Starlight	Astro-based docs. Separate `docs/` directory. Works with any framework.
None	Registry only, no documentation site.

Style	Description
New York	Default shadcn/ui style. Smaller, compact components.
Default	Original shadcn/ui style. Slightly larger components.

Set	Components	Includes
Essentials	Button, Card, Badge	Source files, registry entries, doc pages with live previews
Minimal	Button only	Source file, registry entry, doc page with preview
None	Empty registry	Just the scaffold, add your own

Skill	What it does
shadcn skill	Installs the official shadcn skill via `skills add shadcn/ui`. Gives AI assistants knowledge of shadcn components, CLI, theming, and registry authoring.
Registry skill	Generates `.agents/skills/registry/SKILL.md` — teaches AI how to add components, hooks, blocks, write docs, update registry.json, and follow conventions for your specific project.