Phaser scaffolding
Use this when you want a new Phaser game. The wizard clones Phaser-TypeScript-AI-First-Starter (Phaser 4 + TypeScript + Vite, hybrid composition: pure domain, feature ticks, scenes as views).
This is a second cloneable template, not a profile of the BoringStack fullstack
manifest. The game repo does not ship .tsforge/scaffold-manifest.json. tsforge
owns the clone descriptor (repo, git tag, gate).
What you get
Section titled “What you get”| Archetype | phaser |
| Clone | boringstack-xyz/Phaser-TypeScript-AI-First-Starter at a pinned tag (v0.1.6, overridable with --ref) |
| Demo | The playable WASD grid + pickups + S/R save stays. First features extend it. |
| Gate | bun run check |
| Boot | None — no Docker, no .env |
| Pack | The phaser ESLint pack auto-detects from the phaser dependency |
When it runs
Section titled “When it runs”tsforge scaffold --archetype phaser --dest ./my-gameOr interactively: /scaffold → Phaser → folder name.
Off a TTY there are no extra questions (same as Astro). --ref overrides the pin;
PHASER_TEMPLATE_REPO clones a local checkout instead of GitHub.
After it finishes, the first agent turn in that directory already has the
map — layers, generators (bun run new:feature|scene|module|content|port),
wire points (gameConfig.ts, WorldScene.setup.ts, composeRuntime.ts), the
reserved demo, and docs/ai/catalog.md. It must not /map or walk src/
to orient. It then plans the product (Phaser view intent: scene / feature /
module / content / port — not list/detail/form screens). Approve the plan and
tsforge generates + wires each slice, then fills against bun run check.
The starter’s Player / Grid / Wall / Movement / Hud / Save are reserved and will
be stripped if the planner tries to rebuild them.
tsforge --dir ./my-game --accept 'bun run check' "add a coin pickup"What it does, in order
Section titled “What it does, in order”- Clone the Phaser template at the pin, resolving HEAD into
.tsforge/scaffold.jsonwith"archetype": "phaser". - Stamp identity —
package.jsonnameand the HTML title from the folder name. - Catalog — if
docs/ai/catalog.mdis missing, runbun run catalog(never fails the scaffold). - Hand off — no compose, no boot.
bun run checkis the gate. The next tsforge session injects the architecture brief immediately.
See also BoringStack scaffolding.