Goal: Generate a monorepo with typescript-fullstack, install dependencies, and pass the preset verification harness.
Support label: Requires validation — see /families and Verification.
Prerequisites
- Bun installed (pnpm optional via
--pm=pnpmwhen matrix shows support) - Arche source checkout (this repo or a fork)
- Empty parent directory for output (
--dir=../projects)
Scaffold
terminal
bun run dev:cli -- my-app --yes --preset=typescript-fullstack --dir=../projects
Common toggles:
| Flag | Effect |
|---|---|
--worker | Adds apps/worker + BullMQ (needs Redis) |
--no-showcase | Strips demo routes; skips SHOWCASE.mdx |
--ci | GitHub Actions workflow |
--docker | Compose files for local Postgres/Redis |
--bundle=product,ai | Capability bundles (validated by registry) |
Generated shape
terminal
apps/web Next.js App Router
apps/server Express + tRPC + Better Auth
apps/worker optional BullMQ
packages/trpc client contract only
packages/store Prisma
packages/auth Better AuthRead Architecture for boundaries and Generated output for agent files.
Verify
terminal
cd ../projects/my-app
bun install
bun run cici runs lint, typecheck, and tests defined for the preset. If a step fails, open root AGENTS.md — it lists the exact scripts and env files.
Local dev (after copying .env.example):
terminal
bun run db:migrate
bun devCommon failures
| Symptom | Fix |
|---|---|
DATABASE_URL missing | Copy .env.example; use Neon or local Postgres |
| tRPC errors in browser | Set NEXT_PUBLIC_API_URL to the API origin |
| Turbo cache confusion | Run bun run build once clean; check turbo.json exists |
| Mixed lockfiles | Pick Bun or pnpm; do not commit both lockfiles |