create-smoodly-app 0.0.49 → 0.0.51

package/README.md

@@ -44,5 +44,8 @@ written, and a first editor who can sign in.
 Every prompt has a flag, so CI can run it: `--framework astro|next`, `--supabase local|hosted`, `--locales`,
 `--url`, `--publishable-key`, `--secret-key`, `--editor-email` (password from
 `SMOODLY_EDITOR_PASSWORD`), `--skip-link`, `--yes`. `--help` lists them.
+`--cloud` takes a Smoodly Cloud space's three values as a hosted project and
+skips `supabase init`, link, `db push` and the first editor: the shared
+project is migrated by Smoodly Cloud and the space's owner is its admin.
 A hidden `--smoodly-dep <spec>` overrides the `smoodly` dependency written into
 `package.json`; CI points it at the packed tarball.

package/dist/index.js

@@ -34,6 +34,7 @@ function parseFlags(argv) {
       starter: { type: "string" },
       framework: { type: "string" },
       "skip-link": { type: "boolean", default: false },
+      cloud: { type: "boolean", default: false },
       yes: { type: "boolean", short: "y", default: false },
       help: { type: "boolean", short: "h", default: false }
     }
@@ -43,6 +44,9 @@ function parseFlags(argv) {
   if (supabase !== void 0 && supabase !== "local" && supabase !== "hosted") {
     throw new Error(`--supabase must be "local" or "hosted", got "${supabase}"`);
   }
+  const cloud = values.cloud ?? false;
+  if (cloud && supabase === "local") throw new Error("--cloud takes a Smoodly Cloud space's values; it cannot be combined with --supabase local.");
+  if (cloud && values["editor-email"]) throw new Error("--cloud has no first editor to create: your smoodly.io account is the space's admin, and --editor-email does not apply. Invite others from the space page.");
   const starter = values.starter;
   if (starter !== void 0 && starter !== "lorem" && starter !== "blank") {
     throw new Error(`--starter must be "lorem" or "blank", got "${starter}"`);
@@ -53,12 +57,13 @@ function parseFlags(argv) {
   }
   return {
     name: positionals[0],
-    supabase,
+    supabase: cloud ? "hosted" : supabase,
     url: values.url,
     publishableKey: values["publishable-key"],
     secretKey: values["secret-key"],
     editorEmail: values["editor-email"],
     skipLink: values["skip-link"] ?? false,
+    cloud,
     yes: values.yes ?? false,
     help: values.help ?? false,
     smoodlyDep: values["smoodly-dep"],
@@ -84,6 +89,7 @@ Options:
   --secret-key <key>        Hosted: the service-role / secret key
   --editor-email <email>    The first editor (password from SMOODLY_EDITOR_PASSWORD)
   --skip-link               Hosted: do not run supabase link / db push
+  --cloud                   Smoodly Cloud: paste the three values from your space page; no supabase link or db push
   -y, --yes                 Accept every default
   -h, --help                This text
 `;
@@ -168,12 +174,20 @@ import * as p from "@clack/prompts";
 import { resolve as resolve2 } from "node:path";
 
 // src/env.ts
-function renderEnv(keys, siteUrl2 = "http://localhost:3000") {
-  return [
+function renderEnv(keys, siteUrl2 = "http://localhost:3000", mode = "self-host") {
+  const header = mode === "cloud" ? [
+    "# Smoodly Cloud: the values from your space page at smoodly.io/spaces.",
+    "# The live site reads with SMOODLY_URL and SMOODLY_SECRET_KEY; the admin",
+    "# also signs in with SMOODLY_PUBLISHABLE_KEY. Replace the key from the",
+    "# space page if it ever leaks."
+  ] : [
     "# Smoodly, self-host: the content project's values. The live site reads",
     "# with SMOODLY_URL and SMOODLY_SECRET_KEY; the admin also signs in with",
     "# SMOODLY_PUBLISHABLE_KEY. SMOODLY_AUTH_URL and SMOODLY_AUTH_KEY default",
-    "# to these \u2014 leave them unset.",
+    "# to these \u2014 leave them unset."
+  ];
+  return [
+    ...header,
     `SMOODLY_URL=${keys.url}`,
     `SMOODLY_SECRET_KEY=${keys.secretKey}`,
     `SMOODLY_PUBLISHABLE_KEY=${keys.publishableKey}`,
@@ -383,6 +397,9 @@ async function resolveAnswers(flags2, ctx, env = process.env) {
   if (!url) throw new Error(`${badUrl} (got "${typedUrl}")`);
   const publishableKey = flags2.publishableKey ?? await answer(p.text({ message: "Publishable (anon) key" }));
   const secretKey = flags2.secretKey ?? await answer(p.password({ message: "Secret (service role) key" }));
+  if (flags2.cloud) {
+    return { name, dir, supabase, hasSupabaseCli: ctx.hasSupabaseCli, hosted: { keys: { url, publishableKey, secretKey }, linkAndPush: false, cloud: true }, smoodlyDep: flags2.smoodlyDep, locales, starter, framework };
+  }
   const ref = projectRef(url);
   if (ctx.hasSupabaseCli && !flags2.skipLink && !ref) {
     p.log.warn(`No project ref in ${url}; skipping supabase link. Run \`supabase link --project-ref <project-ref>\` and \`supabase db push\` yourself.`);
@@ -431,11 +448,12 @@ function plan(a) {
   }
   const steps = ["copyTemplate", "install"];
   if (a.supabase === "local") steps.push("supabaseLocal");
-  else if (a.hasSupabaseCli) {
+  else if (a.hasSupabaseCli && !a.hosted?.cloud) {
     steps.push("supabaseInit");
     if (a.hosted?.linkAndPush) steps.push("linkAndPush");
   }
-  steps.push("writeEnv", "ensureEditor", "seed", "gitInit", "finish");
+  steps.push("writeEnv", ...a.hosted?.cloud ? [] : ["ensureEditor"], "seed");
+  steps.push("gitInit", "finish");
   return steps;
 }
 
@@ -555,7 +573,7 @@ async function run(answers2, deps) {
           await sh("supabase", ["db", "push"]);
           break;
         case "writeEnv":
-          await deps.fs.writeFile(join2(cwd, envFile(answers2)), renderEnv(ctx.keys, siteUrl(answers2)));
+          await deps.fs.writeFile(join2(cwd, envFile(answers2)), renderEnv(ctx.keys, siteUrl(answers2), answers2.hosted?.cloud ? "cloud" : "self-host"));
           break;
         case "ensureEditor":
           ctx.editor = await ensureEditor(deps.editorClient(ctx.keys), deps.askEditor);
@@ -580,7 +598,7 @@ async function run(answers2, deps) {
       return { ok: false, step, error, fallback: fallbackFor(step, answers2, ctx.keys) };
     }
   }
-  return { ok: true, keys: ctx.keys, editor: ctx.editor };
+  return ctx.editor ? { ok: true, keys: ctx.keys, editor: ctx.editor } : { ok: true, keys: ctx.keys };
 }
 var withoutSeedSql = (toml) => toml.replace(/(\[db\.seed\]\n(?:#.*\n)*enabled = )true/, "$1false");
 var envFile = (answers2) => answers2.framework === "astro" ? ".env" : ".env.local";
@@ -589,7 +607,7 @@ function fallbackFor(step, answers2, keys) {
   const envLines = keys ? `Write ${answers2.dir}/${envFile(answers2)}:
 
 ${renderEnv(keys, siteUrl(answers2)).split("\n").filter((l) => !l.startsWith("#")).join("\n").trimEnd()}` : `Write ${answers2.dir}/${envFile(answers2)} with SMOODLY_URL, SMOODLY_SECRET_KEY and SMOODLY_PUBLISHABLE_KEY (from \`supabase status\`), and SITE_URL=${siteUrl(answers2)}.`;
-  const editorLines = [
+  const editorLines = answers2.hosted?.cloud ? ["Then the starter content:", "", `cd ${answers2.dir} && npm run seed`].join("\n") : [
     "Create the first editor, then the starter content:",
     "",
     `cd ${answers2.dir} && SMOODLY_ADMIN_PASSWORD=<a password> npx smoodly add-admin <your email>`,
@@ -698,7 +716,7 @@ p2.note(
     "",
     answers.starter === "blank" ? `Site:  http://localhost:${port}  (a blank site \u2014 build it in ${answers.framework === "astro" ? "src/sections/, src/components/" : "components/"} and at /admin)` : `Site:  http://localhost:${port}  (the Lorem Co. starter \u2014 edit it at /admin)`,
     `Admin: http://localhost:${port}/admin`,
-    `Editor: ${outcome.editor.email ?? outcome.editor.id}`,
+    outcome.editor ? `Editor: ${outcome.editor.email ?? outcome.editor.id}` : "Editor: your smoodly.io account (invite others from the space page)",
     ...answers.locales ? [`Locales: ${answers.locales.join(", ")} (${answers.framework === "astro" ? "astro.config.ts and src/smoodly/config.ts" : "i18n/routing.ts"})`] : []
   ].join("\n"),
   "Ready"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-smoodly-app",
-  "version": "0.0.49",
+  "version": "0.0.51",
   "description": "Create a Smoodly site: a fresh Next.js app with the admin mounted, a Supabase schema, an env file and a first editor.",
   "license": "MIT",
   "repository": {

package/templates/astro-blank/package.json

@@ -13,7 +13,7 @@
     "@astrojs/node": "^11.1.6",
     "@supabase/supabase-js": "^2.113.0",
     "astro": "^7.3.5",
-    "smoodly": "0.0.49"
+    "smoodly": "0.0.51"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/astro-blank-intl/package.json

@@ -13,7 +13,7 @@
     "@astrojs/node": "^11.1.6",
     "@supabase/supabase-js": "^2.113.0",
     "astro": "^7.3.5",
-    "smoodly": "0.0.49"
+    "smoodly": "0.0.51"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/astro-lorem/package.json

@@ -13,7 +13,7 @@
     "@astrojs/node": "^11.1.6",
     "@supabase/supabase-js": "^2.113.0",
     "astro": "^7.3.5",
-    "smoodly": "0.0.49"
+    "smoodly": "0.0.51"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/astro-lorem-intl/package.json

@@ -13,7 +13,7 @@
     "@astrojs/node": "^11.1.6",
     "@supabase/supabase-js": "^2.113.0",
     "astro": "^7.3.5",
-    "smoodly": "0.0.49"
+    "smoodly": "0.0.51"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/blank/README.md

@@ -8,8 +8,7 @@ for an agent (or a person) building the site.
 
 ## Where things are
 
-- `app/(site)/page.tsx` — the home page: one line calling renderSmoodlyPath([]).
-- `app/(site)/[...path]/page.tsx` — every other page and every collection entry, at any depth.
+- `app/(site)/[[...path]]/page.tsx` — every CMS URL: the home, every page at any depth and every collection entry, rendered on first visit and cached until a publish expires it.
 - `app/(site)/layout.tsx` — the site's root layout: `app/globals.css`, the footer line from the `site` item. The admin is one route, `app/(smoodly)/admin/[[...segments]]/route.ts`, and takes no layout.
 - `components/pages/` — the page shapes and the entry page: `Home` (fixed at /, one freeform zone), `Page` (open, editors create many), `Post` (the entry page for posts).
 - `components/sections/Text.schema.ts` and `Text.tsx` — the one section: a title and a richtext body. The schema is listed in `smoodly/sections.ts`, the component in `smoodly/views.ts`.

package/templates/blank/app/(site)/[[...path]]/page.tsx

@@ -0,0 +1,23 @@
+import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
+
+type Params = Promise<{ path?: string[] }>;
+type SearchParams = Promise<Record<string, string | string[] | undefined>>;
+
+// Smoodly: every CMS URL — the home (no segments), pages at any depth and
+// collection entries under their `path`. A route file of your own beside
+// this one, app/(site)/<segment>/page.tsx, wins for that exact path; deeper
+// paths still resolve here. Each address renders on its first visit and is
+// served from the cache until a publish expires it, so nothing in a page
+// under this route may read cookies, headers or search params (a page that
+// needs them is its own route file).
+export function generateStaticParams() {
+  return [];
+}
+
+export async function generateMetadata({ params }: { params: Params }) {
+  return smoodlyMetadata((await params).path ?? []);
+}
+
+export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
+  return renderSmoodlyPath((await params).path ?? [], { searchParams });
+}

package/templates/blank/package.json

@@ -14,7 +14,7 @@
     "next": "^16.3.4",
     "react": "^19",
     "react-dom": "^19",
-    "smoodly": "0.0.49"
+    "smoodly": "0.0.51"
   },
   "devDependencies": {
     "@next/env": "^16.3.4",

package/templates/blank/smoodly/server.ts

@@ -16,8 +16,7 @@ import {
 // The admin's server pieces: the sign-in check and the content API. No browser code lives in the package's
 // entries; the admin itself is prebuilt and served by app/(smoodly)/admin/[[...segments]]/route.ts.
 import { createSmoodlyContent, supabaseAdminAuth, type AdminAuth, type AuthConfig, type SmoodlyContent } from "smoodly/admin";
-import { createPageRenderer, createSmoodlyQueries } from "smoodly/next";
-import { connection } from "next/server";
+import { buildGate, createPageRenderer, createSmoodlyQueries } from "smoodly/next";
 import type { SupabaseClient } from "@supabase/supabase-js";
 import { collections, config, globals } from "./config";
 import { views } from "./views";
@@ -97,16 +96,17 @@ export const href = (path: string, _locale: string) => path;
 export const q = (): Queries =>
   new Proxy({} as Queries, {
     get: (_, name) => async (...args: unknown[]) => {
-      await connection();
+      await buildGate();
       return (bound().q as unknown as Record<string | symbol, (...a: unknown[]) => unknown>)[name](...args);
     },
   });
 
-// A request first, then the env: `await connection()` makes the route dynamic before bound()
-// reads SMOODLY_*, so `next build` prerenders nothing here and needs no keys — a layout
-// reading a global through q() included (2026-10-02, tester round 6).
-/** The two route files call these. */
-export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPath(...args); };
-export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyMetadata(...args); };
-export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPage(...args); };
-export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyPageMetadata(...args); };
+// The gate first, then the env: `buildGate()` waits for a request while `next build` prerenders, so a
+// route file without a dynamic segment reads nothing at build and the build needs no keys — a layout
+// reading a global through q() included (2026-10-02, tester round 6). At run time it does nothing: a
+// CMS route renders on its first visit and is cached until a publish expires it (plan 2026-10-09).
+/** The route file calls these. */
+export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPath(...args); };
+export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyMetadata(...args); };
+export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPage(...args); };
+export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyPageMetadata(...args); };

package/templates/blank-intl/README.md

@@ -8,8 +8,7 @@ for an agent (or a person) building the site.
 
 ## Where things are
 
-- `app/[locale]/page.tsx` — the home page: one line calling renderSmoodlyPath([], { locale }).
-- `app/[locale]/[...path]/page.tsx` — every other page and every collection entry, at any depth, with translated segments per locale.
+- `app/[locale]/[[...path]]/page.tsx` — every CMS URL: the home, every page at any depth and every collection entry, with translated segments per locale, rendered on first visit and cached until a publish expires it.
 - `app/[locale]/layout.tsx` — the site's root layout: `app/globals.css`, the footer line from the `site` item. The admin is one route, `app/(smoodly)/admin/[[...segments]]/route.ts`, and takes no layout.
 - `i18n/routing.ts` — the locales and the default; `smoodly/config.ts` reads them from here. `i18n/request.ts` and `i18n/navigation.ts` are next-intl's stock files; `proxy.ts` is its locale routing (`/admin` excluded). UI strings go in `messages/<locale>.json`.
 - `components/pages/` — the page shapes and the entry page: `Home` (fixed at /, one freeform zone), `Page` (open, editors create many), `Post` (the entry page for posts).

package/templates/blank-intl/app/[locale]/[[...path]]/page.tsx

@@ -0,0 +1,25 @@
+import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
+
+type Params = Promise<{ locale: string; path?: string[] }>;
+type SearchParams = Promise<Record<string, string | string[] | undefined>>;
+
+// Smoodly: every CMS URL in this language — the home (no segments), pages
+// at any depth and collection entries under their `path`. A route file of
+// your own beside this one, app/[locale]/<segment>/page.tsx, wins for that
+// exact path; deeper paths still resolve here. Each address renders on its
+// first visit and is served from the cache until a publish expires it, so
+// nothing in a page under this route may read cookies, headers or search
+// params (a page that needs them is its own route file).
+export function generateStaticParams() {
+  return [];
+}
+
+export async function generateMetadata({ params }: { params: Params }) {
+  const { locale, path = [] } = await params;
+  return smoodlyMetadata(path, { locale });
+}
+
+export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
+  const { locale, path = [] } = await params;
+  return renderSmoodlyPath(path, { locale, searchParams });
+}

package/templates/blank-intl/package.json

@@ -14,7 +14,7 @@
     "next": "^16.3.4",
     "react": "^19",
     "react-dom": "^19",
-    "smoodly": "0.0.49",
+    "smoodly": "0.0.51",
     "next-intl": "^4.14.2"
   },
   "devDependencies": {

package/templates/blank-intl/smoodly/server.ts

@@ -16,8 +16,7 @@ import {
 // The admin's server pieces: the sign-in check and the content API. No browser code lives in the package's
 // entries; the admin itself is prebuilt and served by app/(smoodly)/admin/[[...segments]]/route.ts.
 import { createSmoodlyContent, supabaseAdminAuth, type AdminAuth, type AuthConfig, type SmoodlyContent } from "smoodly/admin";
-import { createPageRenderer, createSmoodlyQueries } from "smoodly/next";
-import { connection } from "next/server";
+import { buildGate, createPageRenderer, createSmoodlyQueries } from "smoodly/next";
 import type { SupabaseClient } from "@supabase/supabase-js";
 import { getPathname } from "@/i18n/navigation";
 import { collections, config, globals } from "./config";
@@ -98,16 +97,17 @@ export const href = (path: string, locale: string) => getPathname({ locale, href
 export const q = (): Queries =>
   new Proxy({} as Queries, {
     get: (_, name) => async (...args: unknown[]) => {
-      await connection();
+      await buildGate();
       return (bound().q as unknown as Record<string | symbol, (...a: unknown[]) => unknown>)[name](...args);
     },
   });
 
-// A request first, then the env: `await connection()` makes the route dynamic before bound()
-// reads SMOODLY_*, so `next build` prerenders nothing here and needs no keys — a layout
-// reading a global through q() included (2026-10-02, tester round 6).
-/** The two route files call these. */
-export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPath(...args); };
-export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyMetadata(...args); };
-export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPage(...args); };
-export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyPageMetadata(...args); };
+// The gate first, then the env: `buildGate()` waits for a request while `next build` prerenders, so a
+// route file without a dynamic segment reads nothing at build and the build needs no keys — a layout
+// reading a global through q() included (2026-10-02, tester round 6). At run time it does nothing: a
+// CMS route renders on its first visit and is cached until a publish expires it (plan 2026-10-09).
+/** The route file calls these. */
+export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPath(...args); };
+export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyMetadata(...args); };
+export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPage(...args); };
+export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyPageMetadata(...args); };

package/templates/lorem/README.md

@@ -8,8 +8,7 @@ for an agent (or a person) building the site.
 
 ## Where things are
 
-- `app/(site)/page.tsx` — the home page: one line calling renderSmoodlyPath([]).
-- `app/(site)/[...path]/page.tsx` — every other page and every collection entry, at any depth.
+- `app/(site)/[[...path]]/page.tsx` — every CMS URL: the home, every page at any depth and every collection entry, rendered on first visit and cached until a publish expires it.
 - `app/(site)/layout.tsx` — the site's root layout: fonts, `app/globals.css`, the footer from global content. The admin is one route, `app/(smoodly)/admin/[[...segments]]/route.ts`, and takes no layout.
 - `components/pages/` — the page shapes and the entry page: `Home` (locked hero, freeform body), `Articles` (a fixed page at the collection's path — its index — with a code-fetched grid), `Page` (open; About lives here), `Article` (the entry page), `News` and `NewsPost` (a collection at the nested address `company/news`, its index and entry page).
 - `components/PageFrame.tsx` — the header and `<main>` every page view renders (a layout cannot know which page is on screen); with more than one locale, the language links from the page's `locales` map — the same page in the other language, or its home when there is no translation.

package/templates/lorem/app/(site)/[[...path]]/page.tsx

@@ -0,0 +1,23 @@
+import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
+
+type Params = Promise<{ path?: string[] }>;
+type SearchParams = Promise<Record<string, string | string[] | undefined>>;
+
+// Smoodly: every CMS URL — the home (no segments), pages at any depth and
+// collection entries under their `path`. A route file of your own beside
+// this one, app/(site)/<segment>/page.tsx, wins for that exact path; deeper
+// paths still resolve here. Each address renders on its first visit and is
+// served from the cache until a publish expires it, so nothing in a page
+// under this route may read cookies, headers or search params (a page that
+// needs them is its own route file).
+export function generateStaticParams() {
+  return [];
+}
+
+export async function generateMetadata({ params }: { params: Params }) {
+  return smoodlyMetadata((await params).path ?? []);
+}
+
+export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
+  return renderSmoodlyPath((await params).path ?? [], { searchParams });
+}

package/templates/lorem/package.json

@@ -14,7 +14,7 @@
     "next": "^16.3.4",
     "react": "^19",
     "react-dom": "^19",
-    "smoodly": "0.0.49"
+    "smoodly": "0.0.51"
   },
   "devDependencies": {
     "@next/env": "^16.3.4",

package/templates/lorem/smoodly/server.ts

@@ -16,8 +16,7 @@ import {
 // The admin's server pieces: the sign-in check and the content API. No browser code lives in the package's
 // entries; the admin itself is prebuilt and served by app/(smoodly)/admin/[[...segments]]/route.ts.
 import { createSmoodlyContent, supabaseAdminAuth, type AdminAuth, type AuthConfig, type SmoodlyContent } from "smoodly/admin";
-import { createPageRenderer, createSmoodlyQueries } from "smoodly/next";
-import { connection } from "next/server";
+import { buildGate, createPageRenderer, createSmoodlyQueries } from "smoodly/next";
 import type { SupabaseClient } from "@supabase/supabase-js";
 import { collections, config, globals } from "./config";
 import { views } from "./views";
@@ -97,16 +96,17 @@ export const href = (path: string, _locale: string) => path;
 export const q = (): Queries =>
   new Proxy({} as Queries, {
     get: (_, name) => async (...args: unknown[]) => {
-      await connection();
+      await buildGate();
       return (bound().q as unknown as Record<string | symbol, (...a: unknown[]) => unknown>)[name](...args);
     },
   });
 
-// A request first, then the env: `await connection()` makes the route dynamic before bound()
-// reads SMOODLY_*, so `next build` prerenders nothing here and needs no keys — a layout
-// reading a global through q() included (2026-10-02, tester round 6).
-/** The two route files call these. */
-export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPath(...args); };
-export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyMetadata(...args); };
-export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPage(...args); };
-export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyPageMetadata(...args); };
+// The gate first, then the env: `buildGate()` waits for a request while `next build` prerenders, so a
+// route file without a dynamic segment reads nothing at build and the build needs no keys — a layout
+// reading a global through q() included (2026-10-02, tester round 6). At run time it does nothing: a
+// CMS route renders on its first visit and is cached until a publish expires it (plan 2026-10-09).
+/** The route file calls these. */
+export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPath(...args); };
+export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyMetadata(...args); };
+export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPage(...args); };
+export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyPageMetadata(...args); };

package/templates/lorem-intl/README.md

@@ -8,8 +8,7 @@ for an agent (or a person) building the site.
 
 ## Where things are
 
-- `app/[locale]/page.tsx` — the home page: one line calling renderSmoodlyPath([], { locale }).
-- `app/[locale]/[...path]/page.tsx` — every other page and every collection entry, at any depth, with translated segments per locale.
+- `app/[locale]/[[...path]]/page.tsx` — every CMS URL: the home, every page at any depth and every collection entry, with translated segments per locale, rendered on first visit and cached until a publish expires it.
 - `app/[locale]/layout.tsx` — the site's root layout: fonts, `app/globals.css`, the footer from global content. The admin is one route, `app/(smoodly)/admin/[[...segments]]/route.ts`, and takes no layout.
 - `i18n/routing.ts` — the locales and the default; `smoodly/config.ts` reads them from here. `i18n/request.ts` and `i18n/navigation.ts` are next-intl's stock files; `proxy.ts` is its locale routing (`/admin` excluded).
 - `components/pages/` — the page shapes and the entry page: `Home` (locked hero, freeform body), `Articles` (a fixed page at the collection's path — its index — with a code-fetched grid), `Page` (open; About lives here), `Article` (the entry page), `News` and `NewsPost` (a collection at the nested address `company/news`, its index and entry page).

package/templates/lorem-intl/app/[locale]/[[...path]]/page.tsx

@@ -0,0 +1,25 @@
+import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
+
+type Params = Promise<{ locale: string; path?: string[] }>;
+type SearchParams = Promise<Record<string, string | string[] | undefined>>;
+
+// Smoodly: every CMS URL in this language — the home (no segments), pages
+// at any depth and collection entries under their `path`. A route file of
+// your own beside this one, app/[locale]/<segment>/page.tsx, wins for that
+// exact path; deeper paths still resolve here. Each address renders on its
+// first visit and is served from the cache until a publish expires it, so
+// nothing in a page under this route may read cookies, headers or search
+// params (a page that needs them is its own route file).
+export function generateStaticParams() {
+  return [];
+}
+
+export async function generateMetadata({ params }: { params: Params }) {
+  const { locale, path = [] } = await params;
+  return smoodlyMetadata(path, { locale });
+}
+
+export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
+  const { locale, path = [] } = await params;
+  return renderSmoodlyPath(path, { locale, searchParams });
+}

package/templates/lorem-intl/package.json

@@ -14,7 +14,7 @@
     "next": "^16.3.4",
     "react": "^19",
     "react-dom": "^19",
-    "smoodly": "0.0.49",
+    "smoodly": "0.0.51",
     "next-intl": "^4.14.2"
   },
   "devDependencies": {

package/templates/lorem-intl/smoodly/server.ts

@@ -16,8 +16,7 @@ import {
 // The admin's server pieces: the sign-in check and the content API. No browser code lives in the package's
 // entries; the admin itself is prebuilt and served by app/(smoodly)/admin/[[...segments]]/route.ts.
 import { createSmoodlyContent, supabaseAdminAuth, type AdminAuth, type AuthConfig, type SmoodlyContent } from "smoodly/admin";
-import { createPageRenderer, createSmoodlyQueries } from "smoodly/next";
-import { connection } from "next/server";
+import { buildGate, createPageRenderer, createSmoodlyQueries } from "smoodly/next";
 import type { SupabaseClient } from "@supabase/supabase-js";
 import { getPathname } from "@/i18n/navigation";
 import { collections, config, globals } from "./config";
@@ -98,16 +97,17 @@ export const href = (path: string, locale: string) => getPathname({ locale, href
 export const q = (): Queries =>
   new Proxy({} as Queries, {
     get: (_, name) => async (...args: unknown[]) => {
-      await connection();
+      await buildGate();
       return (bound().q as unknown as Record<string | symbol, (...a: unknown[]) => unknown>)[name](...args);
     },
   });
 
-// A request first, then the env: `await connection()` makes the route dynamic before bound()
-// reads SMOODLY_*, so `next build` prerenders nothing here and needs no keys — a layout
-// reading a global through q() included (2026-10-02, tester round 6).
-/** The two route files call these. */
-export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPath(...args); };
-export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyMetadata(...args); };
-export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await connection(); return bound().renderer.renderSmoodlyPage(...args); };
-export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await connection(); return bound().renderer.smoodlyPageMetadata(...args); };
+// The gate first, then the env: `buildGate()` waits for a request while `next build` prerenders, so a
+// route file without a dynamic segment reads nothing at build and the build needs no keys — a layout
+// reading a global through q() included (2026-10-02, tester round 6). At run time it does nothing: a
+// CMS route renders on its first visit and is cached until a publish expires it (plan 2026-10-09).
+/** The route file calls these. */
+export const renderSmoodlyPath: Renderer["renderSmoodlyPath"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPath(...args); };
+export const smoodlyMetadata: Renderer["smoodlyMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyMetadata(...args); };
+export const renderSmoodlyPage: Renderer["renderSmoodlyPage"] = async (...args) => { await buildGate(); return bound().renderer.renderSmoodlyPage(...args); };
+export const smoodlyPageMetadata: Renderer["smoodlyPageMetadata"] = async (...args) => { await buildGate(); return bound().renderer.smoodlyPageMetadata(...args); };

package/templates/blank/app/(site)/[...path]/page.tsx

@@ -1,15 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type Params = Promise<{ path: string[] }>;
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: everything else — pages at any depth and collection entries
-// under their `path`. Add app/(site)/<segment>/page.tsx beside this file
-// and it wins for that exact path; deeper paths still resolve here.
-export async function generateMetadata({ params }: { params: Params }) {
-  return smoodlyMetadata((await params).path);
-}
-
-export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
-  return renderSmoodlyPath((await params).path, { searchParams });
-}

package/templates/blank/app/(site)/page.tsx

@@ -1,11 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: the home page. Editing this file replaces or wraps the CMS
-// home; the shapes it can render live in components/pages/.
-export const generateMetadata = () => smoodlyMetadata([]);
-
-export default async function Page({ searchParams }: { searchParams: SearchParams }) {
-  return renderSmoodlyPath([], { searchParams });
-}

package/templates/blank-intl/app/[locale]/[...path]/page.tsx

@@ -1,18 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type Params = Promise<{ locale: string; path: string[] }>;
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: everything else — pages at any depth and collection entries
-// under their `path`, with translated segments per locale. Add
-// app/[locale]/<segment>/page.tsx beside this file and it wins for that
-// exact path; deeper paths still resolve here.
-export async function generateMetadata({ params }: { params: Params }) {
-  const { locale, path } = await params;
-  return smoodlyMetadata(path, { locale });
-}
-
-export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
-  const { locale, path } = await params;
-  return renderSmoodlyPath(path, { locale, searchParams });
-}

package/templates/blank-intl/app/[locale]/page.tsx

@@ -1,15 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type Params = Promise<{ locale: string }>;
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: the home page, in the locale next-intl's proxy resolved. Editing
-// this file replaces or wraps the CMS home; the shapes it can render live
-// in components/pages/.
-export async function generateMetadata({ params }: { params: Params }) {
-  return smoodlyMetadata([], { locale: (await params).locale });
-}
-
-export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
-  return renderSmoodlyPath([], { locale: (await params).locale, searchParams });
-}

package/templates/lorem/app/(site)/[...path]/page.tsx

@@ -1,15 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type Params = Promise<{ path: string[] }>;
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: everything else — pages at any depth and collection entries
-// under their `path`. Add app/(site)/<segment>/page.tsx beside this file
-// and it wins for that exact path; deeper paths still resolve here.
-export async function generateMetadata({ params }: { params: Params }) {
-  return smoodlyMetadata((await params).path);
-}
-
-export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
-  return renderSmoodlyPath((await params).path, { searchParams });
-}

package/templates/lorem/app/(site)/page.tsx

@@ -1,11 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: the home page. Editing this file replaces or wraps the CMS
-// home; the shapes it can render live in components/pages/.
-export const generateMetadata = () => smoodlyMetadata([]);
-
-export default async function Page({ searchParams }: { searchParams: SearchParams }) {
-  return renderSmoodlyPath([], { searchParams });
-}

package/templates/lorem-intl/app/[locale]/[...path]/page.tsx

@@ -1,18 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type Params = Promise<{ locale: string; path: string[] }>;
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: everything else — pages at any depth and collection entries
-// under their `path`, with translated segments per locale. Add
-// app/[locale]/<segment>/page.tsx beside this file and it wins for that
-// exact path; deeper paths still resolve here.
-export async function generateMetadata({ params }: { params: Params }) {
-  const { locale, path } = await params;
-  return smoodlyMetadata(path, { locale });
-}
-
-export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
-  const { locale, path } = await params;
-  return renderSmoodlyPath(path, { locale, searchParams });
-}

package/templates/lorem-intl/app/[locale]/page.tsx

@@ -1,15 +0,0 @@
-import { renderSmoodlyPath, smoodlyMetadata } from "@/smoodly/server";
-
-type Params = Promise<{ locale: string }>;
-type SearchParams = Promise<Record<string, string | string[] | undefined>>;
-
-// Smoodly: the home page, in the locale next-intl's proxy resolved. Editing
-// this file replaces or wraps the CMS home; the shapes it can render live
-// in components/pages/.
-export async function generateMetadata({ params }: { params: Params }) {
-  return smoodlyMetadata([], { locale: (await params).locale });
-}
-
-export default async function Page({ params, searchParams }: { params: Params; searchParams: SearchParams }) {
-  return renderSmoodlyPath([], { locale: (await params).locale, searchParams });
-}