create-kompo

Scaffold a new Kompo project in seconds.

---

Usage

Create a new Kompo project with your preferred package manager:

# pnpm (recommended)
pnpm create kompo@latest my-app

# npm
npm create kompo@latest my-app

# yarn
yarn create kompo my-app

# bun
bun create kompo my-app

With a template

pnpm create kompo@latest my-app --template nextjs.tailwind.blank

Non-interactive

pnpm create kompo@latest my-app --pm pnpm --template nextjs.shadcn.blank

What it does

1. Creates a monorepo project structure (apps/, libs/, packages/)
2. Configures your workspace (pnpm-workspace.yaml or package.json#workspaces)
3. Installs @kompojs/core, @kompojs/blueprints, and Turbo
4. Runs kompo add app to scaffold your first application
5. Initializes a git repository

Packages

Package	Description
@kompojs/create-kompo	Core scaffolding logic
create-kompo	npm wrapper (npm create kompo)
create-kompojs	npm wrapper (npm create kompojs)

Development

git clone https://github.com/kompojs/create-kompo.git
cd create-kompo
pnpm install
pnpm build

# Test locally
node packages/create/dist/index.js my-test-app

Related Repositories

Repository	Description
kompojs/kompo	CLI, kit, config, core runtime
kompojs/blueprints	Blueprint packages
kompojs/workbench	Visual architecture explorer

License

MIT © 2026 SmarttDev and Kompo contributors