@pylonsync/create-pylon 0.5.0 → 0.5.3

package/bin/create-pylon.js

@@ -311,6 +311,28 @@ Examples:
 }
 
 const rl = createInterface({ input: stdin, output: stdout });
+
+/**
+ * Prompt, treating Ctrl+D / Ctrl+C as a deliberate cancel.
+ *
+ * readline rejects the pending question with an AbortError, which at top
+ * level in an ESM script surfaces as an unhandled rejection — so someone who
+ * changes their mind at the template picker gets a Node stack trace instead
+ * of "cancelled". Nothing has been written to disk at this point, so say so
+ * and leave quietly.
+ */
+async function ask(question) {
+	try {
+		return await rl.question(question);
+	} catch (err) {
+		if (err?.code === "ABORT_ERR") {
+			stdout.write("\nCancelled — nothing was created.\n");
+			rl.close();
+			exit(0);
+		}
+		throw err;
+	}
+}
 // Non-interactive stdin (CI, piped, `| npm create …`): never block on a prompt.
 // Fall back to the same defaults the interactive path uses. The skill-install
 // below already gates on `stdin.isTTY`; the INPUT prompts must too — without
@@ -319,7 +341,7 @@ const rl = createInterface({ input: stdin, output: stdout });
 const isInteractive = !!stdin.isTTY;
 if (!projectName) {
 	projectName =
-		(isInteractive ? (await rl.question("Project name: ")).trim() : "") ||
+		(isInteractive ? (await ask("Project name: ")).trim() : "") ||
 		"my-pylon-app";
 }
 if (!flags.template) {
@@ -329,7 +351,7 @@ if (!flags.template) {
 			.join("\n");
 		process.stdout.write(`\n${lines}\n`);
 		const ans = (
-			await rl.question(
+			await ask(
 				`Template (${TEMPLATES_AVAILABLE.join(", ")}) [${DEFAULT_TEMPLATE}]: `,
 			)
 		)
@@ -352,7 +374,7 @@ if (!isUnified && !flags.platforms) {
 	const supported = TEMPLATE_REGISTRY[flags.template].platforms.join(", ");
 	const ans = isInteractive
 		? (
-				await rl.question(
+				await ask(
 					`Platforms for ${flags.template} (${supported}, comma-separated) [web]: `,
 				)
 			).trim()
@@ -364,7 +386,7 @@ if (!flags.pm) {
 	const def = detected ?? "bun";
 	if (isInteractive) {
 		const choice = (
-			await rl.question(`Package manager (bun, pnpm, yarn, npm) [${def}]: `)
+			await ask(`Package manager (bun, pnpm, yarn, npm) [${def}]: `)
 		)
 			.trim()
 			.toLowerCase();
@@ -376,7 +398,7 @@ if (!flags.pm) {
 if (flags.skill === undefined) {
 	if (isInteractive) {
 		const ans = (
-			await rl.question(
+			await ask(
 				"Add the Pylon skill to your coding agent (Claude Code / Codex / Cursor)? [Y/n]: ",
 			)
 		)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/create-pylon",
-  "version": "0.5.0",
+  "version": "0.5.3",
   "description": "Scaffold a new Pylon app — realtime backend + web/mobile/expo frontends in one command. Run via `npm create @pylonsync/pylon@latest`.",
   "publishConfig": {
     "access": "public"

package/templates/_root/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/agency/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/agency/app.ts

@@ -300,6 +300,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/ai-chat/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/ai-chat/app.ts

@@ -135,6 +135,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/ai-studio/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/ai-studio/app.ts

@@ -122,6 +122,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/backend/b2b/apps/api/schema.ts

@@ -176,4 +176,7 @@ const manifest = buildManifest({
 	routes: [],
 });
 
+// Not a debug leftover: the CLI runs `bun run` on this file and parses stdout
+// as your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest));

package/templates/backend/barebones/apps/api/schema.ts

@@ -58,4 +58,7 @@ const manifest = buildManifest({
 	routes: [],
 });
 
+// Not a debug leftover: the CLI runs `bun run` on this file and parses stdout
+// as your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest));

package/templates/backend/chat/apps/api/schema.ts

@@ -93,4 +93,7 @@ const manifest = buildManifest({
 	routes: [],
 });
 
+// Not a debug leftover: the CLI runs `bun run` on this file and parses stdout
+// as your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest));

package/templates/backend/consumer/apps/api/schema.ts

@@ -137,4 +137,7 @@ const manifest = buildManifest({
 	routes: [],
 });
 
+// Not a debug leftover: the CLI runs `bun run` on this file and parses stdout
+// as your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest));

package/templates/backend/todo/apps/api/schema.ts

@@ -82,4 +82,7 @@ const manifest = buildManifest({
 	routes: [],
 });
 
+// Not a debug leftover: the CLI runs `bun run` on this file and parses stdout
+// as your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest));

package/templates/barebones/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/barebones/app.ts

@@ -55,6 +55,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/chat/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/chat/app.ts

@@ -54,6 +54,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/consumer/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/consumer/app.ts

@@ -89,6 +89,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/creator/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/creator/app.ts

@@ -148,6 +148,9 @@ const manifest = buildManifest({
 });
 
 // Emit the canonical manifest JSON to stdout — `pylon dev` captures this.
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/crm/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/crm/app.ts

@@ -172,6 +172,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/directory/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/directory/app.ts

@@ -162,6 +162,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/helpdesk/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/helpdesk/app.ts

@@ -143,6 +143,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/inventory/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/inventory/app.ts

@@ -155,6 +155,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/invoices/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/invoices/app.ts

@@ -170,6 +170,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/local-service/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/local-service/app.ts

@@ -147,6 +147,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/marketplace/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/marketplace/app.ts

@@ -192,6 +192,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/marketplace/client/market.ts

@@ -5,7 +5,10 @@
 // init() resolves window.location.origin.
 import { init, configureClient, callFn, setSessionToken, storageKey } from "@pylonsync/react";
 
-export const APP_NAME = "market";
+// Match the manifest name (app.ts `buildManifest({ name })`) so this explicit
+// appName agrees with the value the SSR runtime auto-injects at hydrate — no
+// keyspace disagreement, no double token migration.
+export const APP_NAME = "__APP_NAME__";
 
 // Prefilled demo account — the shopper you sign in as. Owns a couple of its
 // own listings so "My Market" isn't empty, but NOT the bulk of the catalog,

package/templates/projects/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/projects/app.ts

@@ -187,6 +187,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/restaurant/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/restaurant/app.ts

@@ -131,6 +131,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/saas/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/saas/app.ts

@@ -214,6 +214,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/shop/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/shop/app.ts

@@ -150,6 +150,9 @@ const manifest = buildManifest({
   routes: await discoverAppRoutes(),
 });
 
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/todo/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/todo/app.ts

@@ -72,6 +72,9 @@ const manifest = buildManifest({
 });
 
 // Emit canonical manifest JSON to stdout for `pylon codegen`.
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;

package/templates/waitlist/AGENTS.md

@@ -5,7 +5,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
 ## Directory conventions
 
 **Unified SSR app:**
-- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
+- `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))` — that line is the manifest handoff (the CLI parses this file's stdout), not debug output. Never remove it.
 - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. A `(group)` directory is stripped from the URL — `app/(marketing)/about/page.tsx` still serves `/about` — so a group's `layout.tsx` gives one section its own chrome (nav, footer) without changing any path; routes outside the group render without it. `app/layout.tsx` is the document shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
 - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
 - `functions/`: server functions, one per file, `default`-exported.

package/templates/waitlist/app.ts

@@ -152,6 +152,9 @@ const manifest = buildManifest({
 });
 
 // Emit the canonical manifest JSON to stdout — `pylon dev` captures this.
+// Not a debug leftover: the CLI runs `bun run app.ts` and parses stdout as
+// your manifest (see crates/cli/src/bun.rs). Deleting this line breaks every
+// pylon command that reads your schema.
 console.log(JSON.stringify(manifest, null, 2));
 
 export default manifest;