@pylonsync/create-pylon 0.4.29 → 0.5.2

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/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 restaurant site: menu and table reservations.",
+    details: [
+      "Use this app to read the menu and reserve a table. Each seating shows how many tables are left.",
+      "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/restaurant/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/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/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 multi-tenant SaaS product: organizations, members, projects, and billing.",
+    details: [
+      "Use this app to sign up an organization, invite members, and manage projects. Billing runs through Stripe Checkout.",
+      "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/saas/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/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/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 storefront with a cart and Stripe checkout.",
+    details: [
+      "Use this app to browse products, add them to a cart, and check out. Stock is decremented when an order is 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: "Success", url: `${SITE}/success` },
+        ],
+      },
+    ],
+  };
+}

package/templates/shop/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/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/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 shared todo list with live updates.",
+    details: [
+      "Use this app to add, complete, and delete todos. A guest session is created on the first visit, so there is no sign-up step.",
+      "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/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/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 coming-soon page with email capture and a live signup counter.",
+    details: [
+      "Use this app to join the waitlist with an email address. The owner dashboard lists the signups.",
+      "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/waitlist/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/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;