@pylonsync/create-pylon 0.3.372 → 0.3.374

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/package.json +1 -1
  2. package/templates/_root/AGENTS.md +4 -2
  3. package/templates/agency/AGENTS.md +4 -2
  4. package/templates/agency/app/(marketing)/layout.tsx +136 -0
  5. package/templates/{creator/app → agency/app/(marketing)}/not-found.tsx +6 -2
  6. package/templates/agency/app/error.tsx +6 -3
  7. package/templates/agency/app/layout.tsx +8 -134
  8. package/templates/agency/app/login/page.tsx +3 -2
  9. package/templates/ai-chat/AGENTS.md +23 -2
  10. package/templates/ai-chat/app/(chat)/layout.tsx +46 -0
  11. package/templates/ai-chat/app/{not-found.tsx → (chat)/not-found.tsx} +5 -2
  12. package/templates/ai-chat/app/error.tsx +6 -3
  13. package/templates/ai-chat/app/layout.tsx +6 -39
  14. package/templates/ai-chat/app/login/page.tsx +2 -1
  15. package/templates/ai-studio/AGENTS.md +23 -2
  16. package/templates/ai-studio/app/(studio)/layout.tsx +46 -0
  17. package/templates/{agency/app → ai-studio/app/(studio)}/not-found.tsx +5 -2
  18. package/templates/ai-studio/app/error.tsx +6 -3
  19. package/templates/ai-studio/app/layout.tsx +6 -39
  20. package/templates/ai-studio/app/login/page.tsx +2 -1
  21. package/templates/barebones/AGENTS.md +4 -2
  22. package/templates/chat/AGENTS.md +23 -2
  23. package/templates/consumer/AGENTS.md +4 -2
  24. package/templates/creator/AGENTS.md +4 -2
  25. package/templates/creator/app/(marketing)/layout.tsx +122 -0
  26. package/templates/{ai-studio/app → creator/app/(marketing)}/not-found.tsx +6 -2
  27. package/templates/creator/app/error.tsx +6 -3
  28. package/templates/creator/app/layout.tsx +8 -120
  29. package/templates/creator/app/login/page.tsx +3 -2
  30. package/templates/crm/AGENTS.md +4 -2
  31. package/templates/directory/AGENTS.md +4 -2
  32. package/templates/directory/app/(marketing)/layout.tsx +133 -0
  33. package/templates/directory/app/(marketing)/not-found.tsx +23 -0
  34. package/templates/directory/app/error.tsx +6 -3
  35. package/templates/directory/app/layout.tsx +8 -131
  36. package/templates/directory/app/login/page.tsx +3 -2
  37. package/templates/helpdesk/AGENTS.md +4 -2
  38. package/templates/inventory/AGENTS.md +4 -2
  39. package/templates/invoices/AGENTS.md +4 -2
  40. package/templates/local-service/AGENTS.md +4 -2
  41. package/templates/local-service/app/(marketing)/layout.tsx +119 -0
  42. package/templates/local-service/app/(marketing)/not-found.tsx +23 -0
  43. package/templates/local-service/app/{page.tsx → (marketing)/page.tsx} +2 -2
  44. package/templates/local-service/app/error.tsx +3 -1
  45. package/templates/local-service/app/layout.tsx +8 -116
  46. package/templates/local-service/app/login/page.tsx +3 -2
  47. package/templates/local-service/components/marketing.tsx +1 -1
  48. package/templates/marketplace/AGENTS.md +4 -2
  49. package/templates/projects/AGENTS.md +4 -2
  50. package/templates/restaurant/AGENTS.md +4 -2
  51. package/templates/restaurant/app/(marketing)/layout.tsx +119 -0
  52. package/templates/restaurant/app/(marketing)/not-found.tsx +23 -0
  53. package/templates/restaurant/app/{page.tsx → (marketing)/page.tsx} +2 -2
  54. package/templates/restaurant/app/error.tsx +3 -1
  55. package/templates/restaurant/app/layout.tsx +8 -116
  56. package/templates/restaurant/app/login/page.tsx +3 -2
  57. package/templates/restaurant/components/marketing.tsx +1 -1
  58. package/templates/saas/AGENTS.md +4 -2
  59. package/templates/saas/app/(marketing)/layout.tsx +411 -0
  60. package/templates/saas/app/{not-found.tsx → (marketing)/not-found.tsx} +9 -5
  61. package/templates/saas/app/dashboard/page.tsx +3 -2
  62. package/templates/saas/app/error.tsx +7 -5
  63. package/templates/saas/app/layout.tsx +8 -408
  64. package/templates/saas/app/login/page.tsx +2 -1
  65. package/templates/saas/components/dashboard-shell.tsx +2 -2
  66. package/templates/shop/AGENTS.md +4 -2
  67. package/templates/shop/app/(marketing)/layout.tsx +122 -0
  68. package/templates/shop/app/(marketing)/not-found.tsx +23 -0
  69. package/templates/shop/app/{page.tsx → (marketing)/page.tsx} +1 -1
  70. package/templates/shop/app/error.tsx +3 -1
  71. package/templates/shop/app/layout.tsx +8 -120
  72. package/templates/shop/app/login/page.tsx +3 -2
  73. package/templates/todo/AGENTS.md +4 -2
  74. package/templates/waitlist/AGENTS.md +4 -2
  75. package/templates/waitlist/app/(marketing)/layout.tsx +122 -0
  76. package/templates/waitlist/app/(marketing)/not-found.tsx +23 -0
  77. package/templates/waitlist/app/{page.tsx → (marketing)/page.tsx} +1 -1
  78. package/templates/waitlist/app/error.tsx +3 -1
  79. package/templates/waitlist/app/layout.tsx +8 -120
  80. package/templates/waitlist/app/login/page.tsx +3 -2
  81. package/templates/directory/app/not-found.tsx +0 -19
  82. package/templates/local-service/app/not-found.tsx +0 -19
  83. package/templates/restaurant/app/not-found.tsx +0 -19
  84. package/templates/shop/app/not-found.tsx +0 -19
  85. package/templates/waitlist/app/not-found.tsx +0 -19
  86. /package/templates/agency/app/{contact-form.tsx → (marketing)/contact-form.tsx} +0 -0
  87. /package/templates/agency/app/{page.tsx → (marketing)/page.tsx} +0 -0
  88. /package/templates/agency/app/{seeder.tsx → (marketing)/seeder.tsx} +0 -0
  89. /package/templates/agency/app/{work → (marketing)/work}/[slug]/page.tsx +0 -0
  90. /package/templates/agency/app/{work → (marketing)/work}/page.tsx +0 -0
  91. /package/templates/ai-chat/app/{chat-client.tsx → (chat)/chat-client.tsx} +0 -0
  92. /package/templates/ai-chat/app/{page.tsx → (chat)/page.tsx} +0 -0
  93. /package/templates/ai-studio/app/{page.tsx → (studio)/page.tsx} +0 -0
  94. /package/templates/ai-studio/app/{studio-client.tsx → (studio)/studio-client.tsx} +0 -0
  95. /package/templates/creator/app/{newsletter-signup.tsx → (marketing)/newsletter-signup.tsx} +0 -0
  96. /package/templates/creator/app/{page.tsx → (marketing)/page.tsx} +0 -0
  97. /package/templates/directory/app/{directory-browse.tsx → (marketing)/directory-browse.tsx} +0 -0
  98. /package/templates/directory/app/{page.tsx → (marketing)/page.tsx} +0 -0
  99. /package/templates/directory/app/{submit → (marketing)/submit}/page.tsx +0 -0
  100. /package/templates/directory/app/{submit-form.tsx → (marketing)/submit-form.tsx} +0 -0
  101. /package/templates/local-service/app/{booking-widget.tsx → (marketing)/booking-widget.tsx} +0 -0
  102. /package/templates/restaurant/app/{reservation-widget.tsx → (marketing)/reservation-widget.tsx} +0 -0
  103. /package/templates/saas/app/{company → (marketing)/company}/[slug]/page.tsx +0 -0
  104. /package/templates/saas/app/{compare → (marketing)/compare}/[slug]/page.tsx +0 -0
  105. /package/templates/saas/app/{page.tsx → (marketing)/page.tsx} +0 -0
  106. /package/templates/saas/app/{products → (marketing)/products}/[slug]/page.tsx +0 -0
  107. /package/templates/saas/app/{resources → (marketing)/resources}/[slug]/page.tsx +0 -0
  108. /package/templates/saas/app/{solutions → (marketing)/solutions}/[slug]/page.tsx +0 -0
  109. /package/templates/shop/app/{shop-client.tsx → (marketing)/shop-client.tsx} +0 -0
  110. /package/templates/shop/app/{success → (marketing)/success}/page.tsx +0 -0
  111. /package/templates/waitlist/app/{waitlist-hero.tsx → (marketing)/waitlist-hero.tsx} +0 -0
@@ -1,7 +1,9 @@
1
1
  import React from "react";
2
2
  import { type ErrorBoundaryProps } from "@pylonsync/react";
3
3
 
4
- // `app/error.tsx` → the error boundary for this segment. Hydrated + interactive:
4
+ // `app/error.tsx` → the GLOBAL error boundary. Sitting at the app root
5
+ // (outside the `(marketing)` group), it catches a throw from any section and
6
+ // renders at HTTP 500 in the bare root shell. Hydrated + interactive:
5
7
  // `reset()` re-attempts the route. The thrown error reaches the client as
6
8
  // `{ message, digest }` only — the stack stays in the dev overlay / server logs.
7
9
  export default function Error({ error, reset }: ErrorBoundaryProps) {
@@ -1,32 +1,18 @@
1
1
  import React from "react";
2
- import { Link, type PageAuth } from "@pylonsync/react";
3
2
  import { siteConfig } from "@/lib/site.config";
4
3
  import { SectionScroller } from "@/components/section-scroller";
5
4
 
6
- // A layout wraps every page. This marketing layout renders a slim nav up top
7
- // and a footer below, both driven by lib/site.config.ts. `auth.user_id` is
8
- // resolved server-side from the session cookie before any HTML is sent, so the
9
- // nav shows "Dashboard" once the owner is signed in and "Sign in" otherwise —
10
- // no flash, no client fetch.
11
5
  interface LayoutProps {
12
6
  children: React.ReactNode;
13
- url: string;
14
- auth: PageAuth;
15
7
  }
16
8
 
17
- export default function RootLayout({ children, url, auth }: LayoutProps) {
18
- // A guest session (minted by <EnsureGuest> for the live stock grid) has a
19
- // `guest_…` user id that's an anonymous visitor, NOT the signed-in owner,
20
- // so it shouldn't flip the nav to "Dashboard".
21
- const signedIn = Boolean(auth?.user_id && !auth.user_id.startsWith("guest_"));
22
- const { brand, colors } = siteConfig;
23
-
24
- // The auth screens and the dashboard bring their own chrome, so they render
25
- // bare (no marketing nav/footer). Match on the path PREFIX, not a substring.
26
- const path = (url ?? "").split("?")[0];
27
- const BARE_PREFIXES = ["/login", "/dashboard"];
28
- const isBare = BARE_PREFIXES.some((p) => path === p || path.startsWith(p + "/"));
29
-
9
+ // The root layout is only the document shell: <html>, <head>, <body>, and the
10
+ // site-wide theme variables. Section chrome lives in route-group layouts
11
+ // `(marketing)/layout.tsx` adds the nav + footer for the storefront pages.
12
+ // /login and /dashboard sit outside the group and render bare here: the auth
13
+ // screen and the dashboard bring their own chrome.
14
+ export default function RootLayout({ children }: LayoutProps) {
15
+ const { colors } = siteConfig;
30
16
  return (
31
17
  <html
32
18
  lang="en"
@@ -53,106 +39,8 @@ export default function RootLayout({ children, url, auth }: LayoutProps) {
53
39
  </head>
54
40
  <body className="flex min-h-screen flex-col bg-background text-foreground antialiased">
55
41
  <SectionScroller />
56
- {isBare ? (
57
- children
58
- ) : (
59
- <>
60
- <header className="sticky top-0 z-30 bg-white/80 backdrop-blur">
61
- <div className="mx-auto flex h-14 max-w-3xl items-center justify-between px-6">
62
- <Link href="/" className="flex items-center gap-2">
63
- <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
64
- {brand.letter}
65
- </span>
66
- <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
67
- {brand.name}
68
- </span>
69
- </Link>
70
- <nav className="flex items-center gap-2">
71
- {signedIn ? (
72
- <Link
73
- href="/dashboard"
74
- className="inline-flex items-center rounded-full bg-zinc-900 px-3.5 py-1.5 text-[13px] font-medium text-white transition-colors hover:bg-zinc-700"
75
- >
76
- Dashboard
77
- </Link>
78
- ) : (
79
- <Link
80
- href="/login"
81
- className="rounded-full px-3 py-1.5 text-[13px] font-medium text-zinc-600 transition-colors hover:text-zinc-900"
82
- >
83
- Sign in
84
- </Link>
85
- )}
86
- </nav>
87
- </div>
88
- </header>
89
-
90
- <main className="flex-1">{children}</main>
91
-
92
- <SiteFooter />
93
- </>
94
- )}
42
+ {children}
95
43
  </body>
96
44
  </html>
97
45
  );
98
46
  }
99
-
100
- function SiteFooter() {
101
- const { brand } = siteConfig;
102
- return (
103
- <footer className="border-t border-zinc-200/70 bg-white">
104
- <div className="mx-auto max-w-3xl px-6 py-12">
105
- <div className="flex flex-col items-start justify-between gap-6 sm:flex-row">
106
- <div className="max-w-sm">
107
- <Link href="/" className="inline-flex items-center gap-2">
108
- <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
109
- {brand.letter}
110
- </span>
111
- <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
112
- {brand.name}
113
- </span>
114
- </Link>
115
- <p className="mt-3 text-[13px] leading-relaxed text-zinc-500">
116
- {brand.footerBlurb}
117
- </p>
118
- </div>
119
- <div className="flex items-center gap-4">
120
- {brand.socials.map((s) => (
121
- <a
122
- key={s.label}
123
- href={s.href}
124
- aria-label={s.label}
125
- className="text-zinc-400 transition-colors hover:text-zinc-900"
126
- >
127
- <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
128
- <path d={s.path} />
129
- </svg>
130
- </a>
131
- ))}
132
- <a
133
- href={`mailto:${brand.email}`}
134
- aria-label="Email"
135
- className="text-zinc-400 transition-colors hover:text-zinc-900"
136
- >
137
- <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
138
- <rect x="3" y="5" width="18" height="14" rx="2" />
139
- <path d="m3 7 9 6 9-6" />
140
- </svg>
141
- </a>
142
- </div>
143
- </div>
144
- <div className="mt-10 flex flex-col items-start justify-between gap-3 border-t border-zinc-200/70 pt-6 text-[12px] text-zinc-400 sm:flex-row sm:items-center">
145
- <span>
146
- © {new Date().getFullYear()} {brand.copyrightName}
147
- </span>
148
- <span>
149
- Built with{" "}
150
- <a href="https://pylonsync.com" className="font-medium text-zinc-600 hover:text-zinc-900">
151
- Pylon
152
- </a>
153
- </span>
154
- </div>
155
- </div>
156
- </footer>
157
- );
158
- }
@@ -8,8 +8,9 @@ export const metadata: Metadata = {
8
8
  robots: "noindex",
9
9
  };
10
10
 
11
- // `app/login/page.tsx` → `/login`. The owner's sign-in. Rendered bare (the
12
- // layout suppresses the marketing nav/footer for /login). Already signed in?
11
+ // `app/login/page.tsx` → `/login`. The owner's sign-in. Rendered bare
12
+ // /login sits outside the `(marketing)` route group, so no marketing nav or
13
+ // footer. Already signed in?
13
14
  // Skip straight to the dashboard — `response.redirect` in the synchronous shell
14
15
  // render is a real 307 before any HTML is sent.
15
16
  export default function LoginPage({ auth, response }: PageProps) {
@@ -6,7 +6,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
6
6
 
7
7
  **Unified SSR app:**
8
8
  - `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
9
- - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. `app/layout.tsx` is the shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
9
+ - `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.
10
10
  - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
11
11
  - `functions/`: server functions, one per file, `default`-exported.
12
12
  - `.pylon/`: local dev state (SQLite, jobs, sessions, uploads). Created by `pylon dev`. Do not commit.
@@ -33,7 +33,9 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
33
33
  - **Dynamic + catch-all routes follow Next conventions.** `app/blog/[slug]/page.tsx` → `params.slug`. `app/docs/[...path]/page.tsx` is a catch-all (matches `/docs/a/b/c`; `params.path === "a/b/c"`; `.split("/")` for segments). `app/shop/[[...filters]]/page.tsx` is an optional catch-all (also matches the bare `/shop`, with `params.filters === ""`). A catch-all must be the last segment; static beats dynamic beats catch-all on overlap.
34
34
  - **`serverData` (SSR) is READ-ONLY.** No write methods; the runtime rejects write frames (`SSR_WRITE_FORBIDDEN`). Mutations belong in actions/functions, never in a page render.
35
35
  - **`response.*` / `response.redirect()` / `response.notFound()` must fire in the synchronous shell render**, before any `await` / `<Suspense>`. The HTTP head commits when the shell is ready; status/headers/cookies set from a suspended subtree are lost, and `redirect`/`notFound` thrown below a Suspense boundary are swallowed.
36
- - **`ctx.llm` and `ctx.connections` are on mutation + action only, NOT query** (reactive purity). `action` has no direct `ctx.db`; use `ctx.runQuery` / `ctx.runMutation`.
36
+ - **`ctx.llm`, `ctx.rooms`, and `ctx.connections` are on mutation + action only, NOT query** (reactive purity). `action` has no direct `ctx.db`; use `ctx.runQuery` / `ctx.runMutation`.
37
+ - **`ctx.llm.stream(request, onEvent)` streams tokens as they generate** and still resolves with the full response, so `stop_reason === "tool_use"` drives an agent tool loop. Events are `text_delta` / `tool_use_start` / `tool_input_delta` / `done`. Same auth + model-allowlist gating as `ctx.llm.complete`. Streaming does NOT extend the call deadline (`PYLON_FN_CALL_TIMEOUT`, 30s default) — set `timeout: <secs>` on the def for a long run.
38
+ - **`ctx.stream.write(text)` reaches only the one client holding the HTTP response; `ctx.rooms.broadcast(room, topic, data)` reaches every subscriber of the room.** Broadcast is what makes agent output survive a closed tab or reach a second device. It resolves `{ delivered: false }` when the room has no members — a no-op, not an error. Clients receive with `useRoomMessages(room, cb)` from `@pylonsync/react`; `useRoom` is the send side.
37
39
  - **It's `db.useQueryOne`, not `useOne`.** Validators and field types have aliases: `v.bool`/`v.boolean`, `v.float`/`v.number`.
38
40
  - **Use the supported file and scheduling APIs.** Files go through `<FileUpload>` and `/api/files/*`; there is no `ctx.files`. One-shot work uses `ctx.scheduler.runAfter`, `runAt`, or `cancel`; there is no `defineWorkflow` or `defineJob`. Recurring work uses `cron("0 * * * *", "fnName")` in `buildManifest({ crons: [...] })`, imported from `@pylonsync/sdk`. Make the target function `internal: true`. It runs with anonymous auth, but its own `ctx.db.*` calls are server-side and bypass policies. Use `ctx.auth.elevate({ admin: true, reason: "..." })`, with a mandatory reason, only when chaining another internal function through `ctx.scheduler`.
39
41
 
@@ -6,7 +6,7 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
6
6
 
7
7
  **Unified SSR app:**
8
8
  - `app.ts`: data model + manifest (`entity()` + `field.*`, queries/actions/policies, `routes: await discoverAppRoutes()`). Ends with `console.log(JSON.stringify(manifest))`.
9
- - `app/`: file-based SSR routes. `app/page.tsx` → `/`, `app/about/page.tsx` → `/about`, `app/blog/[slug]/page.tsx` → `/blog/:slug`. `app/layout.tsx` is the shell; `app/error.tsx` / `app/not-found.tsx` are boundaries.
9
+ - `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.
10
10
  - `app/globals.css`: Tailwind v4 entrypoint (auto-compiled and injected).
11
11
  - `functions/`: server functions, one per file, `default`-exported.
12
12
  - `.pylon/`: local dev state (SQLite, jobs, sessions, uploads). Created by `pylon dev`. Do not commit.
@@ -33,7 +33,9 @@ Pylon serves the API, auth, sync, WebSocket, SSE, and native React 19 SSR from o
33
33
  - **Dynamic + catch-all routes follow Next conventions.** `app/blog/[slug]/page.tsx` → `params.slug`. `app/docs/[...path]/page.tsx` is a catch-all (matches `/docs/a/b/c`; `params.path === "a/b/c"`; `.split("/")` for segments). `app/shop/[[...filters]]/page.tsx` is an optional catch-all (also matches the bare `/shop`, with `params.filters === ""`). A catch-all must be the last segment; static beats dynamic beats catch-all on overlap.
34
34
  - **`serverData` (SSR) is READ-ONLY.** No write methods; the runtime rejects write frames (`SSR_WRITE_FORBIDDEN`). Mutations belong in actions/functions, never in a page render.
35
35
  - **`response.*` / `response.redirect()` / `response.notFound()` must fire in the synchronous shell render**, before any `await` / `<Suspense>`. The HTTP head commits when the shell is ready; status/headers/cookies set from a suspended subtree are lost, and `redirect`/`notFound` thrown below a Suspense boundary are swallowed.
36
- - **`ctx.llm` and `ctx.connections` are on mutation + action only, NOT query** (reactive purity). `action` has no direct `ctx.db`; use `ctx.runQuery` / `ctx.runMutation`.
36
+ - **`ctx.llm`, `ctx.rooms`, and `ctx.connections` are on mutation + action only, NOT query** (reactive purity). `action` has no direct `ctx.db`; use `ctx.runQuery` / `ctx.runMutation`.
37
+ - **`ctx.llm.stream(request, onEvent)` streams tokens as they generate** and still resolves with the full response, so `stop_reason === "tool_use"` drives an agent tool loop. Events are `text_delta` / `tool_use_start` / `tool_input_delta` / `done`. Same auth + model-allowlist gating as `ctx.llm.complete`. Streaming does NOT extend the call deadline (`PYLON_FN_CALL_TIMEOUT`, 30s default) — set `timeout: <secs>` on the def for a long run.
38
+ - **`ctx.stream.write(text)` reaches only the one client holding the HTTP response; `ctx.rooms.broadcast(room, topic, data)` reaches every subscriber of the room.** Broadcast is what makes agent output survive a closed tab or reach a second device. It resolves `{ delivered: false }` when the room has no members — a no-op, not an error. Clients receive with `useRoomMessages(room, cb)` from `@pylonsync/react`; `useRoom` is the send side.
37
39
  - **It's `db.useQueryOne`, not `useOne`.** Validators and field types have aliases: `v.bool`/`v.boolean`, `v.float`/`v.number`.
38
40
  - **Use the supported file and scheduling APIs.** Files go through `<FileUpload>` and `/api/files/*`; there is no `ctx.files`. One-shot work uses `ctx.scheduler.runAfter`, `runAt`, or `cancel`; there is no `defineWorkflow` or `defineJob`. Recurring work uses `cron("0 * * * *", "fnName")` in `buildManifest({ crons: [...] })`, imported from `@pylonsync/sdk`. Make the target function `internal: true`. It runs with anonymous auth, but its own `ctx.db.*` calls are server-side and bypass policies. Use `ctx.auth.elevate({ admin: true, reason: "..." })`, with a mandatory reason, only when chaining another internal function through `ctx.scheduler`.
39
41
 
@@ -0,0 +1,122 @@
1
+ import React from "react";
2
+ import { Link, type PageAuth } from "@pylonsync/react";
3
+ import { siteConfig } from "@/lib/site.config";
4
+
5
+ // `(marketing)` is a ROUTE GROUP: the parens segment is stripped from every
6
+ // URL (so `(marketing)/page.tsx` still serves `/`), and this layout wraps only
7
+ // the pages inside the group — a slim nav up top and a footer below, both
8
+ // driven by lib/site.config.ts. /login and /dashboard sit outside the group
9
+ // and render bare in the root shell. `auth.user_id` is resolved server-side
10
+ // from the session cookie before any HTML is sent, so the nav shows
11
+ // "Dashboard" once the owner is signed in and "Sign in" otherwise — no flash,
12
+ // no client fetch.
13
+ interface LayoutProps {
14
+ children: React.ReactNode;
15
+ auth: PageAuth;
16
+ }
17
+
18
+ export default function MarketingLayout({ children, auth }: LayoutProps) {
19
+ // A guest session (minted by <EnsureGuest> for the live counter) has a
20
+ // `guest_…` user id — that's an anonymous visitor, NOT the signed-in owner,
21
+ // so it shouldn't flip the nav to "Dashboard".
22
+ const signedIn = Boolean(auth?.user_id && !auth.user_id.startsWith("guest_"));
23
+ const { brand } = siteConfig;
24
+
25
+ return (
26
+ <>
27
+ <header className="sticky top-0 z-30 bg-white/80 backdrop-blur">
28
+ <div className="mx-auto flex h-14 max-w-3xl items-center justify-between px-6">
29
+ <Link href="/" className="flex items-center gap-2">
30
+ <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
31
+ {brand.letter}
32
+ </span>
33
+ <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
34
+ {brand.name}
35
+ </span>
36
+ </Link>
37
+ <nav className="flex items-center gap-2">
38
+ {signedIn ? (
39
+ <Link
40
+ href="/dashboard"
41
+ className="inline-flex items-center rounded-full bg-zinc-900 px-3.5 py-1.5 text-[13px] font-medium text-white transition-colors hover:bg-zinc-700"
42
+ >
43
+ Dashboard
44
+ </Link>
45
+ ) : (
46
+ <Link
47
+ href="/login"
48
+ className="rounded-full px-3 py-1.5 text-[13px] font-medium text-zinc-600 transition-colors hover:text-zinc-900"
49
+ >
50
+ Sign in
51
+ </Link>
52
+ )}
53
+ </nav>
54
+ </div>
55
+ </header>
56
+
57
+ <main className="flex-1">{children}</main>
58
+
59
+ <SiteFooter />
60
+ </>
61
+ );
62
+ }
63
+
64
+ function SiteFooter() {
65
+ const { brand } = siteConfig;
66
+ return (
67
+ <footer className="border-t border-zinc-200/70 bg-white">
68
+ <div className="mx-auto max-w-3xl px-6 py-12">
69
+ <div className="flex flex-col items-start justify-between gap-6 sm:flex-row">
70
+ <div className="max-w-sm">
71
+ <Link href="/" className="inline-flex items-center gap-2">
72
+ <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
73
+ {brand.letter}
74
+ </span>
75
+ <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
76
+ {brand.name}
77
+ </span>
78
+ </Link>
79
+ <p className="mt-3 text-[13px] leading-relaxed text-zinc-500">
80
+ {brand.footerBlurb}
81
+ </p>
82
+ </div>
83
+ <div className="flex items-center gap-4">
84
+ {brand.socials.map((s) => (
85
+ <a
86
+ key={s.label}
87
+ href={s.href}
88
+ aria-label={s.label}
89
+ className="text-zinc-400 transition-colors hover:text-zinc-900"
90
+ >
91
+ <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
92
+ <path d={s.path} />
93
+ </svg>
94
+ </a>
95
+ ))}
96
+ <a
97
+ href={`mailto:${brand.email}`}
98
+ aria-label="Email"
99
+ className="text-zinc-400 transition-colors hover:text-zinc-900"
100
+ >
101
+ <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
102
+ <rect x="3" y="5" width="18" height="14" rx="2" />
103
+ <path d="m3 7 9 6 9-6" />
104
+ </svg>
105
+ </a>
106
+ </div>
107
+ </div>
108
+ <div className="mt-10 flex flex-col items-start justify-between gap-3 border-t border-zinc-200/70 pt-6 text-[12px] text-zinc-400 sm:flex-row sm:items-center">
109
+ <span>
110
+ © {new Date().getFullYear()} {brand.copyrightName}
111
+ </span>
112
+ <span>
113
+ Built with{" "}
114
+ <a href="https://pylonsync.com" className="font-medium text-zinc-600 hover:text-zinc-900">
115
+ Pylon
116
+ </a>
117
+ </span>
118
+ </div>
119
+ </div>
120
+ </footer>
121
+ );
122
+ }
@@ -0,0 +1,23 @@
1
+ import React from "react";
2
+ import { Link, type NotFoundProps } from "@pylonsync/react";
3
+
4
+ // `(marketing)/not-found.tsx` → rendered at HTTP 404 for any unmatched URL
5
+ // (and when a page calls `response.notFound()`). It lives inside the
6
+ // `(marketing)` group on purpose: a group segment adds no URL prefix, so this
7
+ // is still the root 404 boundary, but it wraps in the marketing layout — a
8
+ // missing URL gets the site nav + footer instead of a bare page. Hydrated, so
9
+ // the link is a client nav.
10
+ export default function NotFound(_props: NotFoundProps) {
11
+ return (
12
+ <div className="mx-auto flex min-h-[60vh] max-w-3xl flex-col items-center justify-center px-6 text-center">
13
+ <h1 className="text-3xl font-semibold tracking-tight">404</h1>
14
+ <p className="mt-2 text-zinc-500">We couldn&apos;t find that page.</p>
15
+ <Link
16
+ href="/"
17
+ className="mt-6 inline-flex h-10 items-center rounded-full bg-zinc-900 px-5 text-sm font-medium text-white transition-colors hover:bg-zinc-700"
18
+ >
19
+ Back home
20
+ </Link>
21
+ </div>
22
+ );
23
+ }
@@ -17,7 +17,7 @@ export const metadata: Metadata = {
17
17
  },
18
18
  };
19
19
 
20
- // `app/page.tsx` → `/`. A server-rendered, single-page coming-soon landing.
20
+ // `app/(marketing)/page.tsx` → `/` (the group segment adds no URL prefix). A server-rendered, single-page coming-soon landing.
21
21
  // The headline, value props, proof, and FAQ are static server HTML (great for
22
22
  // SEO + first paint); the email form and live counter are a client island
23
23
  // (<WaitlistHero>) that hydrates in the browser. Every string is sourced from
@@ -1,7 +1,9 @@
1
1
  import React from "react";
2
2
  import { type ErrorBoundaryProps } from "@pylonsync/react";
3
3
 
4
- // `app/error.tsx` → the error boundary for this segment. Hydrated + interactive:
4
+ // `app/error.tsx` → the GLOBAL error boundary. Sitting at the app root
5
+ // (outside the `(marketing)` group), it catches a throw from any section and
6
+ // renders at HTTP 500 in the bare root shell. Hydrated + interactive:
5
7
  // `reset()` re-attempts the route. The thrown error reaches the client as
6
8
  // `{ message, digest }` only — the stack stays in the dev overlay / server logs.
7
9
  export default function Error({ error, reset }: ErrorBoundaryProps) {
@@ -1,31 +1,17 @@
1
1
  import React from "react";
2
- import { Link, type PageAuth } from "@pylonsync/react";
3
2
  import { siteConfig } from "@/lib/site.config";
4
3
 
5
- // A layout wraps every page. This marketing layout renders a slim nav up top
6
- // and a footer below, both driven by lib/site.config.ts. `auth.user_id` is
7
- // resolved server-side from the session cookie before any HTML is sent, so the
8
- // nav shows "Dashboard" once the owner is signed in and "Sign in" otherwise —
9
- // no flash, no client fetch.
10
4
  interface LayoutProps {
11
5
  children: React.ReactNode;
12
- url: string;
13
- auth: PageAuth;
14
6
  }
15
7
 
16
- export default function RootLayout({ children, url, auth }: LayoutProps) {
17
- // A guest session (minted by <EnsureGuest> for the live counter) has a
18
- // `guest_…` user id that's an anonymous visitor, NOT the signed-in owner,
19
- // so it shouldn't flip the nav to "Dashboard".
20
- const signedIn = Boolean(auth?.user_id && !auth.user_id.startsWith("guest_"));
21
- const { brand, colors } = siteConfig;
22
-
23
- // The auth screens and the dashboard bring their own chrome, so they render
24
- // bare (no marketing nav/footer). Match on the path PREFIX, not a substring.
25
- const path = (url ?? "").split("?")[0];
26
- const BARE_PREFIXES = ["/login", "/dashboard"];
27
- const isBare = BARE_PREFIXES.some((p) => path === p || path.startsWith(p + "/"));
28
-
8
+ // The root layout is only the document shell: <html>, <head>, <body>, and the
9
+ // site-wide theme variables. Section chrome lives in route-group layouts
10
+ // `(marketing)/layout.tsx` adds the nav + footer for the marketing pages.
11
+ // /login and /dashboard sit outside the group and render bare here: the auth
12
+ // screen and the dashboard bring their own chrome.
13
+ export default function RootLayout({ children }: LayoutProps) {
14
+ const { colors } = siteConfig;
29
15
  return (
30
16
  <html
31
17
  lang="en"
@@ -51,106 +37,8 @@ export default function RootLayout({ children, url, auth }: LayoutProps) {
51
37
  {/* Tailwind is compiled by Pylon from app/globals.css and injected here. */}
52
38
  </head>
53
39
  <body className="flex min-h-screen flex-col bg-background text-foreground antialiased">
54
- {isBare ? (
55
- children
56
- ) : (
57
- <>
58
- <header className="sticky top-0 z-30 bg-white/80 backdrop-blur">
59
- <div className="mx-auto flex h-14 max-w-3xl items-center justify-between px-6">
60
- <Link href="/" className="flex items-center gap-2">
61
- <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
62
- {brand.letter}
63
- </span>
64
- <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
65
- {brand.name}
66
- </span>
67
- </Link>
68
- <nav className="flex items-center gap-2">
69
- {signedIn ? (
70
- <Link
71
- href="/dashboard"
72
- className="inline-flex items-center rounded-full bg-zinc-900 px-3.5 py-1.5 text-[13px] font-medium text-white transition-colors hover:bg-zinc-700"
73
- >
74
- Dashboard
75
- </Link>
76
- ) : (
77
- <Link
78
- href="/login"
79
- className="rounded-full px-3 py-1.5 text-[13px] font-medium text-zinc-600 transition-colors hover:text-zinc-900"
80
- >
81
- Sign in
82
- </Link>
83
- )}
84
- </nav>
85
- </div>
86
- </header>
87
-
88
- <main className="flex-1">{children}</main>
89
-
90
- <SiteFooter />
91
- </>
92
- )}
40
+ {children}
93
41
  </body>
94
42
  </html>
95
43
  );
96
44
  }
97
-
98
- function SiteFooter() {
99
- const { brand } = siteConfig;
100
- return (
101
- <footer className="border-t border-zinc-200/70 bg-white">
102
- <div className="mx-auto max-w-3xl px-6 py-12">
103
- <div className="flex flex-col items-start justify-between gap-6 sm:flex-row">
104
- <div className="max-w-sm">
105
- <Link href="/" className="inline-flex items-center gap-2">
106
- <span className="flex size-6 items-center justify-center rounded-[7px] bg-zinc-900 text-[13px] font-bold text-white">
107
- {brand.letter}
108
- </span>
109
- <span className="text-[15px] font-semibold tracking-tight text-zinc-900">
110
- {brand.name}
111
- </span>
112
- </Link>
113
- <p className="mt-3 text-[13px] leading-relaxed text-zinc-500">
114
- {brand.footerBlurb}
115
- </p>
116
- </div>
117
- <div className="flex items-center gap-4">
118
- {brand.socials.map((s) => (
119
- <a
120
- key={s.label}
121
- href={s.href}
122
- aria-label={s.label}
123
- className="text-zinc-400 transition-colors hover:text-zinc-900"
124
- >
125
- <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
126
- <path d={s.path} />
127
- </svg>
128
- </a>
129
- ))}
130
- <a
131
- href={`mailto:${brand.email}`}
132
- aria-label="Email"
133
- className="text-zinc-400 transition-colors hover:text-zinc-900"
134
- >
135
- <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
136
- <rect x="3" y="5" width="18" height="14" rx="2" />
137
- <path d="m3 7 9 6 9-6" />
138
- </svg>
139
- </a>
140
- </div>
141
- </div>
142
- <div className="mt-10 flex flex-col items-start justify-between gap-3 border-t border-zinc-200/70 pt-6 text-[12px] text-zinc-400 sm:flex-row sm:items-center">
143
- <span>
144
- © {new Date().getFullYear()} {brand.copyrightName}
145
- </span>
146
- <span>
147
- Built with{" "}
148
- <a href="https://pylonsync.com" className="font-medium text-zinc-600 hover:text-zinc-900">
149
- Pylon
150
- </a>
151
- </span>
152
- </div>
153
- </div>
154
- </footer>
155
- );
156
- }
@@ -8,8 +8,9 @@ export const metadata: Metadata = {
8
8
  robots: "noindex",
9
9
  };
10
10
 
11
- // `app/login/page.tsx` → `/login`. The owner's sign-in. Rendered bare (the
12
- // layout suppresses the marketing nav/footer for /login). Already signed in?
11
+ // `app/login/page.tsx` → `/login`. The owner's sign-in. Rendered bare
12
+ // /login sits outside the `(marketing)` route group, so no marketing nav or
13
+ // footer. Already signed in?
13
14
  // Skip straight to the dashboard — `response.redirect` in the synchronous shell
14
15
  // render is a real 307 before any HTML is sent.
15
16
  export default function LoginPage({ auth, response }: PageProps) {
@@ -1,19 +0,0 @@
1
- import React from "react";
2
- import { Link, type NotFoundProps } from "@pylonsync/react";
3
-
4
- // `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL (and when a
5
- // page calls `response.notFound()`). Hydrated, so the link is a client nav.
6
- export default function NotFound(_props: NotFoundProps) {
7
- return (
8
- <div className="mx-auto flex min-h-[60vh] max-w-3xl flex-col items-center justify-center px-6 text-center">
9
- <h1 className="text-3xl font-semibold tracking-tight">404</h1>
10
- <p className="mt-2 text-zinc-500">We couldn&apos;t find that page.</p>
11
- <Link
12
- href="/"
13
- className="mt-6 inline-flex h-10 items-center rounded-full bg-zinc-900 px-5 text-sm font-medium text-white transition-colors hover:bg-zinc-700"
14
- >
15
- Back home
16
- </Link>
17
- </div>
18
- );
19
- }
@@ -1,19 +0,0 @@
1
- import React from "react";
2
- import { Link, type NotFoundProps } from "@pylonsync/react";
3
-
4
- // `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL (and when a
5
- // page calls `response.notFound()`). Hydrated, so the link is a client nav.
6
- export default function NotFound(_props: NotFoundProps) {
7
- return (
8
- <div className="mx-auto flex min-h-[60vh] max-w-3xl flex-col items-center justify-center px-6 text-center">
9
- <h1 className="text-3xl font-semibold tracking-tight">404</h1>
10
- <p className="mt-2 text-zinc-500">We couldn&apos;t find that page.</p>
11
- <Link
12
- href="/"
13
- className="mt-6 inline-flex h-10 items-center rounded-full bg-zinc-900 px-5 text-sm font-medium text-white transition-colors hover:bg-zinc-700"
14
- >
15
- Back home
16
- </Link>
17
- </div>
18
- );
19
- }
@@ -1,19 +0,0 @@
1
- import React from "react";
2
- import { Link, type NotFoundProps } from "@pylonsync/react";
3
-
4
- // `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL (and when a
5
- // page calls `response.notFound()`). Hydrated, so the link is a client nav.
6
- export default function NotFound(_props: NotFoundProps) {
7
- return (
8
- <div className="mx-auto flex min-h-[60vh] max-w-3xl flex-col items-center justify-center px-6 text-center">
9
- <h1 className="text-3xl font-semibold tracking-tight">404</h1>
10
- <p className="mt-2 text-zinc-500">We couldn&apos;t find that page.</p>
11
- <Link
12
- href="/"
13
- className="mt-6 inline-flex h-10 items-center rounded-full bg-zinc-900 px-5 text-sm font-medium text-white transition-colors hover:bg-zinc-700"
14
- >
15
- Back home
16
- </Link>
17
- </div>
18
- );
19
- }
@@ -1,19 +0,0 @@
1
- import React from "react";
2
- import { Link, type NotFoundProps } from "@pylonsync/react";
3
-
4
- // `app/not-found.tsx` → rendered at HTTP 404 for any unmatched URL (and when a
5
- // page calls `response.notFound()`). Hydrated, so the link is a client nav.
6
- export default function NotFound(_props: NotFoundProps) {
7
- return (
8
- <div className="mx-auto flex min-h-[60vh] max-w-3xl flex-col items-center justify-center px-6 text-center">
9
- <h1 className="text-3xl font-semibold tracking-tight">404</h1>
10
- <p className="mt-2 text-zinc-500">We couldn&apos;t find that page.</p>
11
- <Link
12
- href="/"
13
- className="mt-6 inline-flex h-10 items-center rounded-full bg-zinc-900 px-5 text-sm font-medium text-white transition-colors hover:bg-zinc-700"
14
- >
15
- Back home
16
- </Link>
17
- </div>
18
- );
19
- }