create-x4

Scaffold a full-stack TypeScript monorepo with x4.

Quick Start

bunx create-x4 my-app
cd my-app
cp .env.example .env.local
bun db:push
bun dev

Or with npm:

npx create-x4 my-app

What You Get

• API — Hono + tRPC v11 (port 3002)
• Web — Next.js 15 App Router (port 3000)
• Mobile — Expo + React Native
• Desktop — Electron
• Marketing — Next.js static site (port 3001)
• Docs — Fumadocs (port 3003)
• Database — Neon Postgres + Drizzle ORM
• Auth — Better Auth with bearer tokens
• AI — Vercel AI SDK + Claude
• CI/CD — GitHub Actions with Neon branching

Options

Usage: create-x4 [project-name] [options]

Arguments:
  project-name          Directory and monorepo name (e.g., my-app)

Options:
  -s, --scope <scope>   npm scope for packages (default: @{project-name})
  --bundle-id <id>      Reverse-domain prefix (default: com.{project-name})
  --no-mobile           Exclude Expo mobile app
  --no-desktop          Exclude Electron desktop app
  --no-marketing        Exclude marketing site
  --no-docs             Exclude docs site
  --no-ai               Exclude AI integration package
  --pm <manager>        Package manager: bun|npm|yarn|pnpm (default: auto-detect)
  --no-git              Skip git initialization
  --no-install          Skip dependency installation
  --branch <branch>     Template branch (default: main)
  -v, --verbose         Verbose output
  --version             Print version
  -h, --help            Print help

Examples

Create with a custom npm scope:

bunx create-x4 my-app --scope @acme

Web + API only (no mobile, desktop, marketing, or docs):

bunx create-x4 my-app --no-mobile --no-desktop --no-marketing --no-docs

Skip dependency installation:

bunx create-x4 my-app --no-install

License

MIT