@pylonsync/create-pylon 0.4.28 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/create-pylon",
-  "version": "0.4.28",
+  "version": "0.5.0",
   "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/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/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-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/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/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/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}` },
+        ],
+      },
+    ],
+  };
+}

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/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/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/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/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/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/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/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/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` },
+        ],
+      },
+    ],
+  };
+}

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/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/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/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/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>
+  );
+}