@pylonsync/create-pylon 0.4.29 → 0.5.2

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/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 creator page: bio, offerings, and a newsletter signup.",
+    details: [
+      "Use this app to read what the creator offers and to subscribe to the newsletter.",
+      "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/creator/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/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/llms.ts

@@ -0,0 +1,32 @@
+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 CRM: companies, contacts, deals, and a pipeline.",
+    details: [
+      "Use this app to track companies and contacts and to move deals through the pipeline.",
+      "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: "Companies", url: `${SITE}/companies` },
+          { title: "Contacts", url: `${SITE}/contacts` },
+        ],
+      },
+    ],
+  };
+}

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/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: "A submission-based directory with search and categories.",
+    details: [
+      "Use this app to search listings by category and to submit a new listing for review.",
+      "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: "Submit", url: `${SITE}/submit` },
+        ],
+      },
+    ],
+  };
+}

package/templates/directory/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/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/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: "A support helpdesk: tickets, replies, and assignment.",
+    details: [
+      "Use this app to open a ticket, reply to one, and assign it.",
+      "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: "Customers", url: `${SITE}/customers` },
+        ],
+      },
+    ],
+  };
+}

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/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: "Inventory management: products, stock levels, and movements.",
+    details: [
+      "Use this app to read stock levels and to record a stock movement.",
+      "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: "Movements", url: `${SITE}/movements` },
+        ],
+      },
+    ],
+  };
+}

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/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: "Invoicing: clients, invoices, line items, and payment status.",
+    details: [
+      "Use this app to create an invoice for a client and to mark it paid.",
+      "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: "Clients", url: `${SITE}/clients` },
+        ],
+      },
+    ],
+  };
+}

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/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 appointment business: services, availability, and booking.",
+    details: [
+      "Use this app to list services, read open slots, and book one. A booked slot closes for every visitor at once.",
+      "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/local-service/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/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/llms.ts

@@ -0,0 +1,32 @@
+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 two-sided marketplace: listings, offers, and orders.",
+    details: [
+      "Use this app to browse listings, make an offer, and complete an order.",
+      "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: "Me", url: `${SITE}/me` },
+          { title: "Sell", url: `${SITE}/sell` },
+        ],
+      },
+    ],
+  };
+}

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/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: "Project tracking: projects, tasks, and assignees.",
+    details: [
+      "Use this app to create projects and tasks and to assign them.",
+      "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: "Clients", url: `${SITE}/clients` },
+        ],
+      },
+    ],
+  };
+}