Create a Project

The Hype CLI scaffolds a new Hype Stack project with one command.

Usage

npx @hype-stack/cli create

The CLI walks you through a few prompts:

1. Project name and directory - where to scaffold it
2. Code editor - cursor, claude, windsurf, or copilot (writes the right editor config)
3. Color theme - default, slate, rose, emerald, violet, amber, ocean, zinc-mono, crimson, or midnight

create clones the base template, the empty canvas. It does not pick a starter or install feature packs. Add those after with the template and compose commands, then run onboard to fill in your .env and start the database.

What gets scaffolded

After the CLI finishes, you get:

my-app/
  apps/
    backend/     # Hono API with Prisma, Kysely
    frontend/    # React SPA with TanStack Router, Tailwind
  packages/      # Shared types, utils, configs
  docker-compose.yml
  nx.json
  pnpm-workspace.yaml
  stack.json

The stack.json file tracks the project's apps, paths, and installed packs:

{
  "name": "my-app",
  "installedPacks": []
}

After scaffolding

Install dependencies and start the stack:

cd my-app
pnpm dev

If you opted into Docker services and migrations during create, Postgres, Valkey, and RustFS are already running. If not, start them with docker compose up -d from apps/backend.

See Fastest Template for the full first-run walkthrough.