create-smoodly-app 0.0.36 → 0.0.38

package/README.md

@@ -4,7 +4,7 @@
 
 A fresh Next.js app with the Smoodly admin mounted at `/admin`, a Supabase
 project holding the schema, `.env.local` written, and a first editor who can
-sign in. Spec: `docs/superpowers/specs/2026-09-04-create-smoodly-app-design.md`.
+sign in.
 
 ## What it asks
 
@@ -41,202 +41,3 @@ Every prompt has a flag, so CI can run it: `--supabase local|hosted`, `--locales
 `SMOODLY_EDITOR_PASSWORD`), `--skip-link`, `--yes`. `--help` lists them.
 A hidden `--smoodly-dep <spec>` overrides the `smoodly` dependency written into
 `package.json`; CI points it at the packed tarball.
-
-## How it is built
-
-`templates/lorem`, `templates/lorem-intl`, `templates/blank` and
-`templates/blank-intl` are all generated by `scripts/build-template.ts`.
-The Lorem Co. pair comes from `examples/site` — the multilingual layout —
-plus the five single-language files under `variants/lorem/single/`. The
-blank pair (spec 2026-09-11) takes only the content-free glue from the
-example (`smoodly/server.ts`, `ops.ts`, `admin.tsx`, `richtext.tsx`, the
-admin route files, next-intl's files) and everything with content from
-`variants/blank/{common,single,intl}/`. Each template also gets a generated
-`package.json` (with `smoodly` pinned to this package's version),
-`tsconfig`, `next.config`, README, `AGENTS.md`, a `CLAUDE.md` that imports
-it, and the one migration (`coreTablesSQL` + the starter's collection
-views). Two exact-line transforms turn the example's glue (locale config,
-`href`) into the single-language one; a drifted example fails the build
-rather than silently shipping stale copies. Every template gets a check
-tsconfig beside it; `npm run typecheck` runs `tsc` over all four
-(`typecheck:templates`), so hand-kept files cannot drift silently. All
-four templates are git-ignored and rebuilt by `npm run build`.
-
-`src/plan.ts` turns answers into steps; `src/run.ts` executes them with
-injected `exec`, fs and Supabase client so the sequence and every fallback
-message are unit-tested. `src/prompts.ts` is the only interactive code.
-The CLI has no runtime dependency on `smoodly`.
-
-    npm test          # unit tests (template build, planner, runner, editor)
-    npm run typecheck # tsc, then the four templates
-    npm run build     # templates + esbuild bundle → dist/index.js
-
-Walked 2026-09-06: both templates scaffolded against the repo's local stack
-in hosted mode, `tsc`, `next build` and `/admin` 200 for each; the
-multilingual one with `--locales en,de`.
-
-Walked 2026-09-11: blank multilingual scaffolded in local mode with
-`--locales en,fr` from the built CLI, `next build`, `/` and `/fr` seeded
-with the Text section and the site footer line, the admin listing Home,
-Posts and the Site item, a post with a Button element published and
-served at `/posts/<slug>` in both locales; blank single-language
-scaffolded in hosted mode against the repo stack and `next build` only.
-
-## Follow-ups (logged 2026-09-28, fresh-install proof of 0.0.30)
-
-Walked 2026-09-28: `npx create-smoodly-app@0.0.30 proof-0030 --supabase
-local --yes --editor-email …` from the published package, in a scratch
-directory beside three running stacks (the new one took the `563xx`
-block). `smoodly` 0.0.30 installed, `tsc` and `next build` clean, `/`,
-`/posts`, `/posts/<slug>`, `/company/about-us` and `/admin` 200, the
-admin document's `<html lang="en">` present, the editor signed in, an
-SEO title edit saved and published and served on `/`. Found:
-
-- **Local mode left Realtime out (0.0.26–0.0.30).** `LOCAL_START_ARGS`
-  excluded `realtime` from before the concurrency spec, whose presence
-  channel and `saved` events ride it; the admin retried the WebSocket
-  forever (a console error per attempt) and a local install had no
-  presence or stale-page notice. CI's repo stack already kept Realtime.
-  Fixed 2026-09-28: the list no longer excludes it; restarted with the new
-  flags, a script signed in as the editor joined `space:<id>` and saw both
-  open admin tabs tracked on Home. The live job does not catch this
-  (it requests `/admin` once, no browser); an existing local install
-  restarts with `supabase stop && supabase start -x imgproxy,edge-runtime,logflare,vector,supavisor`.
-- **The Lorem home's custom-section CTA linked `/articles`**, a 404 —
-  the articles collection lives at `/posts`. `examples/site/scripts/seed.ts`
-  hardcoded the href; fixed 2026-09-28 to `paths(locale).articles` like
-  every other starter link (Finnish gets its own segment too).
-- **`--editor-email` without `SMOODLY_EDITOR_PASSWORD` fails late.** The
-  check lives in `askEditorWith`, which runs after the copy, install,
-  `git init` and `supabase start`, so the run stops at `ensureEditor`
-  with a half-made app. It has to be late for hosted mode (the email may
-  name an existing Auth user, no password needed), but a local stack is
-  always fresh, so local mode could refuse up front. Fixed 2026-09-28:
-  `resolveAnswers` refuses local `--editor-email` without the variable
-  before anything is written (the built CLI exits 1, no directory made);
-  hosted keeps the late check.
-
-## Follow-ups (logged 2026-09-25, docs walk)
-
-- **Single-language `/admin` had no root `<html>` (0.0.15–0.0.20).** The
-  variant's `app/(smoodly)/admin/layout.tsx` re-exported `AdminLayout`,
-  which renders a `<div>`; that only worked while the site had a
-  top-level `app/layout.tsx`, and 0.0.15 moved the site into `app/(site)`.
-  `next dev` showed two errors on the first visit to `/admin`: "Missing
-  <html> tags in the root layout" and, from the client-rendered tree, the
-  theme boot's "Encountered a script tag while rendering React component".
-  Found walking the Getting started guide on a fresh `lorem` install of
-  0.0.20. Fixed 2026-09-25: the variant layout wraps `AdminLayout` in
-  `<html><body>` like the example's; both errors gone in the walk. CI's
-  live job only checks `/admin` for a 200, which this passed; an assertion
-  on the dev overlay (or on `<html>` in the served document) would have
-  caught it.
-
-## Follow-ups (logged 2026-09-11)
-
-- **Blank single-language is typechecked, never built by CI.** The live
-  job scaffolds lorem single (hosted), lorem intl and blank intl (local).
-  A fourth stack costs ~2 minutes; add it if blank single ever breaks in
-  a way `tsc` cannot see (a runtime import, a missing file at a path
-  Next reads).
-- **The guide inside the package.** `AGENTS.md` is generated per scaffold
-  and frozen at install time. Once its text settles, ship it in the
-  `smoodly` package (`smoodly/AGENTS.md`) and have the scaffold's copy
-  point there, so it tracks the package version.
-
-## Follow-ups (logged 2026-09-06)
-
-- Local mode on a fresh multilingual install (0.0.5, 2026-09-06) failed at
-  `supabase start` with `supabase_storage_<app> container is not ready:
-  unhealthy` — the storage container logged `Started Successfully` and the
-  CLI still stopped the stack. Five local stacks (57 containers) were
-  sharing 7.8 GB of Docker memory at the time, the same pressure that
-  made the repo's live suites flake on 2026-09-05. Smoodly never uses
-  storage, so the CLI could start the app's stack with
-  `supabase start -x storage-api,imgproxy,edge-runtime,logflare,vector,realtime`
-  (the container names `supabase start --help` lists; CI already excludes
-  most of these for the repo stack), and the "Finish by hand" text could
-  mention `supabase stop` on other projects. Retried the same day with
-  the other four stacks stopped (`supabase stop --project-id <name>`):
-  `npx create-smoodly-app@0.0.5 --supabase local --locales en,fi --yes`
-  came up with every container healthy, storage included, and the app
-  built and served `/admin` 200, `/` and `/fi` 404 — so the cause is
-  memory pressure, not the CLI. Fixed the same day: `run.ts` starts the
-  app's stack with `-x storage-api,imgproxy,edge-runtime,logflare,vector,realtime,supavisor`
-  (`LOCAL_START_ARGS`), and the "Finish by hand" text carries the same
-  flags. Kept: db, kong, auth, PostgREST, Studio and pg-meta, mailpit.
-  Storage is back in the local stack since the media library
-  (2026-09-08); the health-check flake is a Docker memory problem, see
-  the repo's memory note.
-- **A non-interactive run without `--locales` needs `--yes`.** The
-  "Multilingual site?" prompt is asked whenever `--locales` is absent, and
-  with no TTY (a CI step, stdin at EOF) the CLI exits 13 having created
-  nothing — "Detected unsettled top-level await". CI's hosted-mode e2e step
-  hit this; both e2e steps now pass a flag that settles the question
-  (`--yes` for single-language, `--locales en,de` for the multilingual one).
-  A prompt that treated EOF as its default value would need no flag.
-- **The next-intl template inherits next-intl's `localeDetection`
-  default**, which redirects an unprefixed URL to the visitor's preferred
-  locale *keeping the source locale's slugs* — on a site with translated
-  slugs that redirect lands on a 404 (`/company/about-us` →
-  `/fi/company/about-us` for a Finnish browser). Recorded in
-  `examples/site/README.md` under "Multilingual (2026-09-06)". Fixed the
-  same day: `i18n/routing.ts` in the example — and so in the generated
-  `templates/next-intl` — sets `localeDetection: false`, so the English
-  URL stays English for a Finnish browser and the visitor picks a
-  language through the site's own switcher.
-
-## Follow-ups (logged 2026-09-05)
-
-- Text prompts drop `@` when the terminal sends Option as Meta (macOS,
-  Finnish/Nordic layouts put `@` on Option+2): the terminal emits `ESC 2` and
-  Node's readline discards meta-keys, so nothing reaches the prompt.
-  Reproduced against `@clack/prompts` 1.7.0 with a scripted stdin. Not
-  fixable from prompt options; documented under "What it asks" with the
-  paste / `--editor-email` workaround. Revisit if clack exposes a key hook.
-- Fresh installs printed a `NOTICE ... does not exist, skipping` for every
-  `drop trigger/policy if exists` in the migration (fixed 2026-09-05: the
-  migration opens with `set client_min_messages = warning`).
-
-## Follow-ups (logged 2026-09-04)
-
-- The port probe binds `0.0.0.0` (a loopback-only bind coexists with a Docker-published port on macOS), so macOS may prompt once to allow `node` incoming connections during local mode; either answer is fine.
-- Windows: `exec` passes `shell: true` on win32 (needed for the `.cmd` shims)
-  but does not quote arguments, so a project name or path containing a space
-  or `&` breaks. Quote the args when the shell is on, or resolve the `.cmd`
-  path and drop `shell`. Untested on Windows.
-- Hosted mode, manual run against a real hosted project with new-format keys
-  (done 2026-09-05, throwaway project, `sb_secret_` + `sb_publishable_`):
-  `db push` of the template migration printed no NOTICE, the CLI listed and
-  created the first editor through the GoTrue admin API with the secret key
-  as the sole `apikey`, the `members` row landed with role `admin`, `next
-  build` passed, `/admin` served the shell, and a password sign-in with the
-  publishable key returned a session. Caveat: the link step ran by hand with
-  an explicit `--project-ref` (see the next-but-one item); the CLI's own
-  `supabase link` was not driven interactively.
-- Supabase CLI 2.78.1 prints `sb_secret_` keys masked (middle dots) from
-  `supabase projects api-keys`; 2.116.0 needs `--reveal`. A user who copies
-  the key from the CLI rather than the dashboard gets "Invalid API key" at
-  the editor step. Worth a hint in the "Finish by hand" text.
-- `listUsers` reads one page of 200 Auth users when offering an existing user
-  to make the first editor. Fine for a fresh project, wrong for a populated one.
-- `supabase link` ran without `--project-ref`, so the CLI opened the
-  project picker, which preselects the account's first project; `db push`
-  follows the link, so one Enter would push Smoodly's schema into whichever
-  project sorts first (seen 2026-09-05 during the hosted run, caught before
-  the push). Fixed 2026-09-05: `projectRef` (src/env.ts) takes the ref from
-  the typed URL's first host label and the link step and every fallback
-  line pass it. Seen again 2026-09-05 from the published 0.0.3: a URL typed
-  without `https://` gave no ref (the picker opened) and then failed
-  `ensureEditor` with supabase-js's "Invalid supabaseUrl". Fixed the same
-  day: `normalizeProjectUrl` (src/env.ts) adds the scheme and refuses
-  non-URLs at the prompt and for `--url`; a URL with no ref (custom domain)
-  never offers the link, and `run` throws rather than run a bare
-  `supabase link`.
-- The `--yes` flag defaults to local mode; with the Supabase CLI absent that
-  stops with the install message rather than falling through to hosted.
-- Captured `exec` output is stdout only; stderr streams straight through, so
-  `git init` hints and the Supabase CLI's update notice appear between the
-  prompt lines.
-- The "Local" option is still offered in the select when the Supabase CLI is
-  absent, and only bails afterwards; the spec wants the check before the prompt.

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.36",
+  "version": "0.0.38",
   "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.36"
+    "smoodly": "0.0.38"
   },
   "devDependencies": {
     "@next/env": "^16.3.4",