@pylonsync/create-pylon 0.4.29 → 0.5.2

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.4.29",
+  "version": "0.5.2",
   "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/llms.ts

@@ -0,0 +1,31 @@
+import type { LlmsTxt } from "@pylonsync/react";
+
+// app/llms.ts → served at /llms.txt, in llmstxt.org format.
+//
+// This is the file an AI agent reads FIRST to decide what this site is and
+// whether it can help with the task in front of it. Keep the shape, rewrite the
+// copy: name the jobs this app is right for and the exact call to make. Generic
+// marketing copy does not read as guidance.
+//
+// The default export may be async, so it can enumerate pages from the database.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function llms(): LlmsTxt {
+  return {
+    title: "__APP_NAME__",
+    summary: "An agency site: services, case studies, and an enquiry form.",
+    details: [
+      "Use this app to read case studies and to send an enquiry.",
+      "Every page here is also readable as markdown: add `.md` to any path, or send `Accept: text/markdown`.",
+    ],
+    sections: [
+      {
+        title: "Pages",
+        links: [
+          { title: "Home", url: `${SITE}` },
+          { title: "Work", url: `${SITE}/work` },
+        ],
+      },
+    ],
+  };
+}

package/templates/agency/app/not-found.tsx

@@ -0,0 +1,44 @@
+import React from "react";
+import { Link, type NotFoundProps } from "@pylonsync/react";
+import { Button } from "@/components/ui/button";
+
+// `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL, and when a
+// page calls `response.notFound()`.
+//
+// Give it real links. This boundary is also what an agent reads when it guesses
+// a URL wrong: a markdown request for a missing page renders THIS file as
+// markdown at 404, so the links below are how it finds its way back.
+export default function NotFound(_props: NotFoundProps) {
+  return (
+    <div className="mx-auto flex min-h-[60vh] max-w-lg flex-col justify-center gap-6 px-4">
+      <section>
+        <h1 className="text-2xl font-semibold tracking-tight">Page not found</h1>
+        <p className="mt-2 text-muted-foreground">
+          That URL does not exist. Try one of these:
+        </p>
+      </section>
+      <ul className="space-y-2 text-sm">
+        <li>
+          <Link className="underline underline-offset-4" href="/">
+            Home
+          </Link>
+        </li>
+        <li>
+          <a className="underline underline-offset-4" href="/sitemap.xml">
+            Sitemap
+          </a>
+        </li>
+        <li>
+          <a className="underline underline-offset-4" href="/llms.txt">
+            llms.txt
+          </a>
+        </li>
+      </ul>
+      <div>
+        <Button asChild>
+          <Link href="/">Back to home</Link>
+        </Button>
+      </div>
+    </div>
+  );
+}

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/llms.ts

@@ -0,0 +1,30 @@
+import type { LlmsTxt } from "@pylonsync/react";
+
+// app/llms.ts → served at /llms.txt, in llmstxt.org format.
+//
+// This is the file an AI agent reads FIRST to decide what this site is and
+// whether it can help with the task in front of it. Keep the shape, rewrite the
+// copy: name the jobs this app is right for and the exact call to make. Generic
+// marketing copy does not read as guidance.
+//
+// The default export may be async, so it can enumerate pages from the database.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function llms(): LlmsTxt {
+  return {
+    title: "__APP_NAME__",
+    summary: "An AI chat app with streaming answers and stored transcripts.",
+    details: [
+      "Use this app to ask a question and read the streamed answer. Transcripts persist across reloads and devices.",
+      "Every page here is also readable as markdown: add `.md` to any path, or send `Accept: text/markdown`.",
+    ],
+    sections: [
+      {
+        title: "Pages",
+        links: [
+          { title: "Home", url: `${SITE}` },
+        ],
+      },
+    ],
+  };
+}

package/templates/ai-chat/app/not-found.tsx

@@ -0,0 +1,44 @@
+import React from "react";
+import { Link, type NotFoundProps } from "@pylonsync/react";
+import { Button } from "@/components/ui/button";
+
+// `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL, and when a
+// page calls `response.notFound()`.
+//
+// Give it real links. This boundary is also what an agent reads when it guesses
+// a URL wrong: a markdown request for a missing page renders THIS file as
+// markdown at 404, so the links below are how it finds its way back.
+export default function NotFound(_props: NotFoundProps) {
+  return (
+    <div className="mx-auto flex min-h-[60vh] max-w-lg flex-col justify-center gap-6 px-4">
+      <section>
+        <h1 className="text-2xl font-semibold tracking-tight">Page not found</h1>
+        <p className="mt-2 text-muted-foreground">
+          That URL does not exist. Try one of these:
+        </p>
+      </section>
+      <ul className="space-y-2 text-sm">
+        <li>
+          <Link className="underline underline-offset-4" href="/">
+            Home
+          </Link>
+        </li>
+        <li>
+          <a className="underline underline-offset-4" href="/sitemap.xml">
+            Sitemap
+          </a>
+        </li>
+        <li>
+          <a className="underline underline-offset-4" href="/llms.txt">
+            llms.txt
+          </a>
+        </li>
+      </ul>
+      <div>
+        <Button asChild>
+          <Link href="/">Back to home</Link>
+        </Button>
+      </div>
+    </div>
+  );
+}

package/templates/ai-chat/app/robots.ts

@@ -0,0 +1,14 @@
+import type { Robots } from "@pylonsync/react";
+
+// app/robots.ts → served at /robots.txt. Point SITE_URL at your domain in
+// production. The default export may also be async.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function robots(): Robots {
+  return {
+    // Keep the signed-in app and the API out of the index. `llms.txt` and the
+    // sitemap stay crawlable — they are what a crawler or agent reads first.
+    rules: { userAgent: "*", allow: "/", disallow: ["/api/", "/login"] },
+    sitemap: `${SITE}/sitemap.xml`,
+  };
+}

package/templates/ai-chat/app/sitemap.ts

@@ -0,0 +1,11 @@
+import type { Sitemap } from "@pylonsync/react";
+
+// app/sitemap.ts → served at /sitemap.xml. The default export can be async, so
+// it can enumerate pages from your database. Point SITE_URL at your domain in
+// production.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default async function sitemap(): Promise<Sitemap> {
+  // Only public pages belong here. The signed-in app is private.
+  return [{ url: `${SITE}/`, changeFrequency: "weekly", priority: 1 }];
+}

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/llms.ts

@@ -0,0 +1,30 @@
+import type { LlmsTxt } from "@pylonsync/react";
+
+// app/llms.ts → served at /llms.txt, in llmstxt.org format.
+//
+// This is the file an AI agent reads FIRST to decide what this site is and
+// whether it can help with the task in front of it. Keep the shape, rewrite the
+// copy: name the jobs this app is right for and the exact call to make. Generic
+// marketing copy does not read as guidance.
+//
+// The default export may be async, so it can enumerate pages from the database.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function llms(): LlmsTxt {
+  return {
+    title: "__APP_NAME__",
+    summary: "An AI studio: prompts, runs, and tool calls with durable run state.",
+    details: [
+      "Use this app to run a prompt, read the streamed output, and review past runs.",
+      "Every page here is also readable as markdown: add `.md` to any path, or send `Accept: text/markdown`.",
+    ],
+    sections: [
+      {
+        title: "Pages",
+        links: [
+          { title: "Home", url: `${SITE}` },
+        ],
+      },
+    ],
+  };
+}

package/templates/ai-studio/app/not-found.tsx

@@ -0,0 +1,44 @@
+import React from "react";
+import { Link, type NotFoundProps } from "@pylonsync/react";
+import { Button } from "@/components/ui/button";
+
+// `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL, and when a
+// page calls `response.notFound()`.
+//
+// Give it real links. This boundary is also what an agent reads when it guesses
+// a URL wrong: a markdown request for a missing page renders THIS file as
+// markdown at 404, so the links below are how it finds its way back.
+export default function NotFound(_props: NotFoundProps) {
+  return (
+    <div className="mx-auto flex min-h-[60vh] max-w-lg flex-col justify-center gap-6 px-4">
+      <section>
+        <h1 className="text-2xl font-semibold tracking-tight">Page not found</h1>
+        <p className="mt-2 text-muted-foreground">
+          That URL does not exist. Try one of these:
+        </p>
+      </section>
+      <ul className="space-y-2 text-sm">
+        <li>
+          <Link className="underline underline-offset-4" href="/">
+            Home
+          </Link>
+        </li>
+        <li>
+          <a className="underline underline-offset-4" href="/sitemap.xml">
+            Sitemap
+          </a>
+        </li>
+        <li>
+          <a className="underline underline-offset-4" href="/llms.txt">
+            llms.txt
+          </a>
+        </li>
+      </ul>
+      <div>
+        <Button asChild>
+          <Link href="/">Back to home</Link>
+        </Button>
+      </div>
+    </div>
+  );
+}

package/templates/ai-studio/app/robots.ts

@@ -0,0 +1,14 @@
+import type { Robots } from "@pylonsync/react";
+
+// app/robots.ts → served at /robots.txt. Point SITE_URL at your domain in
+// production. The default export may also be async.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function robots(): Robots {
+  return {
+    // Keep the signed-in app and the API out of the index. `llms.txt` and the
+    // sitemap stay crawlable — they are what a crawler or agent reads first.
+    rules: { userAgent: "*", allow: "/", disallow: ["/api/", "/login"] },
+    sitemap: `${SITE}/sitemap.xml`,
+  };
+}

package/templates/ai-studio/app/sitemap.ts

@@ -0,0 +1,11 @@
+import type { Sitemap } from "@pylonsync/react";
+
+// app/sitemap.ts → served at /sitemap.xml. The default export can be async, so
+// it can enumerate pages from your database. Point SITE_URL at your domain in
+// production.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default async function sitemap(): Promise<Sitemap> {
+  // Only public pages belong here. The signed-in app is private.
+  return [{ url: `${SITE}/`, changeFrequency: "weekly", priority: 1 }];
+}

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/llms.ts

@@ -0,0 +1,30 @@
+import type { LlmsTxt } from "@pylonsync/react";
+
+// app/llms.ts → served at /llms.txt, in llmstxt.org format.
+//
+// This is the file an AI agent reads FIRST to decide what this site is and
+// whether it can help with the task in front of it. Keep the shape, rewrite the
+// copy: name the jobs this app is right for and the exact call to make. Generic
+// marketing copy does not read as guidance.
+//
+// The default export may be async, so it can enumerate pages from the database.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function llms(): LlmsTxt {
+  return {
+    title: "__APP_NAME__",
+    summary: "A starter app with one entity and a live list.",
+    details: [
+      "Use this app to read and create items. Every change is pushed to open clients over the sync connection.",
+      "Every page here is also readable as markdown: add `.md` to any path, or send `Accept: text/markdown`.",
+    ],
+    sections: [
+      {
+        title: "Pages",
+        links: [
+          { title: "Home", url: `${SITE}` },
+        ],
+      },
+    ],
+  };
+}

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/llms.ts

@@ -0,0 +1,30 @@
+import type { LlmsTxt } from "@pylonsync/react";
+
+// app/llms.ts → served at /llms.txt, in llmstxt.org format.
+//
+// This is the file an AI agent reads FIRST to decide what this site is and
+// whether it can help with the task in front of it. Keep the shape, rewrite the
+// copy: name the jobs this app is right for and the exact call to make. Generic
+// marketing copy does not read as guidance.
+//
+// The default export may be async, so it can enumerate pages from the database.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function llms(): LlmsTxt {
+  return {
+    title: "__APP_NAME__",
+    summary: "A realtime chat room.",
+    details: [
+      "Use this app to read and send messages in a shared room. Messages arrive on every open client without a refresh.",
+      "Every page here is also readable as markdown: add `.md` to any path, or send `Accept: text/markdown`.",
+    ],
+    sections: [
+      {
+        title: "Pages",
+        links: [
+          { title: "Home", url: `${SITE}` },
+        ],
+      },
+    ],
+  };
+}

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/llms.ts

@@ -0,0 +1,30 @@
+import type { LlmsTxt } from "@pylonsync/react";
+
+// app/llms.ts → served at /llms.txt, in llmstxt.org format.
+//
+// This is the file an AI agent reads FIRST to decide what this site is and
+// whether it can help with the task in front of it. Keep the shape, rewrite the
+// copy: name the jobs this app is right for and the exact call to make. Generic
+// marketing copy does not read as guidance.
+//
+// The default export may be async, so it can enumerate pages from the database.
+const SITE = process.env.SITE_URL ?? "http://localhost:4321";
+
+export default function llms(): LlmsTxt {
+  return {
+    title: "__APP_NAME__",
+    summary: "A social feed with posts and likes.",
+    details: [
+      "Use this app to read the public feed, post, and like. Reading needs no account; posting needs a session.",
+      "Every page here is also readable as markdown: add `.md` to any path, or send `Accept: text/markdown`.",
+    ],
+    sections: [
+      {
+        title: "Pages",
+        links: [
+          { title: "Home", url: `${SITE}` },
+        ],
+      },
+    ],
+  };
+}