create-smoodly-app 0.0.37 → 0.0.39

package/dist/index.js

@@ -2,8 +2,10 @@
 
 // src/index.ts
 import * as p2 from "@clack/prompts";
-import { readFile as readFile2, rm, writeFile as writeFile2 } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import { readdir as readdir2, readFile as readFile2, rm, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join3, relative } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 // src/args.ts
 import { parseArgs } from "node:util";
@@ -61,7 +63,10 @@ function parseFlags(argv) {
 }
 var HELP = `create-smoodly-app \u2014 a fresh Next.js site with Smoodly installed
 
-Usage: npx create-smoodly-app [name] [options]
+Usage: npx create-smoodly-app [folder] [options]
+
+  folder: a name, a path or "." (the current empty folder). Its last part becomes
+  the package name: lowercase letters, digits, dots, dashes and underscores.
 
 Options:
   --supabase local|hosted   Where content lives (asked when omitted; local needs the Supabase CLI)
@@ -115,7 +120,7 @@ function supabaseEditorClient(keys) {
 
 // src/exec.ts
 import { spawn } from "node:child_process";
-var exec = (cmd, args, opts) => new Promise((resolve2, reject) => {
+var exec = (cmd, args, opts) => new Promise((resolve3, reject) => {
   const child = spawn(cmd, args, {
     cwd: opts.cwd,
     stdio: [opts.stdin ?? "inherit", opts.capture ? "pipe" : "inherit", "inherit"],
@@ -126,7 +131,7 @@ var exec = (cmd, args, opts) => new Promise((resolve2, reject) => {
   child.on("error", reject);
   child.on(
     "close",
-    (code) => code === 0 ? resolve2({ stdout }) : reject(new Error(`\`${cmd} ${args.join(" ")}\` exited with code ${code}`))
+    (code) => code === 0 ? resolve3({ stdout }) : reject(new Error(`\`${cmd} ${args.join(" ")}\` exited with code ${code}`))
   );
 });
 async function hasCommand(cmd, run2, cwd) {
@@ -141,10 +146,10 @@ async function hasCommand(cmd, run2, cwd) {
 // src/ports-net.ts
 import { createServer } from "node:net";
 function canListen(port, host) {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     const server = createServer();
-    server.once("error", () => resolve2(false));
-    server.listen(port, host, () => server.close(() => resolve2(true)));
+    server.once("error", () => resolve3(false));
+    server.listen(port, host, () => server.close(() => resolve3(true)));
   });
 }
 async function isPortFree(port) {
@@ -153,13 +158,15 @@ async function isPortFree(port) {
 
 // src/prompts.ts
 import * as p from "@clack/prompts";
-import { resolve } from "node:path";
+import { resolve as resolve2 } from "node:path";
 
 // src/env.ts
 function renderEnv(keys) {
   return [
-    "# Smoodly, self-host: the content project's values. SMOODLY_AUTH_URL and",
-    "# SMOODLY_AUTH_KEY default to these two \u2014 leave them unset.",
+    "# 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.",
     `SMOODLY_URL=${keys.url}`,
     `SMOODLY_SECRET_KEY=${keys.secretKey}`,
     `SMOODLY_PUBLISHABLE_KEY=${keys.publishableKey}`,
@@ -196,10 +203,13 @@ function projectRef(url) {
 
 // src/scaffold.ts
 import { cp, readdir, readFile, rename, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { basename, join, resolve } from "node:path";
+var nameFromDir = (dir) => basename(resolve(dir));
 function validName(name) {
   if (!name) return "The name is empty.";
-  if (!/^[a-z0-9][a-z0-9._-]*$/.test(name)) return "Use lowercase letters, digits, dots, dashes and underscores (it becomes the package name).";
+  if (!/^[a-z0-9][a-z0-9._-]*$/.test(name)) {
+    return `The folder name "${name}" becomes the package name: use lowercase letters, digits, dots, dashes and underscores.`;
+  }
   return null;
 }
 async function isEmptyOrMissing(dir) {
@@ -244,6 +254,13 @@ async function scaffold(opts) {
       routingPath,
       routing.replace(ROUTING_LOCALES, `  locales: [${opts.locales.map((l) => JSON.stringify(l)).join(", ")}],`).replace(ROUTING_DEFAULT, `  defaultLocale: ${JSON.stringify(opts.locales[0])},`)
     );
+    const source = await readFile(join(opts.dir, "messages", "en.json"), "utf8").catch(() => null);
+    if (source !== null) {
+      for (const locale of opts.locales) {
+        const file = join(opts.dir, "messages", `${locale}.json`);
+        if (await readFile(file, "utf8").catch(() => null) === null) await writeFile(file, source);
+      }
+    }
     if (opts.starter !== "blank") {
       const rewrites = [
         { map: articlesSegments(opts.locales), from: '{ en: "posts", fi: "artikkelit" }', lines: [["smoodly/collections.ts", ARTICLES_PATH_LINE], ["components/pages/Articles.tsx", ARTICLES_SLUG_LINE]] },
@@ -252,10 +269,10 @@ async function scaffold(opts) {
       for (const { map, from, lines } of rewrites) {
         for (const [rel, line] of lines) {
           const path = join(opts.dir, rel);
-          const source = await readFile(path, "utf8");
-          if (!source.includes(line)) throw new Error(`${rel} in the template has drifted; expected the line
+          const source2 = await readFile(path, "utf8");
+          if (!source2.includes(line)) throw new Error(`${rel} in the template has drifted; expected the line
 ${line}`);
-          await writeFile(path, source.replace(line, line.replace(from, map)));
+          await writeFile(path, source2.replace(line, line.replace(from, map)));
         }
       }
     }
@@ -278,10 +295,12 @@ async function answerOrThrow(value) {
   return v;
 }
 async function resolveAnswers(flags2, ctx, env = process.env) {
-  const name = flags2.name ?? await answer(p.text({ message: "Project name", placeholder: "my-site", validate: (v) => validName(v ?? "") ?? void 0 }));
+  const folderName = (typed2) => nameFromDir(resolve2(ctx.cwd, typed2));
+  const typed = flags2.name ?? await answer(p.text({ message: "Project folder", placeholder: "my-site", validate: (v) => v ? validName(folderName(v)) ?? void 0 : "A folder name or path." }));
+  const dir = resolve2(ctx.cwd, typed);
+  const name = nameFromDir(dir);
   const invalid = validName(name);
   if (invalid) bail(invalid);
-  const dir = resolve(ctx.cwd, name);
   if (!await isEmptyOrMissing(dir)) bail(`${dir} exists and is not empty.`);
   const locales = flags2.locales ?? (flags2.yes ? void 0 : await answer(p.confirm({ message: "Multilingual site? (next-intl, translated URLs)", initialValue: false })) ? await answer(
     p.text({
@@ -376,13 +395,13 @@ function plan(a) {
   if (a.supabase === "local" && !a.hasSupabaseCli) {
     throw new Error("Local mode needs the Supabase CLI: https://supabase.com/docs/guides/cli (brew install supabase/tap/supabase)");
   }
-  const steps = ["copyTemplate", "install", "gitInit"];
+  const steps = ["copyTemplate", "install"];
   if (a.supabase === "local") steps.push("supabaseLocal");
   else if (a.hasSupabaseCli) {
     steps.push("supabaseInit");
     if (a.hosted?.linkAndPush) steps.push("linkAndPush");
   }
-  steps.push("writeEnv", "ensureEditor", "seed", "finish");
+  steps.push("writeEnv", "ensureEditor", "seed", "gitInit", "finish");
   return steps;
 }
 
@@ -459,6 +478,8 @@ async function run(answers2, deps) {
           await sh("npm", ["install"]);
           break;
         case "gitInit":
+          await deps.agentFiles?.(cwd).catch(() => {
+          });
           await sh("git", ["init"], { capture: true });
           await sh("git", ["add", "-A"], { capture: true });
           await sh("git", ["commit", "-m", "Smoodly site"], { capture: true });
@@ -467,19 +488,22 @@ async function run(answers2, deps) {
           deps.log("Starting the local Supabase stack (first run pulls Docker images)\u2026");
           await sh("supabase", ["init"], { stdin: "ignore" });
           const configPath = join2(cwd, "supabase/config.toml");
-          const toml = await deps.fs.readFile(configPath);
+          const toml = withoutSeedSql(await deps.fs.readFile(configPath));
           const base = await findFreeBlock(blockPorts(toml), deps.isPortFree);
+          await deps.fs.writeFile(configPath, base !== DEFAULT_BASE ? shiftBlock(toml, base) : toml);
           if (base !== DEFAULT_BASE) {
-            await deps.fs.writeFile(configPath, shiftBlock(toml, base));
             deps.log(`Ports ${DEFAULT_BASE / 100}xx are busy (another Supabase project running?), using ${base / 100}xx.`);
           }
           await sh("supabase", LOCAL_START_ARGS);
           ctx.keys = parseStatusEnv((await sh("supabase", ["status", "-o", "env"], { capture: true })).stdout);
           break;
         }
-        case "supabaseInit":
+        case "supabaseInit": {
           await sh("supabase", ["init"], { stdin: "ignore" });
+          const configPath = join2(cwd, "supabase/config.toml");
+          await deps.fs.writeFile(configPath, withoutSeedSql(await deps.fs.readFile(configPath)));
           break;
+        }
         case "linkAndPush":
           await sh("supabase", linkArgs(answers2));
           await sh("supabase", ["db", "push"]);
@@ -512,10 +536,11 @@ async function run(answers2, deps) {
   }
   return { ok: true, keys: ctx.keys, editor: ctx.editor };
 }
+var withoutSeedSql = (toml) => toml.replace(/(\[db\.seed\]\n(?:#.*\n)*enabled = )true/, "$1false");
 function fallbackFor(step, answers2, keys) {
-  const envLines = keys ? `Write ${answers2.name}/.env.local:
+  const envLines = keys ? `Write ${answers2.dir}/.env.local:
 
-${renderEnv(keys).split("\n").filter((l) => !l.startsWith("#")).join("\n").trimEnd()}` : `Write ${answers2.name}/.env.local with SMOODLY_URL, SMOODLY_SECRET_KEY and SMOODLY_PUBLISHABLE_KEY (from \`supabase status\`).`;
+${renderEnv(keys).split("\n").filter((l) => !l.startsWith("#")).join("\n").trimEnd()}` : `Write ${answers2.dir}/.env.local with SMOODLY_URL, SMOODLY_SECRET_KEY and SMOODLY_PUBLISHABLE_KEY (from \`supabase status\`).`;
   const editorLines = [
     "Create the first editor: add a user in Supabase Studio (Authentication \u2192 Users), then in the SQL editor:",
     "",
@@ -523,13 +548,13 @@ ${renderEnv(keys).split("\n").filter((l) => !l.startsWith("#")).join("\n").trimE
   ].join("\n");
   switch (step) {
     case "supabaseLocal":
-      return [`cd ${answers2.name} && supabase init && supabase ${LOCAL_START_ARGS.join(" ")}`, "", envLines, "", editorLines].join("\n");
+      return [`cd ${answers2.dir} && supabase init && supabase ${LOCAL_START_ARGS.join(" ")}`, "", envLines, "", editorLines].join("\n");
     case "supabaseInit": {
-      const commands = answers2.hosted?.linkAndPush ? [`cd ${answers2.name} && supabase init && ${linkCommand(answers2)} && supabase db push`] : [`cd ${answers2.name} && supabase init`, "", `When you are ready: ${linkCommand(answers2)} && supabase db push`];
+      const commands = answers2.hosted?.linkAndPush ? [`cd ${answers2.dir} && supabase init && ${linkCommand(answers2)} && supabase db push`] : [`cd ${answers2.dir} && supabase init`, "", `When you are ready: ${linkCommand(answers2)} && supabase db push`];
       return [...commands, "", envLines, "", editorLines].join("\n");
     }
     case "linkAndPush":
-      return [`cd ${answers2.name} && ${linkCommand(answers2)} && supabase db push`, "", envLines, "", editorLines].join("\n");
+      return [`cd ${answers2.dir} && ${linkCommand(answers2)} && supabase db push`, "", envLines, "", editorLines].join("\n");
     case "writeEnv":
       return [envLines, "", editorLines].join("\n");
     case "ensureEditor":
@@ -539,7 +564,7 @@ ${renderEnv(keys).split("\n").filter((l) => !l.startsWith("#")).join("\n").trimE
         editorLines
       ].join("\n");
     case "seed":
-      return `cd ${answers2.name} && npm run seed`;
+      return `cd ${answers2.dir} && npm run seed`;
     default:
       return "";
   }
@@ -580,6 +605,7 @@ var outcome;
 try {
   const hasSupabaseCli = await hasCommand("supabase", exec, process.cwd());
   answers = await resolveAnswers(flags, { hasSupabaseCli, cwd: process.cwd() });
+  const existed = existsSync(answers.dir);
   outcome = await run(answers, {
     exec,
     templateDirs: TEMPLATE_DIRS,
@@ -592,7 +618,14 @@ try {
       scaffold,
       readFile: (path) => readFile2(path, "utf8"),
       writeFile: (path, text2) => writeFile2(path, text2),
-      rm: (dir) => rm(dir, { recursive: true, force: true })
+      rm: async (dir) => {
+        if (!existed) return rm(dir, { recursive: true, force: true });
+        for (const name of await readdir2(dir)) await rm(join3(dir, name), { recursive: true, force: true });
+      }
+    },
+    agentFiles: async (dir) => {
+      const gen = await import(pathToFileURL(join3(dir, "node_modules/next/dist/server/lib/generate-agent-files.js")).href);
+      (gen.writeAgentFiles ?? gen.default?.writeAgentFiles)(dir);
     }
   });
 } catch (e) {
@@ -606,7 +639,7 @@ if (!outcome.ok) {
 }
 p2.note(
   [
-    `cd ${answers.name}`,
+    ...relative(process.cwd(), answers.dir) ? [`cd ${relative(process.cwd(), answers.dir)}`] : [],
     "npm run dev",
     "",
     answers.starter === "blank" ? "Site:  http://localhost:3000  (a blank site \u2014 build it in components/ and at /admin)" : "Site:  http://localhost:3000  (the Lorem Co. starter \u2014 edit it at /admin)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-smoodly-app",
-  "version": "0.0.37",
+  "version": "0.0.39",
   "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/blank/AGENTS.md

@@ -13,14 +13,16 @@ where things are.
   is the one registry. A component that is not registered does not exist
   for the admin.
 - **After a new collection or a `smoodly` upgrade, run `npx smoodly migrate`**
-  and apply what it writes (`supabase db push` hosted, `supabase db reset`
+  and apply what it writes (`supabase db push` hosted, `supabase migration up`
   local). It copies the core schema files the package ships and writes a
   read view and order index per collection. Never edit a file it wrote.
   The admin reads the base tables, so it lists a collection either way;
   the view is for SQL and PostgREST readers, the index for `order`.
-- **Seed through the stores.** `scripts/seed.ts` is starter content,
-  written through the page and entry stores, never raw SQL. It is
-  idempotent; run it with `npm run seed`.
+- **Content from code goes through `content()`.** `scripts/seed.ts` is
+  starter content written with `content()` from `smoodly/server.ts`:
+  the admin's own operations, so validation and publish checks apply and
+  a failure throws. Never write rows or call the stores directly. The
+  seed is idempotent; run it with `npm run seed`.
 - **Never import the admin into the site.** Nothing under `app/(site)`,
   `app/[locale]` or `components/`, and nothing they import
   (`smoodly/server.ts` included), may import `@/smoodly/admin` or
@@ -50,6 +52,6 @@ where things are.
 ## Commands
 
     npm run dev          # http://localhost:3000, /admin is the editor
-    npm run build        # next build
+    npm run build        # checks the schema files (smoodly migrate --check), then next build
     npm run seed         # starter content, idempotent
     npm run typecheck    # tsc --noEmit

package/templates/blank/README.md

@@ -15,8 +15,8 @@ for an agent (or a person) building the site.
 - `components/sections/Text.tsx` — the one section: a title and a richtext body. Listed in `smoodly/sections.ts`.
 - `components/elements/Button.tsx` — the one element: a link styled as a button, embedded in richtext through `smoodly/toolsets.ts`.
 - `components/LocaleNav.tsx` — the language links every page view renders from its `locales` map: the same page in the other language, or its home when there is no translation; nothing with one locale.
-- `smoodly/` — the wiring: `config.ts` (the registry and settings), `collections.ts` (posts), `globals.ts` (the site item), `sections.ts`, `elements.ts`, `toolsets.ts`, `server.ts` (stores, site layer, renderer, the read API `q`), `ops.ts` (the admin's one server action), `admin.tsx` (the admin mount), `richtext.tsx` (the bound renderer).
-- `scripts/seed.ts` — the home page and the site item, written through the stores. `npm run seed` is idempotent.
+- `smoodly/` — the wiring: `config.ts` (the registry and settings), `collections.ts` (posts), `globals.ts` (the site item), `sections.ts`, `elements.ts`, `toolsets.ts`, `server.ts` (site layer, renderer, the read API `q`, the content API `content()`), `ops.ts` (the admin's one server action), `admin.tsx` (the admin mount), `richtext.tsx` (the bound renderer).
+- `scripts/seed.ts` — the home page and the site item, written through the content API (`content()`). `npm run seed` is idempotent.
 - `app/globals.css` — a reset, a container, the two tones. Replace it.
 - `.env.local` — `SMOODLY_URL`, `SMOODLY_SECRET_KEY`, `SMOODLY_PUBLISHABLE_KEY`.
 
@@ -43,7 +43,7 @@ collection to `collections`, and write its entry page by copying
 Then write its read view and order index and apply them:
 
     npx smoodly migrate
-    supabase db push        # hosted; `supabase db reset` for the local stack
+    supabase db push        # hosted; `supabase migration up` for the local stack (keeps the content)
 
 The same command brings the core schema forward after a `smoodly` upgrade.
 

package/templates/blank/_gitignore

@@ -3,3 +3,4 @@ node_modules/
 .env.local
 next-env.d.ts
 *.tsbuildinfo
+smoodly-export-*

package/templates/blank/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "scripts": {
     "dev": "next dev",
-    "build": "next build",
+    "build": "smoodly migrate --check && next build",
     "start": "next start",
     "seed": "tsx scripts/seed.ts",
     "typecheck": "tsc --noEmit"
@@ -14,7 +14,7 @@
     "next": "^16.3.4",
     "react": "^19",
     "react-dom": "^19",
-    "smoodly": "0.0.37"
+    "smoodly": "0.0.39"
   },
   "devDependencies": {
     "@next/env": "^16.3.4",

package/templates/blank/scripts/seed.ts

@@ -1,25 +1,30 @@
-// The starter's content, written through the stores (never raw inserts:
-// the refs index and publish integrity are part of the point). Ships in
-// the scaffold; create-smoodly-app runs `npm run seed` after the first
-// editor. Idempotent: exits once the home page exists in the default
-// locale. Writes the same copy into every configured locale, whatever
+// The starter's content, written through the content API (`content()`
+// from smoodly/server.ts): the admin's own operations, so validation and
+// the publish checks apply and a failure throws. It is also the example
+// of writing content from code. Ships in the scaffold; create-smoodly-app
+// runs `npm run seed` after the first editor. Idempotent: exits once the
+// home page has content in the default locale. Writes the same copy into every configured locale, whatever
 // their codes, so every locale's "/" resolves.
 // Run: npm run seed  (needs .env.local and a Supabase stack).
 import next from "@next/env";
-import type { PageTree } from "smoodly";
+import type { PageTree, TreeNode } from "smoodly";
 const { loadEnvConfig } = next;
 
 loadEnvConfig(process.cwd());
 
 const { config } = await import("../smoodly/config");
-const { stores } = await import("../smoodly/server");
-const { pages, entries } = stores();
+const { content, node } = await import("../smoodly/server");
+const { Text } = await import("../components/sections/Text");
+const c = content();
 
 const DEFAULT = config.locales.default;
 const OTHERS = config.locales.supported.filter((l) => l !== DEFAULT);
 
-if (await pages.resolvePath(DEFAULT, "/")) {
-  console.log(`Already seeded — "home" exists in "${DEFAULT}".`);
+// The home page is code-owned: `find` returns its record, creating it when
+// the database is new. It is seeded once somebody has given it sections.
+const home = (await c.pages.find(DEFAULT, "/"))!;
+if (Object.values((await c.pages.getTree(home.id, DEFAULT))?.zones ?? {}).some((nodes) => nodes.length > 0)) {
+  console.log(`Already seeded — the home page has content in "${DEFAULT}".`);
   process.exit(0);
 }
 
@@ -31,54 +36,47 @@ const doc = (...content: Node[]) => ({ type: "doc", content });
 
 // --- the site item: name and tagline, published in every locale ------
 
-const site = await entries.create("site", { name: "My site", tagline: "Built with Smoodly" }, { locale: DEFAULT });
-await entries.setStatus("site", site.id, DEFAULT, "published");
-for (const locale of OTHERS) {
-  await entries.addLocale("site", site.id, locale, { from: DEFAULT });
-  await entries.setStatus("site", site.id, locale, "published");
+for (const locale of [DEFAULT, ...OTHERS]) {
+  await c.globals.set("site", locale, { name: "My site", tagline: "Built with Smoodly" });
+  await c.globals.publish("site", locale);
 }
 
 // --- the home page: one Text section and one custom section ----------
 
-const tree = {
+// The custom section is not a registered section, so it is a plain node object.
+const custom: TreeNode = {
+  id: "node-custom",
+  type: "custom",
+  fields: { rows: [
+    { spans: [6, 6], gap: "md", align: "top", reverse: false, columns: [
+      doc(p("A custom section holds rows of columns. Drag the width bar in the inspector to resize them.")),
+      doc(p("Each column is richtext. Columns stack on small screens; the developer's stylesheet needs nothing.")),
+    ] },
+  ] },
+};
+
+const tree: PageTree = {
   meta: { description: "A new site, built with Smoodly." },
   zones: {
     body: [
-      {
-        id: "node-hello",
-        type: "text",
-        settings: { background: "paper" },
-        fields: {
-          title: "Hello",
-          body: doc(
-            p("This is your home page. Open the admin to edit this text, add sections, create pages and write posts."),
-            p("Everything you see is defined in components/ and registered in smoodly/. The README says where things are."),
-            button("Open the admin", "/admin"),
-          ),
-        },
-      },
+      node(Text, {
+        title: "Hello",
+        body: doc(
+          p("This is your home page. Open the admin to edit this text, add sections, create pages and write posts."),
+          p("Everything you see is defined in components/ and registered in smoodly/. The README says where things are."),
+          button("Open the admin", "/admin"),
+        ),
+      }, { id: "node-hello", settings: { background: "paper" } }),
       // The custom section: the editor's own rows of columns, rendered by Smoodly.
-      {
-        id: "node-custom",
-        type: "custom",
-        fields: { rows: [
-          { spans: [6, 6], gap: "md", align: "top", reverse: false, columns: [
-            doc(p("A custom section holds rows of columns. Drag the width bar in the inspector to resize them.")),
-            doc(p("Each column is richtext. Columns stack on small screens; the developer's stylesheet needs nothing.")),
-          ] },
-        ] },
-      },
+      custom,
     ],
   },
-} as unknown as PageTree;
+};
 
-const home = await pages.createPage({ locale: DEFAULT, slug: "home", title: "Home", template: "home", fixed: "page:home" });
-await pages.saveDraft(home.id, DEFAULT, tree);
-await pages.publish(home.id, DEFAULT);
-for (const locale of OTHERS) {
-  await pages.addLocale(home.id, locale, { from: DEFAULT, title: "Home" });
-  await pages.saveDraft(home.id, locale, tree);
-  await pages.publish(home.id, locale);
+// The home page exists in every locale already (its registration says so): write the tree and publish.
+for (const locale of [DEFAULT, ...OTHERS]) {
+  await c.pages.setTree(home.id, locale, tree);
+  await c.pages.publish(home.id, locale);
 }
 
 console.log(`Seeded the blank starter in "${[DEFAULT, ...OTHERS].join('", "')}": the home page and the site item, published.`);

package/templates/blank/smoodly/collections.ts

@@ -6,7 +6,7 @@ import { text } from "./toolsets";
 // .localized() are stored per locale; the rest are shared across
 // locales. To add a collection: copy this block, add it to
 // `collections`, run `npx smoodly migrate` and apply the file it writes
-// (supabase db push, or supabase db reset locally).
+// (supabase db push, or supabase migration up locally).
 export const posts = smoodly.collection({
   name: "posts",
   title: "Posts",

package/templates/blank/smoodly/ops.ts

@@ -4,8 +4,8 @@
 // async functions — hence the shape.)
 import { createAdminOpHandler, type AdminOpCall } from "smoodly/admin/next";
 import { config } from "./config";
-import { adminAuth, href, stores } from "./server";
+import { adminDeps } from "./server";
 
 export async function smoodlyOp(call: AdminOpCall) {
-  return createAdminOpHandler({ config, ...stores(), auth: adminAuth(), href })(call);
+  return createAdminOpHandler({ config, ...adminDeps() })(call);
 }

package/templates/blank/smoodly/server.ts

@@ -1,6 +1,8 @@
 // Server-only glue: the client, the stores, the site layer and the
 // renderer, constructed lazily so `next build` doesn't need env vars at
-// import time. The env shape is the package's (SMOODLY_*); whether the
+// import time. The env shape is the package's (SMOODLY_*): the live site
+// needs SMOODLY_URL and SMOODLY_SECRET_KEY, the admin also
+// SMOODLY_PUBLISHABLE_KEY (the `smoodlyEnv("admin")` calls below); whether the
 // secret is a service-role key or a cloud write key is invisible here.
 //
 // Lazy on purpose, the site and renderer included: config.ts imports the
@@ -14,7 +16,7 @@ import {
 // The admin gate from `smoodly/admin`, which holds no client code: the site
 // routes import this file, and `smoodly/admin/next` would put the admin
 // shell in every live page's JavaScript.
-import { supabaseAdminAuth, type AdminAuth, type AuthConfig } from "smoodly/admin";
+import { createSmoodlyContent, supabaseAdminAuth, type AdminAuth, type AuthConfig, type SmoodlyContent } from "smoodly/admin";
 import { createPageRenderer, createSmoodlyQueries, type PageRegistration } from "smoodly/next";
 import type { SupabaseClient } from "@supabase/supabase-js";
 import { collections, config, elements, sections, globals } from "./config";
@@ -50,8 +52,7 @@ function bound(): Bound {
   // The admission table, read by the Members page (spec 2026-09-25 §4).
   const members = new SupabaseMemberStore(db);
   const auth = supabaseAdminAuth({ authUrl: env.authUrl, authKey: env.authKey, db });
-  // Shadows the exported `stores` below on purpose: `createSmoodlySite`
-  // takes this local closure, not the export, so it never re-enters `bound()`.
+  // The site layer's own view of the stores; nothing outside this file reads them.
   const stores = () => ({ pages, entries, assets });
   // The site layer: (locale, path) → page or entry, and the content API
   // `q` wraps below. Not exported — the app reads through `q`, which adds
@@ -70,27 +71,37 @@ function bound(): Bound {
   return cached;
 }
 
-export function stores() {
+/** The admin's wiring, for `smoodly/ops.ts` only. Scripts write through `content()`. */
+export function adminDeps() {
+  smoodlyEnv("admin"); // the admin signs in with the publishable key: a missing one is named here, not on a live page
+  const { pages, entries, assets, members, auth } = bound();
+  return { pages, entries, assets, members, auth, href };
+}
+
+/** Write content from code — seeds, migrations, route handlers (spec 2026-09-30 tester findings §1).
+ *  The admin's own operations with no signed-in editor: validation and publish checks apply, a failure
+ *  throws `SmoodlyContentError`. `content().pages.create(…)`, `.entries.create(…)`, `.globals.set(…)`,
+ *  `.media.upload(…)`; build tree nodes with `node(Section, fields)`. */
+export function content(): SmoodlyContent {
   const { pages, entries, assets, members } = bound();
-  return { pages, entries, assets, members };
+  return createSmoodlyContent({ config, pages, entries, assets, members, href });
 }
 
+export { node } from "smoodly";
+
 /** The server-side client (seed script, one-off admin tasks). */
 export const client = () => bound().db;
 
-/** The admin gate: session verified against the auth project, editors row read with the write key. */
-export const adminAuth = () => bound().auth;
-
 /** What the browser needs to sign in — public values only. */
 export function publicAuth(): AuthConfig {
-  const env = smoodlyEnv();
+  const env = smoodlyEnv("admin");
   return { url: env.authUrl, key: env.authKey };
 }
 
 /** What the browser needs to join the editing-presence channel — public values only (spec 2026-09-26 concurrency §5).
  * The space is asked of the database once per process. */
 export function presence(): Promise<PresenceConfig> {
-  return presenceConfig(smoodlyEnv());
+  return presenceConfig(smoodlyEnv("admin"));
 }
 
 /** Locale-relative CMS path → site URL: the one seam for the renderer

package/templates/blank-intl/AGENTS.md

@@ -13,14 +13,16 @@ where things are.
   is the one registry. A component that is not registered does not exist
   for the admin.
 - **After a new collection or a `smoodly` upgrade, run `npx smoodly migrate`**
-  and apply what it writes (`supabase db push` hosted, `supabase db reset`
+  and apply what it writes (`supabase db push` hosted, `supabase migration up`
   local). It copies the core schema files the package ships and writes a
   read view and order index per collection. Never edit a file it wrote.
   The admin reads the base tables, so it lists a collection either way;
   the view is for SQL and PostgREST readers, the index for `order`.
-- **Seed through the stores.** `scripts/seed.ts` is starter content,
-  written through the page and entry stores, never raw SQL. It is
-  idempotent; run it with `npm run seed`.
+- **Content from code goes through `content()`.** `scripts/seed.ts` is
+  starter content written with `content()` from `smoodly/server.ts`:
+  the admin's own operations, so validation and publish checks apply and
+  a failure throws. Never write rows or call the stores directly. The
+  seed is idempotent; run it with `npm run seed`.
 - **Never import the admin into the site.** Nothing under `app/(site)`,
   `app/[locale]` or `components/`, and nothing they import
   (`smoodly/server.ts` included), may import `@/smoodly/admin` or
@@ -50,6 +52,6 @@ where things are.
 ## Commands
 
     npm run dev          # http://localhost:3000, /admin is the editor
-    npm run build        # next build
+    npm run build        # checks the schema files (smoodly migrate --check), then next build
     npm run seed         # starter content, idempotent
     npm run typecheck    # tsc --noEmit

package/templates/blank-intl/README.md

@@ -16,8 +16,8 @@ for an agent (or a person) building the site.
 - `components/sections/Text.tsx` — the one section: a title and a richtext body. Listed in `smoodly/sections.ts`.
 - `components/elements/Button.tsx` — the one element: a link styled as a button, embedded in richtext through `smoodly/toolsets.ts`.
 - `components/LocaleNav.tsx` — the language links every page view renders from its `locales` map: the same page in the other language, or its home when there is no translation; nothing with one locale.
-- `smoodly/` — the wiring: `config.ts` (the registry and settings), `collections.ts` (posts), `globals.ts` (the site item), `sections.ts`, `elements.ts`, `toolsets.ts`, `server.ts` (stores, site layer, renderer, the read API `q`), `ops.ts` (the admin's one server action), `admin.tsx` (the admin mount), `richtext.tsx` (the bound renderer).
-- `scripts/seed.ts` — the home page and the site item, written through the stores. `npm run seed` is idempotent.
+- `smoodly/` — the wiring: `config.ts` (the registry and settings), `collections.ts` (posts), `globals.ts` (the site item), `sections.ts`, `elements.ts`, `toolsets.ts`, `server.ts` (site layer, renderer, the read API `q`, the content API `content()`), `ops.ts` (the admin's one server action), `admin.tsx` (the admin mount), `richtext.tsx` (the bound renderer).
+- `scripts/seed.ts` — the home page and the site item, written through the content API (`content()`). `npm run seed` is idempotent.
 - `app/globals.css` — a reset, a container, the two tones. Replace it.
 - `.env.local` — `SMOODLY_URL`, `SMOODLY_SECRET_KEY`, `SMOODLY_PUBLISHABLE_KEY`.
 
@@ -44,7 +44,7 @@ collection to `collections`, and write its entry page by copying
 Then write its read view and order index and apply them:
 
     npx smoodly migrate
-    supabase db push        # hosted; `supabase db reset` for the local stack
+    supabase db push        # hosted; `supabase migration up` for the local stack (keeps the content)
 
 The same command brings the core schema forward after a `smoodly` upgrade.
 

package/templates/blank-intl/_gitignore

@@ -3,3 +3,4 @@ node_modules/
 .env.local
 next-env.d.ts
 *.tsbuildinfo
+smoodly-export-*