Project scaffolding

Basic usage

bunx create-patties@latest my-app

This creates my-app/ from the base template, runs bun install, and initializes a git repository with an initial commit.

Options

bunx create-patties@latest my-app \
  --template claude|codex|none \
  --target   bun|edge \
  --deploy   cloudflare|vercel|deno|netlify|bun|none \
  --no-install \
  --no-git

• --template selects an agent-platform overlay layered on top of the base app. claude adds a CLAUDE.md, codex adds an AGENTS.md, none skips the overlay. Default: claude.
• --target sets the runtime target written into patties.config.ts (bun or edge). Default: bun.
• --deploy records the intended deploy target. Default: none.
• --no-install skips bun install.
• --no-git skips git init and the initial commit.

What the scaffolder produces

The base template is a minimal Patties app: app/routes/, app/islands/, app/server.ts, patties.config.ts, tsconfig.json, and a .gitignore. The scaffolder then:

• writes a fresh package.json with the project name and patties / react / react-dom pinned to current versions
• rewrites patties.config.ts to match the chosen --target
• copies the selected agent overlay (_claude or _codex) over the project
• installs dependencies and commits, unless --no-install / --no-git

Examples

bunx create-patties@latest my-app
bunx create-patties@latest my-app --template codex
bunx create-patties@latest my-app --template none --no-git
bunx create-patties@latest my-app --target edge --deploy cloudflare