# create-ultimate

```sh
bunx create-ultimate myapp && cd myapp && bun run setup && bun run dev
```

`bun run setup` is the scaffold's own script (`bin/setup.ts`, run by Bun — the same command in
PowerShell, cmd and bash) and it is not optional: `x new` writes files and installs nothing, so
`x dev` on the tree it just wrote fails with `X_BUILD_FAILED`. The script installs the dependencies, writes `.env.development.local`, generates and applies the first migration, seeds,
and writes `x.manifest.json` — six commands, idempotent, so it is safe to re-run after every pull.

Thin wrapper over `x new` — same templates, same flags, no second code path.

| Flag | Does |
|---|---|
| `--dir <path>` | parent directory (default: cwd) |
| `--no-example` | skip the example feature slice |
| `--no-git` | leave a bare directory; do not `git init` and commit |
| `--dry-run` | print the file list, write nothing |
| `--force` | write into a directory that already exists |
| `--json` | machine-readable output |

What you get: `apps/web/{site,app,api,shared}`, `apps/admin` with MCP on, `apps/{mobile,desktop}`
placeholders, `packages/{domain,db,i18n,ui,mcp}`, `bin/`, `docker/`, `app.config.ts` — a landing
page at 0kb JS, a streaming authed dashboard, a seeded database and `x verify` green.