Create a Project

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

CLI map

Usage

npx @hype-stack/cli create

The CLI walks you through a few prompts:

1. Project name and directory - where to scaffold it
2. AI editors - cursor, t3code, claude, codex, copilot, opencode, windsurf (tick every one your team uses)
3. Frontend look - a color theme and how round the corners should be
4. Admin, mobile, and extension look - one question each, "copy the frontend settings?", answered yes by default

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 (both commands offer it at the end of a run).

Theming every app

The project ships four themable surfaces: the customer-facing frontend, the internal admin dashboard, the Expo mobile app, and the browser extension. Each carries its own theme and corner radius. The frontend section asks for both values. Then admin, mobile, and extension each open with "copy the frontend settings?", which is what most people want, so accepting all three is three keypresses. Say no to any of them and you get that app's own theme and radius pickers. Sections only appear for apps your project has.

Themes are color only and radius is shape only, so switching palette never reshapes your buttons and cards. The same theme catalog drives all four apps; the CLI converts the tokens to the format each app uses (the mobile app's NativeWind stylesheet takes HSL channels, the others take OKLCH).

Every answer has a flag, which is how the preview site's copy-command button reproduces what you saw on screen:

npx @hype-stack/cli create my-app --theme ocean --radius 0.75rem --admin-theme midnight --mode dark

A flag skips its question. Anything you leave out is still prompted for, so you can pin just the theme and pick the rest interactively. The same flags work on compose and template.

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
    mobile/      # Expo app with expo-router, NativeWind
    extension/   # Browser extension with Vite, 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.