@pylonsync/create-pylon 0.3.51 → 0.3.54

package/bin/create-pylon.js

@@ -2,60 +2,176 @@
 /**
  * @pylonsync/create-pylon — scaffold a new Pylon app.
  *
- * Run via `npm create @pylonsync/pylon@latest [name]` (or yarn/pnpm/bun
- * create @pylonsync/pylon).
+ * Run via `npm create @pylonsync/pylon@latest [name]` (or
+ * yarn/pnpm/bun create @pylonsync/pylon).
  *
- * Generates a workspace with three packages under apps/* + packages/*:
- *   - apps/api   — Pylon backend (schema + functions/* handlers).
- *   - apps/web   — Next.js 16 + React 19 + Tailwind v4 frontend.
- *   - packages/ui — shared shadcn-style UI primitives consumed by web.
+ * Picks one or more platforms (web, mobile, expo) and a template
+ * (barebones, todo, …). Each platform shares the same Pylon backend
+ * under apps/api so `bun run dev` brings the whole project up.
  *
- * Node-runnable (no Bun required) so `npm create` works for every
- * package manager. Uses only Node-builtin APIs — no runtime deps.
+ * Templates live as real files under ../templates/<scope>/<template>.
+ * The scaffolder walks each requested template dir, substitutes
+ * placeholders, and writes the result. Keeping them on disk (instead
+ * of as inline strings in this file) is what stopped 0.3.50's tab-
+ * mangling regression class — there is no JS template-literal layer
+ * to corrupt.
+ *
+ * Node-runnable, no Bun required. Uses only Node-builtin APIs (no
+ * runtime deps): npm/yarn/pnpm/bun's `create` runners just need a
+ * working node binary.
  */
 
-import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import {
+	cpSync,
+	existsSync,
+	mkdirSync,
+	readFileSync,
+	readdirSync,
+	statSync,
+	writeFileSync,
+	renameSync,
+} from "node:fs";
 import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { createInterface } from "node:readline/promises";
 import { stdin, stdout, exit, argv, cwd } from "node:process";
 
+// ---------------------------------------------------------------------------
+// Locate templates relative to this script (works whether installed via
+// npm, run from a clone, or invoked through `npx -p @pylonsync/create-pylon`).
+// ---------------------------------------------------------------------------
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES = resolve(HERE, "..", "templates");
+
 // ---------------------------------------------------------------------------
 // Version pin — every generated dep references this version of @pylonsync/*.
-// Bumped via the workspace's release-please flow (same version as the rest
-// of the pylon stack).
+// Read from this package's own package.json so the value follows the rest
+// of the workspace automatically (release.sh bumps every package.json in
+// lockstep). Hard-coding it here was a drift bug we hit historically.
 // ---------------------------------------------------------------------------
 
-const PYLON_VERSION = "0.3.22";
+const PYLON_VERSION = JSON.parse(
+	readFileSync(resolve(HERE, "..", "package.json"), "utf8"),
+).version;
+
+// ---------------------------------------------------------------------------
+// Templates + platforms registry
+//
+// Each template declares which platforms it supports — `b2b` is web/mac
+// only because the demo flow (org switcher, member invite, RBAC admin
+// panel) is desktop-shaped and porting it to mobile would be busy work
+// without value. Pick a different template if you want mobile.
+// ---------------------------------------------------------------------------
+
+const PLATFORMS_AVAILABLE = ["web", "ios", "mac", "expo"];
+
+const TEMPLATE_REGISTRY = {
+	barebones: {
+		blurb: "Single entity, list + create. The smallest working app.",
+		platforms: ["web", "ios", "mac", "expo"],
+	},
+	todo: {
+		blurb: "CRUD + drag-reorder + optimistic mutations.",
+		platforms: ["web", "ios", "mac", "expo"],
+	},
+	b2b: {
+		blurb: "Multi-tenant SaaS: orgs, members, roles, RBAC policies.",
+		platforms: ["web", "mac"],
+	},
+	consumer: {
+		blurb: "Social feed: profiles, posts, likes, follows.",
+		platforms: ["web", "ios", "mac", "expo"],
+	},
+	chat: {
+		blurb: "Realtime messaging: rooms, presence, live message feed.",
+		platforms: ["web", "ios", "mac", "expo"],
+	},
+};
+const TEMPLATES_AVAILABLE = Object.keys(TEMPLATE_REGISTRY);
 
 // ---------------------------------------------------------------------------
-// CLI args + interactive prompt
+// CLI args + interactive prompts
 // ---------------------------------------------------------------------------
 
 const args = argv.slice(2);
 let projectName = args.find((a) => !a.startsWith("--"));
 
 const flags = {
-	pm: args.find(
-		(a) => a === "--bun" || a === "--pnpm" || a === "--yarn" || a === "--npm",
-	)?.slice(2),
+	pm: pickValue(args, "--bun", "--pnpm", "--yarn", "--npm")?.replace(/^--/, ""),
+	template: takeValue(args, "--template"),
+	platforms: takeValue(args, "--platforms"),
 	skipInstall: args.includes("--skip-install"),
 	help: args.includes("--help") || args.includes("-h"),
 };
 
+function takeValue(arr, name) {
+	const flagWithEq = arr.find((a) => a.startsWith(name + "="));
+	if (flagWithEq) return flagWithEq.slice(name.length + 1);
+	const idx = arr.indexOf(name);
+	if (idx >= 0 && idx + 1 < arr.length && !arr[idx + 1].startsWith("--")) {
+		return arr[idx + 1];
+	}
+	return undefined;
+}
+
+function pickValue(arr, ...candidates) {
+	for (const c of candidates) {
+		if (arr.includes(c)) return c;
+	}
+	return undefined;
+}
+
 if (flags.help) {
-	process.stdout.write(`\nUsage: npm create @pylonsync/pylon [name] [--bun|--pnpm|--yarn|--npm] [--skip-install]\n\n`);
+	const tmplLines = Object.entries(TEMPLATE_REGISTRY).map(
+		([k, v]) => `    ${k.padEnd(10)} ${v.blurb} (${v.platforms.join(", ")})`,
+	);
+	process.stdout.write(`
+Usage: npm create @pylonsync/pylon [name] [options]
+
+  --template <t>         ${TEMPLATES_AVAILABLE.join(" | ")}
+${tmplLines.join("\n")}
+
+  --platforms <list>     comma list: ${PLATFORMS_AVAILABLE.join(",")}  (default: web)
+  --bun|--pnpm|--yarn|--npm
+  --skip-install         scaffold only, don't run install
+
+Examples:
+  npm create @pylonsync/pylon my-app
+  npm create @pylonsync/pylon my-app --template todo --platforms web,ios
+  npm create @pylonsync/pylon my-app --template b2b --platforms web,mac
+  npm create @pylonsync/pylon my-app --template chat --platforms ios,mac,expo
+`);
 	exit(0);
 }
 
-// Interactive prompts for project name + package manager. Default
-// PM to bun: it handles `workspace:*` correctly out of the box,
-// installs faster than the alternatives, and is what the
-// @pylonsync/* packages are tested against. The user can pick
-// anything though.
 const rl = createInterface({ input: stdin, output: stdout });
 if (!projectName) {
 	projectName = (await rl.question("Project name: ")).trim() || "my-pylon-app";
 }
+if (!flags.template) {
+	const lines = Object.entries(TEMPLATE_REGISTRY)
+		.map(([k, v]) => `  ${k.padEnd(10)} ${v.blurb}`)
+		.join("\n");
+	process.stdout.write(`\n${lines}\n`);
+	const ans = (
+		await rl.question(
+			`Template (${TEMPLATES_AVAILABLE.join(", ")}) [todo]: `,
+		)
+	)
+		.trim()
+		.toLowerCase();
+	flags.template = TEMPLATES_AVAILABLE.includes(ans) ? ans : "todo";
+}
+if (!flags.platforms) {
+	const supported = TEMPLATE_REGISTRY[flags.template].platforms.join(", ");
+	const ans = (
+		await rl.question(
+			`Platforms for ${flags.template} (${supported}, comma-separated) [web]: `,
+		)
+	).trim();
+	flags.platforms = ans || "web";
+}
 if (!flags.pm) {
 	const detected = detectPackageManager();
 	const def = detected ?? "bun";
@@ -68,6 +184,45 @@ if (!flags.pm) {
 }
 rl.close();
 
+const platforms = flags.platforms
+	.split(",")
+	.map((p) => p.trim().toLowerCase())
+	.filter(Boolean);
+const unknownPlatforms = platforms.filter(
+	(p) => !PLATFORMS_AVAILABLE.includes(p),
+);
+if (unknownPlatforms.length > 0) {
+	console.error(
+		`\nError: unknown platform(s): ${unknownPlatforms.join(", ")}. Valid: ${PLATFORMS_AVAILABLE.join(", ")}\n`,
+	);
+	exit(1);
+}
+if (platforms.length === 0) {
+	console.error(`\nError: at least one platform required.\n`);
+	exit(1);
+}
+if (!TEMPLATES_AVAILABLE.includes(flags.template)) {
+	console.error(
+		`\nError: unknown template "${flags.template}". Valid: ${TEMPLATES_AVAILABLE.join(", ")}\n`,
+	);
+	exit(1);
+}
+
+// Reject combos a template doesn't yet support — better to fail loud
+// than to scaffold an incomplete tree (e.g. b2b + expo would skip
+// frontend entirely and leave the user with a half-empty workspace).
+const supportedPlatforms = TEMPLATE_REGISTRY[flags.template].platforms;
+const invalidForTemplate = platforms.filter(
+	(p) => !supportedPlatforms.includes(p),
+);
+if (invalidForTemplate.length > 0) {
+	console.error(
+		`\nError: template "${flags.template}" doesn't support platform(s): ${invalidForTemplate.join(", ")}.\n` +
+			`       supported: ${supportedPlatforms.join(", ")}\n`,
+	);
+	exit(1);
+}
+
 // Some PMs reject the `workspace:` protocol. Bun/pnpm/yarn berry
 // understand it and rewrite to the local sibling version at install
 // time. npm errors EUNSUPPORTEDPROTOCOL ("Unsupported URL Type").
@@ -78,1129 +233,219 @@ const usesWorkspaceProtocol = flags.pm !== "npm";
 const workspaceDepSpec = usesWorkspaceProtocol ? "workspace:*" : "*";
 
 const root = resolve(cwd(), projectName);
-
 if (existsSync(root) && readdirSync(root).length > 0) {
 	console.error(`\nError: ${root} already exists and is not empty.\n`);
 	exit(1);
 }
+mkdirSync(root, { recursive: true });
 
-console.log(`\nCreating ${projectName} in ${root}\n`);
-
-// ---------------------------------------------------------------------------
-// File-tree generator — every `write(path, content)` call creates parent
-// dirs as needed and writes UTF-8 text. Keeping the scaffold inline (no
-// template files) means create-pylon stays a single zero-dep file.
-// ---------------------------------------------------------------------------
-
-function write(path, content) {
-	const full = join(root, path);
-	mkdirSync(dirname(full), { recursive: true });
-	writeFileSync(full, content);
-}
-
-function writeJson(path, value) {
-	write(path, JSON.stringify(value, null, 2) + "\n");
-}
-
-// ---------------------------------------------------------------------------
-// Root workspace
-// ---------------------------------------------------------------------------
-
-// Per-PM script syntax: bun has its own --filter, pnpm uses --filter,
-// npm/yarn use --workspace. Picking the right shape at scaffold time
-// means `npm run dev` (or whichever PM) works without the user
-// learning each PM's flag dialect.
-const wsScripts = pmScripts(flags.pm);
-
-writeJson("package.json", {
-	name: projectName,
-	private: true,
-	type: "module",
-	workspaces: ["apps/*", "packages/*"],
-	scripts: {
-		dev: "npm-run-all --parallel dev:api dev:web",
-		"dev:api": wsScripts.devApi,
-		"dev:web": wsScripts.devWeb,
-		build: wsScripts.build,
-	},
-	devDependencies: {
-		"npm-run-all": "^4.1.5",
-	},
-});
-
-write(".gitignore", `node_modules/
-.next/
-.turbo/
-dist/
-out/
-.env
-.env.local
-*.db
-*.db-journal
-apps/api/pylon.manifest.json
-apps/api/pylon.client.ts
-`);
-
-write(".env.example", `# Backend port the Pylon control plane listens on.
-PYLON_PORT=4321
-
-# Where the Next.js dev server can reach the control plane.
-PYLON_TARGET=http://localhost:4321
-
-# Cookie name the auth helpers look for.
-# Pattern: \`\${app_name}_session\` from the Pylon manifest.
-PYLON_COOKIE_NAME=${projectName}_session
-`);
-
-write(
-	"README.md",
-	`# ${projectName}
-
-Realtime backend + Next.js dashboard, scaffolded by [@pylonsync/create-pylon](https://npmjs.com/@pylonsync/create-pylon).
-
-## Layout
-
-\`\`\`
-apps/
-  api/       Pylon backend — schema, policies, function handlers
-    schema.ts
-    functions/
-      listTodos.ts        live query handler
-      addTodo.ts          mutation handler
-
-  web/       Next.js 16 + React 19 + Tailwind v4 frontend
-    src/
-      app/
-        layout.tsx
-        page.tsx          server component → fetches initial todos
-        components/
-          TodoList.tsx    client component → optimistic add
-      lib/
-        pylon.ts          cookie-attached fetch helper
-
-packages/
-  ui/        Shared shadcn-style primitives (Button, Input, etc.)
-    src/
-      button.tsx, input.tsx, card.tsx, ...
-\`\`\`
-
-## Getting started
-
-\`\`\`sh
-${flags.pm === "npm" ? "npm install" : `${flags.pm} install`}
-${flags.pm === "npm" ? "npm run dev" : `${flags.pm} run dev`}
-\`\`\`
-
-That spins up two processes:
-
-- **api** on http://localhost:4321 — Pylon control plane
-- **web** on http://localhost:3000 — Next.js frontend wired via
-  [\`@pylonsync/next\`](https://npmjs.com/@pylonsync/next)
-
-## What to do next
-
-- Edit \`apps/api/schema.ts\` to add entities + policies.
-- Add handlers under \`apps/api/functions/\` — auto-discovered by name.
-- Drop new UI primitives into \`packages/ui/src/\`; import them from
-  any app via \`import { Button } from "@${projectName}/ui";\`.
-
-## Docs
-
-[pylonsync.com/docs](https://pylonsync.com/docs)
-`,
+console.log(
+	`\nCreating ${projectName} (${flags.template}, ${platforms.join(" + ")}) in ${root}\n`,
 );
 
 // ---------------------------------------------------------------------------
-// apps/api — Pylon backend
-// ---------------------------------------------------------------------------
-
-writeJson("apps/api/package.json", {
-	name: `@${projectName}/api`,
-	version: "0.0.1",
-	private: true,
-	type: "module",
-	scripts: {
-		dev: "pylon dev schema.ts --port 4321",
-		build: "pylon codegen schema.ts --out pylon.manifest.json && pylon codegen client pylon.manifest.json --out pylon.client.ts",
-		"schema:push": "pylon schema push pylon.manifest.json --sqlite dev.db",
-		"schema:inspect": "pylon schema inspect --sqlite dev.db",
-	},
-	dependencies: {
-		"@pylonsync/sdk": `^${PYLON_VERSION}`,
-		"@pylonsync/functions": `^${PYLON_VERSION}`,
-	},
-	devDependencies: {
-		"@pylonsync/cli": `^${PYLON_VERSION}`,
-		typescript: "^5.5.0",
-	},
-});
-
-writeJson("apps/api/tsconfig.json", {
-	compilerOptions: {
-		target: "ES2022",
-		module: "ESNext",
-		moduleResolution: "Bundler",
-		strict: true,
-		skipLibCheck: true,
-		noEmit: true,
-		esModuleInterop: true,
-		allowSyntheticDefaultImports: true,
-	},
-	include: ["schema.ts", "functions/**/*.ts"],
-});
-
-// Schema declares NAMES only — the SDK's query/action/mutation are
-// pure manifest declarations. Handler code lives under functions/*.
-write(
-	"apps/api/schema.ts",
-	`import {
-	entity,
-	field,
-	query,
-	action,
-	policy,
-	buildManifest,
-} from "@pylonsync/sdk";
-
-// ---------------------------------------------------------------------------
-// Schema
-// ---------------------------------------------------------------------------
-
-const Todo = entity("Todo", {
-	title: field.string(),
-	done: field.bool(),
-	createdAt: field.datetime(),
-	// Float position so drag-reorder can insert between two existing
-	// rows without renumbering the whole list. Frontend computes
-	// (prev.position + next.position) / 2 on drop. Optional for
-	// backwards compat with legacy rows.
-	position: field.float().optional(),
-});
-
-// ---------------------------------------------------------------------------
-// Function declarations — names only. Implementations live under
-// functions/<name>.ts and are auto-discovered by the runtime.
-// ---------------------------------------------------------------------------
-
-const listTodos = query("listTodos");
-
-const addTodo = action("addTodo", {
-	input: [{ name: "title", type: "string" }],
-});
-
-const toggleTodo = action("toggleTodo", {
-	input: [{ name: "id", type: "id(Todo)" }, { name: "done", type: "bool" }],
-});
-
-const deleteTodo = action("deleteTodo", {
-	input: [{ name: "id", type: "id(Todo)" }],
-});
-
-const editTodo = action("editTodo", {
-	input: [
-		{ name: "id", type: "id(Todo)" },
-		{ name: "title", type: "string" },
-	],
-});
-
-const reorderTodo = action("reorderTodo", {
-	input: [
-		{ name: "id", type: "id(Todo)" },
-		{ name: "position", type: "float" },
-	],
-});
-
-// ---------------------------------------------------------------------------
-// Policies — wide-open by default. Tighten for production.
+// Substitution table — used by every template file copy. Names that
+// only make sense for some platforms (e.g. PASCAL for Swift) are still
+// computed unconditionally; the unused replacements are no-ops.
 // ---------------------------------------------------------------------------
 
-const todoPolicy = policy({
-	name: "todo_open",
-	entity: "Todo",
-	allowRead: "true",
-	allowInsert: "true",
-	allowUpdate: "true",
-	allowDelete: "true",
-});
-
-// ---------------------------------------------------------------------------
-// Manifest — pylon codegen reads this and emits pylon.manifest.json
-// ---------------------------------------------------------------------------
-
-// pylon dev / pylon codegen run \`bun run schema.ts\` and read the
-// manifest off stdout. The framework expects JSON, not the JS object —
-// every Pylon entry file ends with this console.log line.
-const manifest = buildManifest({
-	name: "${projectName}",
-	version: "0.0.1",
-	entities: [Todo],
-	queries: [listTodos],
-	actions: [addTodo, toggleTodo, deleteTodo, editTodo, reorderTodo],
-	policies: [todoPolicy],
-	routes: [],
-});
-
-console.log(JSON.stringify(manifest));
-`,
-);
-
-write(
-	"apps/api/functions/listTodos.ts",
-	`import { query } from "@pylonsync/functions";
+const APP_NAME = projectName;
+const APP_NAME_KEBAB = APP_NAME.replace(/[^a-z0-9]+/gi, "-").toLowerCase();
+const APP_NAME_SNAKE = APP_NAME.replace(/[^a-z0-9]+/gi, "_").toLowerCase();
+const APP_NAME_PASCAL = APP_NAME.replace(/(^|[^a-z0-9])([a-z0-9])/gi, (_, _s, c) =>
+	c.toUpperCase(),
+).replace(/[^A-Za-z0-9]/g, "");
+
+const SUBS = {
+	__APP_NAME__: APP_NAME,
+	__APP_NAME_KEBAB__: APP_NAME_KEBAB,
+	__APP_NAME_SNAKE__: APP_NAME_SNAKE,
+	__APP_NAME_PASCAL__: APP_NAME_PASCAL,
+	__PYLON_VERSION__: PYLON_VERSION,
+	__WORKSPACE_DEP__: workspaceDepSpec,
+};
 
-/**
- * Live query — every Todo, in user-controlled drag-reorder position.
- * Rows without a \`position\` (legacy data) get sorted by createdAt as
- * a fallback so the list stays deterministic.
- */
-export default query({
-	args: {},
-	async handler(ctx) {
-		const rows = await ctx.db.query("Todo", {});
-		return [...rows].sort((a: any, b: any) => {
-			const ap =
-				typeof a.position === "number"
-					? a.position
-					: Date.parse(a.createdAt) || 0;
-			const bp =
-				typeof b.position === "number"
-					? b.position
-					: Date.parse(b.createdAt) || 0;
-			return ap - bp;
-		});
-	},
-});
-`,
-);
+// Filenames that contain placeholders get renamed AFTER copy. Keeps
+// the loader simple — copy the directory tree raw, then rename any
+// file/dir whose name has a placeholder.
+function substituteString(s) {
+	let out = s;
+	for (const [k, v] of Object.entries(SUBS)) {
+		out = out.split(k).join(v);
+	}
+	return out;
+}
 
-write(
-	"apps/api/functions/editTodo.ts",
-	`import { mutation, v } from "@pylonsync/functions";
+function substituteFile(absPath) {
+	// Skip binary-ish files — we only ever ship text in templates,
+	// but be safe in case someone drops a PNG icon in later.
+	const buf = readFileSync(absPath);
+	for (let i = 0; i < Math.min(buf.length, 8000); i++) {
+		if (buf[i] === 0) return;
+	}
+	const before = buf.toString("utf8");
+	const after = substituteString(before);
+	if (before !== after) writeFileSync(absPath, after);
+}
 
-/**
- * Rename a Todo. Trims whitespace; rejects empty titles.
- */
-export default mutation({
-	args: { id: v.id("Todo"), title: v.string() },
-	async handler(ctx, args: { id: string; title: string }) {
-		const trimmed = args.title.trim();
-		if (!trimmed) {
-			throw ctx.error("EMPTY_TITLE", "title cannot be empty");
+function walkAndSubstitute(dir) {
+	for (const entry of readdirSync(dir)) {
+		const abs = join(dir, entry);
+		const renamed = substituteString(entry);
+		let target = abs;
+		if (renamed !== entry) {
+			target = join(dir, renamed);
+			renameSync(abs, target);
 		}
-		await ctx.db.update("Todo", args.id, { title: trimmed });
-		return await ctx.db.get("Todo", args.id);
-	},
-});
-`,
-);
-
-write(
-	"apps/api/functions/reorderTodo.ts",
-	`import { mutation, v } from "@pylonsync/functions";
-
-/**
- * Drag-reorder. Frontend computes \`position\` as the midpoint of the
- * drop target's neighbors; we just write it. Floats give us ~52 inserts
- * between any two rows before precision matters.
- */
-export default mutation({
-	args: { id: v.id("Todo"), position: v.number() },
-	async handler(ctx, args: { id: string; position: number }) {
-		await ctx.db.update("Todo", args.id, { position: args.position });
-		return await ctx.db.get("Todo", args.id);
-	},
-});
-`,
-);
-
-write(
-	"apps/api/functions/toggleTodo.ts",
-	`import { mutation, v } from "@pylonsync/functions";
-
-/**
- * Flip the \`done\` flag on a Todo. Mutation, not action — needs
- * \`ctx.db.update\` which is only on writable ctx variants.
- */
-export default mutation({
-	args: { id: v.id("Todo"), done: v.bool() },
-	async handler(ctx, args: { id: string; done: boolean }) {
-		await ctx.db.update("Todo", args.id, { done: args.done });
-		return await ctx.db.get("Todo", args.id);
-	},
-});
-`,
-);
-
-write(
-	"apps/api/functions/deleteTodo.ts",
-	`import { mutation, v } from "@pylonsync/functions";
-
-/**
- * Remove a Todo row. Returns the row as it existed pre-delete so
- * the client can show a "todo removed" toast or animate it out.
- */
-export default mutation({
-	args: { id: v.id("Todo") },
-	async handler(ctx, args: { id: string }) {
-		const snapshot = await ctx.db.get("Todo", args.id);
-		await ctx.db.delete("Todo", args.id);
-		return snapshot;
-	},
-});
-`,
-);
-
-write(
-	"apps/api/functions/addTodo.ts",
-	`import { mutation, v } from "@pylonsync/functions";
+		const st = statSync(target);
+		if (st.isDirectory()) walkAndSubstitute(target);
+		else if (st.isFile()) substituteFile(target);
+	}
+}
 
-/**
- * Insert a new Todo. Seeds \`position\` to (max + 1024) so new rows
- * land at the end of the drag-reorder list; the 1024 step leaves
- * room for inserts-between without needing global renumber.
- */
-export default mutation({
-	args: { title: v.string() },
-	async handler(ctx, args: { title: string }) {
-		const existing = await ctx.db.query("Todo", {});
-		const maxPos = existing.reduce((acc: number, row: any) => {
-			const p =
-				typeof row.position === "number"
-					? row.position
-					: Date.parse(row.createdAt) || 0;
-			return p > acc ? p : acc;
-		}, 0);
-		const id = await ctx.db.insert("Todo", {
-			title: args.title,
-			done: false,
-			createdAt: new Date().toISOString(),
-			position: maxPos + 1024,
-		});
-		return await ctx.db.get("Todo", id);
-	},
-});
-`,
-);
+function copyTemplate(srcSubpath, destSubpath = "") {
+	const src = join(TEMPLATES, srcSubpath);
+	if (!existsSync(src)) return false;
+	const dest = destSubpath ? join(root, destSubpath) : root;
+	mkdirSync(dest, { recursive: true });
+	cpSync(src, dest, { recursive: true });
+	return true;
+}
 
 // ---------------------------------------------------------------------------
-// packages/ui — shared shadcn-style primitives
+// Apply templates in order:
+//   1. _root            — gitignore, env.example, README
+//   2. backend/<t>      — apps/api/* always present (one per template)
+//   3. ui               — packages/ui (only if web is in platforms)
+//   4. <platform>/<t>   — one per requested platform under apps/<platform>/
+//   5. Root package.json — generated, not templated
 // ---------------------------------------------------------------------------
 
-writeJson("packages/ui/package.json", {
-	name: `@${projectName}/ui`,
-	version: "0.0.1",
-	private: true,
-	type: "module",
-	main: "src/index.ts",
-	types: "src/index.ts",
-	exports: {
-		".": "./src/index.ts",
-		"./button": "./src/button.tsx",
-		"./input": "./src/input.tsx",
-		"./card": "./src/card.tsx",
-		"./cn": "./src/cn.ts",
-	},
-	dependencies: {
-		clsx: "^2.1.0",
-		"tailwind-merge": "^2.5.0",
-	},
-	peerDependencies: {
-		react: "^19.0.0",
-	},
-	devDependencies: {
-		"@types/react": "^19.0.0",
-		typescript: "^5.5.0",
-	},
-});
-
-writeJson("packages/ui/tsconfig.json", {
-	compilerOptions: {
-		target: "ES2022",
-		lib: ["dom", "esnext"],
-		jsx: "preserve",
-		module: "ESNext",
-		moduleResolution: "Bundler",
-		strict: true,
-		skipLibCheck: true,
-		noEmit: true,
-		esModuleInterop: true,
-		allowSyntheticDefaultImports: true,
-	},
-	include: ["src/**/*.ts", "src/**/*.tsx"],
-});
-
-write(
-	"packages/ui/src/cn.ts",
-	`import { clsx, type ClassValue } from "clsx";
-import { twMerge } from "tailwind-merge";
+copyTemplate("_root");
+copyTemplate(`backend/${flags.template}`);
 
-/**
- * Tailwind-aware class merger. Last-class-wins semantics so a
- * caller's \`className\` reliably overrides a default in a UI
- * primitive (e.g. <Button className="bg-red-500"> beats the
- * primitive's bg-neutral-900 base).
- */
-export function cn(...inputs: ClassValue[]): string {
-	return twMerge(clsx(inputs));
+if (platforms.includes("web")) {
+	copyTemplate("ui");
+	copyTemplate(`web/${flags.template}`);
 }
-`,
-);
-
-write(
-	"packages/ui/src/button.tsx",
-	`import * as React from "react";
-import { cn } from "./cn";
-
-type Variant = "default" | "primary" | "ghost";
-type Size = "sm" | "md";
-
-const variants: Record<Variant, string> = {
-	default:
-		"bg-neutral-100 hover:bg-neutral-200 text-neutral-900 dark:bg-neutral-800 dark:hover:bg-neutral-700 dark:text-neutral-100",
-	primary:
-		"bg-neutral-900 hover:bg-neutral-800 text-white dark:bg-white dark:hover:bg-neutral-200 dark:text-neutral-900",
-	ghost:
-		"bg-transparent hover:bg-neutral-100 text-neutral-700 dark:hover:bg-neutral-800 dark:text-neutral-300",
-};
-
-const sizes: Record<Size, string> = {
-	sm: "h-8 px-3 text-[13px]",
-	md: "h-9 px-4 text-sm",
-};
-
-export interface ButtonProps
-	extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-	variant?: Variant;
-	size?: Size;
+for (const p of ["ios", "mac", "expo"]) {
+	if (platforms.includes(p)) copyTemplate(`${p}/${flags.template}`);
 }
 
-export function Button({
-	className,
-	variant = "default",
-	size = "md",
-	...props
-}: ButtonProps) {
-	return (
-		<button
-			className={cn(
-				"inline-flex items-center justify-center gap-1.5 rounded-md font-medium transition-colors disabled:opacity-50 disabled:pointer-events-none focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500",
-				variants[variant],
-				sizes[size],
-				className,
-			)}
-			{...props}
-		/>
-	);
-}
-`,
-);
-
-write(
-	"packages/ui/src/input.tsx",
-	`import * as React from "react";
-import { cn } from "./cn";
-
-export type InputProps = React.InputHTMLAttributes<HTMLInputElement>;
-
-export const Input = React.forwardRef<HTMLInputElement, InputProps>(
-	function Input({ className, ...props }, ref) {
-		return (
-			<input
-				ref={ref}
-				className={cn(
-					"flex h-9 w-full rounded-md border border-neutral-300 dark:border-neutral-700 bg-white dark:bg-neutral-900 px-3 py-2 text-sm placeholder:text-neutral-400 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 disabled:opacity-50",
-					className,
-				)}
-				{...props}
-			/>
-		);
-	},
-);
-`,
-);
-
-write(
-	"packages/ui/src/card.tsx",
-	`import * as React from "react";
-import { cn } from "./cn";
+walkAndSubstitute(root);
 
-export function Card({
-	className,
-	...props
-}: React.HTMLAttributes<HTMLDivElement>) {
-	return (
-		<div
-			className={cn(
-				"rounded-lg border border-neutral-200 dark:border-neutral-800 bg-white dark:bg-neutral-900",
-				className,
-			)}
-			{...props}
-		/>
-	);
-}
+// ---------------------------------------------------------------------------
+// Root package.json — generated based on selected platforms. Workspace
+// scripts depend on which apps exist + which package manager the user
+// picked (each PM exposes "run X in workspace Y" differently).
+// ---------------------------------------------------------------------------
 
-export function CardHeader({
-	className,
-	...props
-}: React.HTMLAttributes<HTMLDivElement>) {
-	return (
-		<div className={cn("p-5 border-b border-neutral-200 dark:border-neutral-800", className)} {...props} />
-	);
+const wsScripts = pmScripts(flags.pm);
+const devScripts = {};
+// API runs always — every frontend connects to it.
+devScripts["dev:api"] = wsScripts.devApi;
+if (platforms.includes("web")) devScripts["dev:web"] = wsScripts.devWeb;
+if (platforms.includes("expo")) devScripts["dev:expo"] = wsScripts.devExpo;
+if (platforms.includes("ios")) {
+	// `xcodegen generate` materializes the .xcodeproj from project.yml,
+	// then it's an Xcode-driven flow — no `bun run dev` semantics.
+	devScripts["dev:ios"] =
+		"echo 'cd apps/ios && xcodegen generate && open *.xcodeproj  (or: swift run for a quick macOS preview)'";
 }
-
-export function CardContent({
-	className,
-	...props
-}: React.HTMLAttributes<HTMLDivElement>) {
-	return <div className={cn("p-5", className)} {...props} />;
+if (platforms.includes("mac")) {
+	devScripts["dev:mac"] =
+		"echo 'cd apps/mac && swift run  (or: xcodegen generate && open *.xcodeproj)'";
 }
-`,
-);
 
-write(
-	"packages/ui/src/index.ts",
-	`export { cn } from "./cn";
-export { Button, type ButtonProps } from "./button";
-export { Input, type InputProps } from "./input";
-export { Card, CardHeader, CardContent } from "./card";
-`,
-);
-
-// ---------------------------------------------------------------------------
-// apps/web — Next.js 16 + React 19 + Tailwind v4
-// ---------------------------------------------------------------------------
-
-writeJson("apps/web/package.json", {
-	name: `@${projectName}/web`,
-	version: "0.0.1",
+const parallelDevs = Object.keys(devScripts);
+const rootPkg = {
+	name: APP_NAME_KEBAB,
 	private: true,
 	type: "module",
+	workspaces: ["apps/*", "packages/*"].filter((p) => {
+		// Only declare packages/* as a workspace if we actually scaffolded
+		// packages/ui — otherwise the empty match warns on bun install.
+		if (p === "packages/*") return platforms.includes("web");
+		return true;
+	}),
 	scripts: {
-		dev: "next dev --port 3000",
-		build: "next build",
-		start: "next start",
-		lint: "next lint",
-	},
-	dependencies: {
-		[`@${projectName}/ui`]: workspaceDepSpec,
-		"@pylonsync/sdk": `^${PYLON_VERSION}`,
-		"@pylonsync/react": `^${PYLON_VERSION}`,
-		"@pylonsync/next": `^${PYLON_VERSION}`,
-		// Drag-reorder for the scaffolded TodoList demo.
-		"@dnd-kit/core": "^6.3.1",
-		"@dnd-kit/sortable": "^10.0.0",
-		"@dnd-kit/utilities": "^3.2.2",
-		next: "^16.0.0",
-		react: "^19.0.0",
-		"react-dom": "^19.0.0",
-	},
-	devDependencies: {
-		"@types/node": "^20.0.0",
-		"@types/react": "^19.0.0",
-		"@types/react-dom": "^19.0.0",
-		"@tailwindcss/postcss": "^4.0.0",
-		tailwindcss: "^4.0.0",
-		typescript: "^5.5.0",
-	},
-});
-
-writeJson("apps/web/tsconfig.json", {
-	compilerOptions: {
-		target: "ES2022",
-		lib: ["dom", "dom.iterable", "esnext"],
-		allowJs: true,
-		skipLibCheck: true,
-		strict: true,
-		noEmit: true,
-		esModuleInterop: true,
-		module: "esnext",
-		moduleResolution: "bundler",
-		resolveJsonModule: true,
-		isolatedModules: true,
-		jsx: "preserve",
-		incremental: true,
-		plugins: [{ name: "next" }],
-		paths: { "@/*": ["./src/*"] },
-	},
-	include: ["next-env.d.ts", "src/**/*.ts", "src/**/*.tsx", ".next/types/**/*.ts"],
-	exclude: ["node_modules"],
-});
-
-write(
-	"apps/web/next.config.ts",
-	`import type { NextConfig } from "next";
-
-/**
- * Pylon's typed client + functions packages re-export across the
- * server/client boundary AND the workspace UI package ships TSX.
- * \`transpilePackages\` makes Next bundle them cleanly.
- *
- * \`rewrites\` proxies every Pylon-owned path (\`/api/fn/*\`,
- * \`/api/auth/*\`, \`/api/sync/*\`, …) to the Pylon binary running
- * on \`PYLON_API_URL\` (default http://localhost:4321). Without this,
- * Next.js sees \`/api/fn/addTodo\` as a missing route and 404s before
- * the request ever reaches Pylon.
- *
- * In production set \`PYLON_API_URL\` to wherever you've deployed the
- * Pylon binary (Fly, Render, Railway, your own box). The browser
- * still hits same-origin paths under your Next deployment, and Next
- * forwards them server-side — no CORS, no extra DNS.
- */
-const PYLON_API_URL = process.env.PYLON_API_URL ?? "http://localhost:4321";
-
-const config: NextConfig = {
-	transpilePackages: [
-		"@${projectName}/ui",
-		"@pylonsync/sdk",
-		"@pylonsync/react",
-		"@pylonsync/next",
-		"@pylonsync/functions",
-		"@pylonsync/sync",
-	],
-	async rewrites() {
-		return [
-			{ source: "/api/fn/:path*", destination: \`\${PYLON_API_URL}/api/fn/:path*\` },
-			{ source: "/api/auth/:path*", destination: \`\${PYLON_API_URL}/api/auth/:path*\` },
-			{ source: "/api/sync/:path*", destination: \`\${PYLON_API_URL}/api/sync/:path*\` },
-			{ source: "/api/:path*", destination: \`\${PYLON_API_URL}/api/:path*\` },
-		];
+		dev:
+			parallelDevs.length > 1
+				? `npm-run-all --parallel ${parallelDevs.join(" ")}`
+				: wsScripts.devApi,
+		...devScripts,
+		build: wsScripts.build,
 	},
+	devDependencies: parallelDevs.length > 1 ? { "npm-run-all": "^4.1.5" } : {},
 };
-
-export default config;
-`,
-);
-
-write(
-	"apps/web/postcss.config.mjs",
-	`/** Tailwind v4 PostCSS pipeline. */
-export default {
-	plugins: { "@tailwindcss/postcss": {} },
-};
-`,
-);
-
-write(
-	"apps/web/src/app/globals.css",
-	`@import "tailwindcss";
-@source "../../../../packages/ui/src/**/*.{ts,tsx}";
-
-:root {
-	color-scheme: light dark;
-}
-
-html, body { height: 100%; }
-body { font-family: ui-sans-serif, system-ui, -apple-system, sans-serif; }
-`,
-);
-
-write(
-	"apps/web/src/app/layout.tsx",
-	`import type { Metadata } from "next";
-import "./globals.css";
-
-export const metadata: Metadata = {
-	title: "${projectName}",
-	description: "Realtime app powered by Pylon",
-};
-
-export default function RootLayout({
-	children,
-}: {
-	children: React.ReactNode;
-}) {
-	return (
-		<html lang="en">
-			<body className="antialiased min-h-screen bg-white dark:bg-neutral-950 text-neutral-900 dark:text-neutral-100">
-				{children}
-			</body>
-		</html>
-	);
-}
-`,
-);
-
-write(
-	"apps/web/src/lib/pylon.ts",
-	`import { createPylonServer } from "@pylonsync/next/server";
-
-/**
- * Single server-helper instance. Imported by every Server Component
- * and Server Action that needs to talk to the Pylon control plane.
- *
- * \`cookieName\` MUST match the backend's emitted cookie. Pylon uses
- * \`\${app_name}_session\` from the manifest — for this app that's
- * \`${projectName}_session\`. Pin it in code (NOT env) so a bad
- * deployment env can't silently break auth.
- */
-export const pylon = createPylonServer({
-	cookieName: "${projectName}_session",
-});
-`,
-);
-
-write(
-	"apps/web/src/app/page.tsx",
-	`import { pylon } from "@/lib/pylon";
-import { TodoList } from "./components/TodoList";
-
-// Force dynamic — every render reads the live todo list from Pylon.
-// Without this Next would try to statically generate the page and
-// the cookie-attached fetch in pylon.json would error at build time.
-export const dynamic = "force-dynamic";
-
-type Todo = {
-	id: string;
-	title: string;
-	done: boolean;
-	createdAt: string;
-};
-
-export default async function HomePage() {
-	const todos = await pylon
-		.json<Todo[]>("/api/fn/listTodos", {
-			method: "POST",
-			body: "{}",
-			headers: { "Content-Type": "application/json" },
-		})
-		.catch(() => [] as Todo[]);
-
-	return (
-		<main className="mx-auto max-w-2xl px-6 py-12 space-y-8">
-			<header className="space-y-2">
-				<h1 className="text-3xl font-semibold tracking-tight">${projectName}</h1>
-				<p className="text-sm text-neutral-500 dark:text-neutral-400">
-					A Pylon-powered realtime app. Edit{" "}
-					<code className="font-mono text-xs">apps/api/schema.ts</code> to change
-					the data model,{" "}
-					<code className="font-mono text-xs">apps/api/functions/</code> to add
-					handlers, or{" "}
-					<code className="font-mono text-xs">
-						apps/web/src/app/components/TodoList.tsx
-					</code>{" "}
-					for the UI.
-				</p>
-			</header>
-
-			<TodoList initialTodos={todos} />
-		</main>
-	);
-}
-`,
+writeFileSync(
+	join(root, "package.json"),
+	JSON.stringify(rootPkg, null, 2) + "\n",
 );
 
-write(
-	"apps/web/src/app/components/TodoList.tsx",
-	`"use client";
-
-import { useState, useTransition, useRef, useEffect } from "react";
-import { Button } from "@${projectName}/ui";
-import { Input } from "@${projectName}/ui";
-import {
-	DndContext,
-	closestCenter,
-	KeyboardSensor,
-	PointerSensor,
-	useSensor,
-	useSensors,
-	type DragEndEvent,
-} from "@dnd-kit/core";
-import {
-	arrayMove,
-	SortableContext,
-	sortableKeyboardCoordinates,
-	useSortable,
-	verticalListSortingStrategy,
-} from "@dnd-kit/sortable";
-import { CSS } from "@dnd-kit/utilities";
-
-type Todo = {
-	id: string;
-	title: string;
-	done: boolean;
-	createdAt: string;
-	position?: number;
-};
-
-/**
- * Optimistic todo list with drag-reorder, inline title edit, toggle,
- * and delete. All mutations are optimistic with revert-on-failure.
- * Drag uses @dnd-kit; on drop we compute the new row's position as
- * the midpoint between its new neighbors and POST it to reorderTodo.
- */
-export function TodoList({ initialTodos }: { initialTodos: Todo[] }) {
-	const [todos, setTodos] = useState(initialTodos);
-	const [title, setTitle] = useState("");
-	const [pending, startTransition] = useTransition();
-	const sensors = useSensors(
-		useSensor(PointerSensor, { activationConstraint: { distance: 5 } }),
-		useSensor(KeyboardSensor, { coordinateGetter: sortableKeyboardCoordinates }),
-	);
-
-	async function add() {
-		if (!title.trim()) return;
-		const newTitle = title;
-		setTitle("");
-		startTransition(async () => {
-			const res = await fetch("/api/fn/addTodo", {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({ title: newTitle }),
-			});
-			if (res.ok) {
-				const todo = (await res.json()) as Todo;
-				setTodos((prev) => [...prev, todo]);
-			}
-		});
-	}
-
-	async function toggle(t: Todo) {
-		const next = !t.done;
-		setTodos((prev) =>
-			prev.map((row) => (row.id === t.id ? { ...row, done: next } : row)),
-		);
-		startTransition(async () => {
-			const res = await fetch("/api/fn/toggleTodo", {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({ id: t.id, done: next }),
-			});
-			if (!res.ok) {
-				setTodos((prev) =>
-					prev.map((row) => (row.id === t.id ? { ...row, done: t.done } : row)),
-				);
-			}
-		});
-	}
-
-	async function remove(t: Todo) {
-		const snapshot = todos;
-		setTodos((prev) => prev.filter((row) => row.id !== t.id));
-		startTransition(async () => {
-			const res = await fetch("/api/fn/deleteTodo", {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({ id: t.id }),
-			});
-			if (!res.ok) setTodos(snapshot);
-		});
-	}
+// ---------------------------------------------------------------------------
+// Optional: install dependencies
+// ---------------------------------------------------------------------------
 
-	async function rename(t: Todo, newTitle: string) {
-		const trimmed = newTitle.trim();
-		if (!trimmed || trimmed === t.title) return;
-		setTodos((prev) =>
-			prev.map((row) => (row.id === t.id ? { ...row, title: trimmed } : row)),
+if (!flags.skipInstall) {
+	console.log(`Installing dependencies with ${flags.pm}...`);
+	const { spawnSync } = await import("node:child_process");
+	const result = spawnSync(flags.pm, ["install"], {
+		cwd: root,
+		stdio: "inherit",
+	});
+	if (result.status !== 0) {
+		console.warn(
+			`\n${flags.pm} install exited with code ${result.status}. Re-run from ${projectName}/.\n`,
 		);
-		startTransition(async () => {
-			const res = await fetch("/api/fn/editTodo", {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({ id: t.id, title: trimmed }),
-			});
-			if (!res.ok) {
-				setTodos((prev) =>
-					prev.map((row) => (row.id === t.id ? { ...row, title: t.title } : row)),
-				);
-			}
-		});
 	}
+}
 
-	function onDragEnd(e: DragEndEvent) {
-		const { active, over } = e;
-		if (!over || active.id === over.id) return;
-		const oldIndex = todos.findIndex((t) => t.id === active.id);
-		const newIndex = todos.findIndex((t) => t.id === over.id);
-		if (oldIndex < 0 || newIndex < 0) return;
-		const reordered = arrayMove(todos, oldIndex, newIndex);
-		setTodos(reordered);
-		const prev = reordered[newIndex - 1];
-		const next = reordered[newIndex + 1];
-		const prevPos = prev?.position ?? Date.parse(prev?.createdAt ?? "") ?? 0;
-		const nextPos = next?.position ?? Date.parse(next?.createdAt ?? "") ?? 0;
-		let position: number;
-		if (prev && next) position = (prevPos + nextPos) / 2;
-		else if (prev) position = prevPos + 1024;
-		else if (next) position = nextPos - 1024;
-		else position = 1024;
-		const movedId = String(active.id);
-		const snapshot = todos;
-		startTransition(async () => {
-			const res = await fetch("/api/fn/reorderTodo", {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({ id: movedId, position }),
-			});
-			if (!res.ok) setTodos(snapshot);
-		});
-	}
+// ---------------------------------------------------------------------------
+// Final instructions
+// ---------------------------------------------------------------------------
 
-	return (
-		<div className="space-y-4">
-			<form
-				onSubmit={(e) => {
-					e.preventDefault();
-					add();
-				}}
-				className="flex gap-2"
-			>
-				<Input
-					value={title}
-					onChange={(e) => setTitle(e.target.value)}
-					placeholder="What needs doing?"
-					disabled={pending}
-					className="flex-1"
-				/>
-				<Button
-					type="submit"
-					variant="primary"
-					disabled={pending || !title.trim()}
-				>
-					Add
-				</Button>
-			</form>
+const runDev = flags.pm === "npm" ? "npm run dev" : `${flags.pm} run dev`;
 
-			{todos.length === 0 ? (
-				<p className="text-sm text-neutral-500 dark:text-neutral-400 text-center py-8">
-					No todos yet. Add one above.
-				</p>
-			) : (
-				<DndContext sensors={sensors} collisionDetection={closestCenter} onDragEnd={onDragEnd}>
-					<SortableContext items={todos.map((t) => t.id)} strategy={verticalListSortingStrategy}>
-						<ul className="divide-y divide-neutral-200 dark:divide-neutral-800 rounded-md border border-neutral-200 dark:border-neutral-800">
-							{todos.map((t) => (
-								<SortableRow
-									key={t.id}
-									todo={t}
-									pending={pending}
-									onToggle={() => toggle(t)}
-									onRemove={() => remove(t)}
-									onRename={(next) => rename(t, next)}
-								/>
-							))}
-						</ul>
-					</SortableContext>
-				</DndContext>
-			)}
-		</div>
-	);
+const platformLines = [];
+platformLines.push("  → api      http://localhost:4321  (Pylon control plane)");
+if (platforms.includes("web"))
+	platformLines.push("  → web      http://localhost:3000  (Next.js)");
+if (platforms.includes("expo"))
+	platformLines.push(`  → expo     ${flags.pm} run dev:expo  (Metro + simulator)`);
+if (platforms.includes("ios"))
+	platformLines.push(`  → ios      cd apps/ios && xcodegen generate && open *.xcodeproj`);
+if (platforms.includes("mac"))
+	platformLines.push(`  → mac      cd apps/mac && swift run  (or xcodegen for .app)`);
+
+const layoutLines = ["  apps/api          schema + functions/ handlers"];
+if (platforms.includes("web")) {
+	layoutLines.push("  apps/web          Next.js 16 + React 19 + Tailwind v4");
+	layoutLines.push("  packages/ui       shared UI primitives");
 }
+if (platforms.includes("ios"))
+	layoutLines.push("  apps/ios          Swift / SwiftUI (iOS)");
+if (platforms.includes("mac"))
+	layoutLines.push("  apps/mac          Swift / SwiftUI (macOS)");
+if (platforms.includes("expo"))
+	layoutLines.push("  apps/expo         Expo + React Native");
 
-function SortableRow({ todo, pending, onToggle, onRemove, onRename }: {
-	todo: Todo;
-	pending: boolean;
-	onToggle: () => void;
-	onRemove: () => void;
-	onRename: (next: string) => void;
-}) {
-	const { attributes, listeners, setNodeRef, transform, transition, isDragging } =
-		useSortable({ id: todo.id });
-	const style = {
-		transform: CSS.Transform.toString(transform),
-		transition,
-		opacity: isDragging ? 0.4 : 1,
-	};
-	const [editing, setEditing] = useState(false);
-	const [draft, setDraft] = useState(todo.title);
-	const inputRef = useRef<HTMLInputElement>(null);
+console.log(`
+✓ Created ${projectName}
 
-	useEffect(() => {
-		if (editing) {
-			setDraft(todo.title);
-			requestAnimationFrame(() => {
-				inputRef.current?.focus();
-				inputRef.current?.select();
-			});
-		}
-	}, [editing, todo.title]);
+  cd ${projectName}
+  ${runDev}
 
-	function commit() {
-		setEditing(false);
-		onRename(draft);
-	}
+${platformLines.join("\n")}
 
-	return (
-		<li
-			ref={setNodeRef}
-			style={style}
-			className="flex items-center gap-3 px-4 py-3 text-sm group bg-white dark:bg-neutral-950"
-		>
-			<button
-				type="button"
-				{...attributes}
-				{...listeners}
-				className="cursor-grab active:cursor-grabbing text-neutral-300 hover:text-neutral-500 select-none touch-none"
-				aria-label="Drag to reorder"
-				tabIndex={-1}
-			>
-				⋮⋮
-			</button>
-			<input
-				type="checkbox"
-				checked={todo.done}
-				onChange={onToggle}
-				disabled={pending}
-				className="size-4 cursor-pointer"
-				aria-label={\\\`Mark "\${todo.title}" as \${todo.done ? "not done" : "done"}\\\`}
-			/>
-			{editing ? (
-				<input
-					ref={inputRef}
-					value={draft}
-					onChange={(e) => setDraft(e.target.value)}
-					onBlur={commit}
-					onKeyDown={(e) => {
-						if (e.key === "Enter") commit();
-						else if (e.key === "Escape") {
-							setEditing(false);
-							setDraft(todo.title);
-						}
-					}}
-					className="flex-1 bg-transparent border-b border-neutral-300 dark:border-neutral-700 outline-none text-sm"
-					aria-label="Edit title"
-				/>
-			) : (
-				<button
-					type="button"
-					onDoubleClick={() => setEditing(true)}
-					className={\\\`flex-1 text-left \${todo.done ? "line-through text-neutral-400" : ""}\\\`}
-					title="Double-click to edit"
-				>
-					{todo.title}
-				</button>
-			)}
-			<button
-				type="button"
-				onClick={() => setEditing(true)}
-				className="opacity-0 group-hover:opacity-100 transition-opacity text-xs text-neutral-500 hover:text-neutral-800 dark:hover:text-neutral-200"
-				aria-label={\\\`Edit "\${todo.title}"\\\`}
-			>
-				Edit
-			</button>
-			<button
-				type="button"
-				onClick={onRemove}
-				disabled={pending}
-				className="opacity-0 group-hover:opacity-100 transition-opacity text-xs text-neutral-500 hover:text-red-500"
-				aria-label={\\\`Delete "\${todo.title}"\\\`}
-			>
-				Delete
-			</button>
-		</li>
-	);
-}
-`,
-);
+Layout:
+${layoutLines.join("\n")}
 
-write(
-	"apps/web/next-env.d.ts",
-	`/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-`,
-);
+Docs: https://pylonsync.com/docs
+`);
 
 // ---------------------------------------------------------------------------
-// Detect package manager — read npm_config_user_agent set by the runner.
+// Helpers
 // ---------------------------------------------------------------------------
 
 function detectPackageManager() {
@@ -1212,36 +457,27 @@ function detectPackageManager() {
 	return null;
 }
 
-/**
- * Per-package-manager workspace script syntax. Each PM exposes
- * "run X in workspace Y" differently:
- *   bun  bun run --filter ./apps/api dev
- *   pnpm pnpm --filter ./apps/api run dev
- *   yarn yarn workspace @<name>/api run dev
- *   npm  npm --workspace apps/api run dev
- *
- * The scaffold doesn't try to abstract the PM — it bakes the right
- * syntax into the generated scripts so `<pm> run dev` works
- * everywhere with no further config.
- */
 function pmScripts(pm) {
 	switch (pm) {
 		case "bun":
 			return {
 				devApi: "bun run --filter './apps/api' dev",
 				devWeb: "bun run --filter './apps/web' dev",
+				devExpo: "bun run --filter './apps/expo' start",
 				build: "bun run --filter '*' build",
 			};
 		case "pnpm":
 			return {
 				devApi: "pnpm --filter './apps/api' run dev",
 				devWeb: "pnpm --filter './apps/web' run dev",
+				devExpo: "pnpm --filter './apps/expo' run start",
 				build: "pnpm --filter '*' run build",
 			};
 		case "yarn":
 			return {
-				devApi: `yarn workspace @${projectName}/api run dev`,
-				devWeb: `yarn workspace @${projectName}/web run dev`,
+				devApi: `yarn workspace @${APP_NAME_KEBAB}/api run dev`,
+				devWeb: `yarn workspace @${APP_NAME_KEBAB}/web run dev`,
+				devExpo: `yarn workspace @${APP_NAME_KEBAB}/expo run start`,
 				build: "yarn workspaces foreach -A run build",
 			};
 		case "npm":
@@ -1249,53 +485,8 @@ function pmScripts(pm) {
 			return {
 				devApi: "npm --workspace apps/api run dev",
 				devWeb: "npm --workspace apps/web run dev",
+				devExpo: "npm --workspace apps/expo run start",
 				build: "npm --workspaces run build --if-present",
 			};
 	}
 }
-
-// ---------------------------------------------------------------------------
-// Optional: install dependencies
-// ---------------------------------------------------------------------------
-
-if (!flags.skipInstall) {
-	console.log(`Installing dependencies with ${flags.pm}...`);
-	const { spawnSync } = await import("node:child_process");
-	const result = spawnSync(flags.pm, ["install"], {
-		cwd: root,
-		stdio: "inherit",
-	});
-	if (result.status !== 0) {
-		console.warn(
-			`\n${flags.pm} install exited with code ${result.status}. Re-run from ${projectName}/.\n`,
-		);
-	}
-}
-
-// ---------------------------------------------------------------------------
-// Final instructions
-// ---------------------------------------------------------------------------
-
-const runDev = flags.pm === "npm" ? "npm run dev" : `${flags.pm} run dev`;
-
-console.log(`
-✓ Created ${projectName}
-
-  cd ${projectName}
-  ${runDev}
-
-  → api  http://localhost:4321  (Pylon control plane)
-  → web  http://localhost:3000  (Next.js dashboard)
-
-Layout:
-  apps/api    schema + functions/ handlers
-  apps/web    Next.js 16 + React 19 + Tailwind v4
-  packages/ui shared shadcn-style primitives
-
-Next:
-  - Edit apps/api/schema.ts to add entities + policies.
-  - Drop handlers into apps/api/functions/ — auto-discovered by name.
-  - Components go in apps/web/src/app/components/.
-
-Docs: https://pylonsync.com/docs
-`);