create-smoodly-app 0.0.14 → 0.0.15

package/README.md

@@ -43,15 +43,23 @@ A hidden `--smoodly-dep <spec>` overrides the `smoodly` dependency written into
 
 ## How it is built
 
-`templates/next/` and `templates/next-intl/` are both generated by
-`scripts/build-template.ts` from `examples/site` — the multilingual layout —
-plus a generated `package.json` (with `smoodly` pinned to this package's
-version), `tsconfig`, `next.config`, README and the one migration
-(`coreTablesSQL` + the starter collections' views). The four single-language
-route files live in `variants/single/`, and 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.
-Both templates are git-ignored and rebuilt by `npm run build`.
+`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
@@ -59,12 +67,32 @@ 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 build     # template + esbuild bundle → dist/index.js
+    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-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

package/dist/index.js

@@ -29,6 +29,7 @@ function parseFlags(argv) {
       "editor-email": { type: "string" },
       "smoodly-dep": { type: "string" },
       locales: { type: "string" },
+      starter: { type: "string" },
       "skip-link": { type: "boolean", default: false },
       yes: { type: "boolean", short: "y", default: false },
       help: { type: "boolean", short: "h", default: false }
@@ -39,6 +40,10 @@ function parseFlags(argv) {
   if (supabase !== void 0 && supabase !== "local" && supabase !== "hosted") {
     throw new Error(`--supabase must be "local" or "hosted", got "${supabase}"`);
   }
+  const starter = values.starter;
+  if (starter !== void 0 && starter !== "lorem" && starter !== "blank") {
+    throw new Error(`--starter must be "lorem" or "blank", got "${starter}"`);
+  }
   return {
     name: positionals[0],
     supabase,
@@ -50,7 +55,8 @@ function parseFlags(argv) {
     yes: values.yes ?? false,
     help: values.help ?? false,
     smoodlyDep: values["smoodly-dep"],
-    locales: values.locales === void 0 ? void 0 : parseLocales(values.locales)
+    locales: values.locales === void 0 ? void 0 : parseLocales(values.locales),
+    starter
   };
 }
 var HELP = `create-smoodly-app \u2014 a fresh Next.js site with Smoodly installed
@@ -60,6 +66,7 @@ Usage: npx create-smoodly-app [name] [options]
 Options:
   --supabase local|hosted   Where content lives (asked when omitted; local needs the Supabase CLI)
   --locales <a,b,\u2026>         Multilingual: the locales, first is the default (scaffolds next-intl; omitted = one language)
+  --starter lorem|blank     lorem: the Lorem Co. tour of every feature (default); blank: one of each, for building your own
   --url <url>               Hosted: the Supabase project URL
   --publishable-key <key>   Hosted: the anon / publishable key
   --secret-key <key>        Hosted: the service-role / secret key
@@ -227,13 +234,15 @@ 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 map = articlesSegments(opts.locales);
-    for (const [rel, line] of [["smoodly/collections.ts", ARTICLES_PATH_LINE], ["components/pages/Articles.tsx", ARTICLES_SLUG_LINE]]) {
-      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
+    if (opts.starter !== "blank") {
+      const map = articlesSegments(opts.locales);
+      for (const [rel, line] of [["smoodly/collections.ts", ARTICLES_PATH_LINE], ["components/pages/Articles.tsx", ARTICLES_SLUG_LINE]]) {
+        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
 ${line}`);
-      await writeFile(path, source.replace(line, line.replace('{ en: "posts", fi: "artikkelit" }', map)));
+        await writeFile(path, source.replace(line, line.replace('{ en: "posts", fi: "artikkelit" }', map)));
+      }
     }
   }
 }
@@ -262,7 +271,7 @@ async function resolveAnswers(flags2, ctx) {
   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({
       message: "Locales, comma-separated, the first is the default",
-      placeholder: "en, fi",
+      placeholder: "en, fr",
       validate: (v) => {
         try {
           parseLocales(v ?? "");
@@ -272,6 +281,15 @@ async function resolveAnswers(flags2, ctx) {
       }
     })
   ).then(parseLocales) : void 0);
+  const starter = flags2.starter ?? (flags2.yes ? "lorem" : await answer(
+    p.select({
+      message: "Starter?",
+      options: [
+        { value: "lorem", label: "Lorem Co.", hint: "a tour of every feature \u2014 edit it into your site" },
+        { value: "blank", label: "Blank", hint: "one of each \u2014 build your own" }
+      ]
+    })
+  ));
   const supabase = flags2.supabase ?? (flags2.yes ? "local" : await answer(
     p.select({
       message: "Where should content live?",
@@ -283,7 +301,7 @@ async function resolveAnswers(flags2, ctx) {
   ));
   if (supabase === "local") {
     if (!ctx.hasSupabaseCli) bail("Local mode needs the Supabase CLI: https://supabase.com/docs/guides/cli (brew install supabase/tap/supabase)");
-    return { name, dir, supabase, hasSupabaseCli: true, smoodlyDep: flags2.smoodlyDep, locales };
+    return { name, dir, supabase, hasSupabaseCli: true, smoodlyDep: flags2.smoodlyDep, locales, starter };
   }
   const badUrl = "Supabase project URL must be an http(s) URL, like https://abcd.supabase.co";
   const typedUrl = flags2.url ?? await answer(
@@ -302,7 +320,7 @@ async function resolveAnswers(flags2, ctx) {
     p.log.warn(`No project ref in ${url}; skipping supabase link. Run \`supabase link --project-ref <project-ref>\` and \`supabase db push\` yourself.`);
   }
   const linkAndPush = !ctx.hasSupabaseCli ? false : flags2.skipLink || !ref ? false : flags2.yes ? true : await answer(p.confirm({ message: `Link this app to the project and push the migration now? (supabase link --project-ref ${ref}, supabase db push)` }));
-  return { name, dir, supabase, hasSupabaseCli: ctx.hasSupabaseCli, hosted: { keys: { url, publishableKey, secretKey }, linkAndPush }, smoodlyDep: flags2.smoodlyDep, locales };
+  return { name, dir, supabase, hasSupabaseCli: ctx.hasSupabaseCli, hosted: { keys: { url, publishableKey, secretKey }, linkAndPush }, smoodlyDep: flags2.smoodlyDep, locales, starter };
 }
 function askEditorWith(flags2, env = process.env) {
   return async (existing) => {
@@ -335,6 +353,9 @@ function askEditorWith(flags2, env = process.env) {
 import { join as join2 } from "node:path";
 
 // src/plan.ts
+function templateName(starter, locales) {
+  return locales === "intl" ? `${starter}-intl` : starter;
+}
 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)");
@@ -409,11 +430,12 @@ async function run(answers2, deps) {
       switch (step) {
         case "copyTemplate":
           await deps.fs.scaffold({
-            templateDir: answers2.locales ? deps.templateDirs.intl : deps.templateDirs.single,
+            templateDir: deps.templateDirs[templateName(answers2.starter ?? "lorem", answers2.locales ? "intl" : "single")],
             dir: cwd,
             name: answers2.name,
             smoodlyDep: answers2.smoodlyDep,
-            locales: answers2.locales
+            locales: answers2.locales,
+            starter: answers2.starter
           });
           break;
         case "install":
@@ -519,8 +541,10 @@ function linkCommand(answers2) {
 
 // src/index.ts
 var TEMPLATE_DIRS = {
-  single: fileURLToPath(new URL("../templates/next/", import.meta.url)),
-  intl: fileURLToPath(new URL("../templates/next-intl/", import.meta.url))
+  lorem: fileURLToPath(new URL("../templates/lorem/", import.meta.url)),
+  "lorem-intl": fileURLToPath(new URL("../templates/lorem-intl/", import.meta.url)),
+  blank: fileURLToPath(new URL("../templates/blank/", import.meta.url)),
+  "blank-intl": fileURLToPath(new URL("../templates/blank-intl/", import.meta.url))
 };
 var flags;
 try {
@@ -569,7 +593,7 @@ p2.note(
     `cd ${answers.name}`,
     "npm run dev",
     "",
-    "Site:  http://localhost:3000  (the Lorem Co. starter \u2014 edit it at /admin)",
+    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)",
     "Admin: http://localhost:3000/admin",
     `Editor: ${outcome.editor.email ?? outcome.editor.id}`,
     ...answers.locales ? [`Locales: ${answers.locales.join(", ")} (i18n/routing.ts)`] : []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-smoodly-app",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "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": {
@@ -25,7 +25,8 @@
     "build:cli": "esbuild src/index.ts --bundle --packages=external --platform=node --format=esm --target=node20 --outfile=dist/index.js --banner:js='#!/usr/bin/env node'",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit && npm run typecheck:templates",
+    "typecheck:templates": "npm run build:template && tsc -p templates/lorem.tsconfig.json && tsc -p templates/lorem-intl.tsconfig.json && tsc -p templates/blank.tsconfig.json && tsc -p templates/blank-intl.tsconfig.json"
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",

package/templates/blank/AGENTS.md

@@ -0,0 +1,50 @@
+# Working in this Smoodly site
+
+This is a Next.js app with Smoodly installed: content lives in Supabase,
+the admin is mounted at /admin from the `smoodly` package, and the site
+reads content through `smoodly/server.ts`. Read README.md first: it says
+where things are.
+
+## Rules
+
+- **Register everything in `smoodly/`.** Every section, element,
+  collection and shared item is listed in its barrel (`sections.ts`,
+  `elements.ts`, `collections.ts`, `shared.ts`) and `smoodly/config.ts`
+  is the one registry. A component that is not registered does not exist
+  for the admin.
+- **A new collection is a new migration.** Write its view with
+  `collectionSQL` from `smoodly` into a new file under
+  `supabase/migrations/`, then apply it: `supabase db push` (hosted) or
+  `supabase db reset` (local). The admin cannot list a collection whose
+  view is missing.
+- **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`.
+- **Never import the admin into the site.** Nothing under `app/(site)`,
+  `app/[locale]` or `components/` may import `@/smoodly/admin` or
+  `smoodly/admin/next`; the admin's chunk must not reach visitors.
+- **Two root layouts.** The site's layout lives in its route group or
+  locale segment and is never the admin's parent; `app/(smoodly)/admin`
+  is a second root layout. Do not add an `app/layout.tsx`.
+- **Toolsets and elements.** A richtext field names a toolset
+  (`smoodly/toolsets.ts`); a toolset embeds elements by value; the config
+  must register those elements too. Files the toolset imports use
+  relative paths, not `@/`.
+- **Section styles are data attributes.** `<smoodly.Section>` renders the
+  root element and emits the config's section styles as `data-*`
+  attributes; `app/globals.css` styles them. Marks
+  (`smoodly.marks(schema)`) tie rendered elements to fields so the
+  editor can select and edit them in place.
+- **Multilingual sites.** Content locales are Smoodly's; URL locales are
+  next-intl's. The locale set is `i18n/routing.ts`. UI strings of the
+  site's own go through next-intl's messages in `messages/<locale>.json`.
+- **Fixed versus open pages.** A page shape with a `slug` is fixed: one
+  record, created for you, never deleted. Without one it is open: editors
+  create as many as they like.
+
+## Commands
+
+    npm run dev          # http://localhost:3000, /admin is the editor
+    npm run build        # next build
+    npm run seed         # starter content, idempotent
+    npm run typecheck    # tsc --noEmit

package/templates/blank/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/templates/blank/README.md

@@ -0,0 +1,75 @@
+# Smoodly site
+
+Created by `create-smoodly-app`. Content lives in Supabase; the admin is
+mounted at `/admin` from the `smoodly` package. AGENTS.md holds the rules
+for an agent (or a person) building the site.
+
+    npm run dev          # http://localhost:3000 — /admin is the editor
+
+## 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)/layout.tsx` — the site's root layout: `app/globals.css`, the footer line from the `site` item; the admin has its own under `app/(smoodly)/admin/`.
+- `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.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`.
+- `smoodly/` — the wiring: `config.ts` (the registry and settings), `collections.ts` (posts), `shared.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.
+- `app/globals.css` — a reset, a container, the two tones. Replace it.
+- `.env.local` — `SMOODLY_URL`, `SMOODLY_SECRET_KEY`, `SMOODLY_PUBLISHABLE_KEY`.
+
+## Add a section
+
+Copy `components/sections/Text.tsx`, give the schema a new `name` and
+`title`, declare its fields, render them inside `<smoodly.Section>` with
+marks on each field. Add it to `sections` in `smoodly/sections.ts`, then
+to the `sections` list of every zone that may hold it in
+`components/pages/*.tsx`. It appears in the editor's "+" picker.
+
+## Add an element
+
+Copy `components/elements/Button.tsx` (relative imports only). Add it to
+`elements` in `smoodly/elements.ts` and to the `elements` of the toolset
+in `smoodly/toolsets.ts` that may embed it. It appears in the richtext
+editor's "/" menu.
+
+## Add a collection
+
+Copy the `posts` block in `smoodly/collections.ts`, add the new
+collection to `collections`, and write its entry page by copying
+`components/pages/Post.tsx` (register it in `config.ts` under `pages`).
+Then create a migration with its view:
+
+    import { collectionSQL } from "smoodly";
+    import { people } from "./smoodly/collections";
+    console.log(collectionSQL(people));
+
+Save the output as `supabase/migrations/<timestamp>_people.sql` and apply
+it with `supabase db push` (hosted) or `supabase db reset` (local).
+
+## Add a shared item
+
+Copy the `site` block in `smoodly/shared.ts` and add it to `shared`. An
+object item (`fields`) is read in code with `q().getShared("name")`; a
+visual item (`section: SomeSection`) renders through its section and can
+be placed on pages from the picker's Shared group. Edit both under
+Globals in the admin.
+
+Reseed an empty database any time with `npm run seed`.
+
+## Editors
+
+Anyone who may open `/admin` is a Supabase Auth user with a row in the
+`editors` table. To add one: create the user in Supabase Studio
+(Authentication → Users), then in the SQL editor:
+
+    insert into editors (user_id, role) values ('<the user id>', 'editor');
+
+## Hosted Supabase
+
+    supabase init        # if the CLI has not been set up here yet
+    supabase link        # pick the project
+    supabase db push     # applies supabase/migrations/
+
+Then put the project's URL and keys in `.env.local`.

package/templates/{next/app → blank/app/(site)}/[...path]/page.tsx

@@ -4,8 +4,8 @@ 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/<segment>/page.tsx beside this file and it
-// wins for that exact path; deeper paths still resolve here.
+// 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);
 }

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

@@ -0,0 +1,25 @@
+import type { ReactNode } from "react";
+import { q } from "@/smoodly/server";
+import "../globals.css";
+
+// The site's root layout, in its own route group so the admin's layout
+// under app/(smoodly)/admin is a second root layout beside it rather than
+// a child of this one. The `site` shared item (smoodly/shared.ts) gives
+// the document title and the footer line: read through `q`, cached under
+// its tag, null until published.
+export async function generateMetadata() {
+  const site = await q().getShared("site");
+  return { title: site?.name ?? "Smoodly site" };
+}
+
+export default async function RootLayout({ children }: { children: ReactNode }) {
+  const site = await q().getShared("site");
+  return (
+    <html lang="en">
+      <body>
+        <main>{children}</main>
+        {site && <footer className="container site-footer">{site.name} · {site.tagline}</footer>}
+      </body>
+    </html>
+  );
+}

package/templates/blank/app/globals.css

@@ -0,0 +1,47 @@
+/* The blank starter's one stylesheet: a reset, a system font, a
+   container, prose defaults, the button element, and the two tones the
+   config's section style emits as data-tone. Replace freely. */
+
+:root {
+  --paper: #ffffff;
+  --ink: #1a1a1a;
+  --muted: #666666;
+  --container: 720px;
+}
+
+* { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; }
+body {
+  background: var(--paper);
+  color: var(--ink);
+  font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  line-height: 1.5;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+}
+main { flex: 1; }
+a { color: inherit; }
+
+.container { width: min(var(--container), 100% - 2rem); margin-inline: auto; }
+
+/* Sections carry data-tone from the config's section styles. */
+[data-tone="paper"] { background: var(--paper); color: var(--ink); }
+[data-tone="ink"] { background: var(--ink); color: var(--paper); }
+section[data-tone] { padding-block: 3rem; }
+
+.prose > * + * { margin-top: 1em; }
+.prose h1, .prose h2, .prose h3 { line-height: 1.2; }
+
+/* The Button element, inside richtext. */
+.button {
+  display: inline-block;
+  padding: 0.6em 1.2em;
+  border: 1px solid currentColor;
+  border-radius: 4px;
+  text-decoration: none;
+}
+
+.site-footer { padding-block: 2rem; color: var(--muted); font-size: 0.875rem; }
+.locales { display: flex; gap: 0.75rem; padding-block: 1rem; font-size: 0.875rem; }
+.locales a[aria-current="page"] { font-weight: 600; }

package/templates/blank/components/elements/Button.tsx

@@ -0,0 +1,26 @@
+import { f, smoodly, type Props } from "smoodly";
+
+// An Element: a small registered block editors insert inside richtext
+// (the `richtext` context). This one is a link styled as a button. Copy
+// this file to add another element, then list it in smoodly/elements.ts
+// and in the toolsets that may embed it (smoodly/toolsets.ts).
+// Relative imports only in this file and in smoodly/toolsets.ts: the
+// template build imports them outside the app, where `@/` has no mapping.
+export const buttonSchema = smoodly.schema.element({
+  name: "button",
+  title: "Button",
+  icon: "→",
+  description: "A link styled as a button.",
+  contexts: ["richtext"],
+  fields: {
+    label: f.text().max(60),
+    href: f.link(),
+  },
+  sample: { label: "Read more", href: "/" },
+});
+
+function ButtonView({ label, href }: Props<typeof buttonSchema>) {
+  return <a className="button" href={href}>{label}</a>;
+}
+
+export const Button = smoodly.element(buttonSchema, ButtonView);

package/templates/blank/components/pages/Home.tsx

@@ -0,0 +1,22 @@
+import { smoodly, z, Zone, type Props } from "smoodly";
+import { Text } from "../sections/Text";
+
+// A page shape: zones declared, <Zone /> placed, one file. `slug` makes
+// it fixed — one record editors can neither delete nor duplicate — and
+// the config's homePageSlug maps that record to "/". The body is a
+// freeform zone over the sections listed here.
+export const homeSchema = smoodly.schema.page({
+  name: "home",
+  title: "Home",
+  slug: "home",
+  zones: {
+    body: z.freeform({ sections: [Text] }),
+  },
+  meta: { seo: true },
+});
+
+function HomeView({ zones }: Props<typeof homeSchema>) {
+  return <Zone of={zones.body} />;
+}
+
+export const HomePage = smoodly.page(homeSchema, HomeView);

package/templates/blank/components/pages/Page.tsx

@@ -0,0 +1,25 @@
+import { smoodly, z, Zone, type Props } from "smoodly";
+import { Text } from "../sections/Text";
+
+// An open page shape: no `slug`, so editors create as many as they like,
+// anywhere in the tree the config allows. `page` is where this one sits
+// (title, path, ancestors, children).
+export const pageSchema = smoodly.schema.page({
+  name: "page",
+  title: "Page",
+  zones: {
+    body: z.freeform({ sections: [Text] }),
+  },
+  meta: { seo: true },
+});
+
+function PageView({ zones, page }: Props<typeof pageSchema>) {
+  return (
+    <>
+      <h1 className="container">{page.title}</h1>
+      <Zone of={zones.body} />
+    </>
+  );
+}
+
+export const StandardPage = smoodly.page(pageSchema, PageView);

package/templates/blank/components/pages/Post.tsx

@@ -0,0 +1,21 @@
+import { smoodly, type EntryPageProps } from "smoodly";
+import { RichText } from "@/smoodly/richtext";
+import { posts } from "@/smoodly/collections";
+
+// The entry page for `posts`, served at /posts/<slug>. It receives the
+// entry's fields; the body is richtext rendered by the site's bound
+// RichText, which knows the registered elements.
+type PostFields = { title: string; date?: string; body?: unknown };
+
+function PostView({ entry }: EntryPageProps) {
+  const post = entry.fields as PostFields;
+  return (
+    <article className="container prose">
+      <h1>{post.title}</h1>
+      {post.date && <p><time dateTime={post.date}>{post.date.slice(0, 10)}</time></p>}
+      <RichText doc={post.body} />
+    </article>
+  );
+}
+
+export const PostPage = smoodly.entryPage(posts, PostView);

package/templates/blank/components/sections/Text.tsx

@@ -0,0 +1,39 @@
+import { f, smoodly, type Props } from "smoodly";
+import { RichText } from "@/smoodly/richtext";
+import { text } from "@/smoodly/toolsets";
+
+// A section: a title and a richtext body. Registered in
+// smoodly/sections.ts and allowed in the page shapes' zones
+// (components/pages/*.tsx). Copy this file to add another section.
+// The section wrapper renders the root element and emits the config's
+// section styles as data attributes (data-tone here) for app/globals.css.
+export const textSchema = smoodly.schema.section({
+  name: "text",
+  title: "Text",
+  description: "A title and a body of text.",
+  fields: {
+    title: f.text(),
+    body: f.richtext({ toolset: text }),
+  },
+  sample: {
+    title: "Hello",
+    body: { type: "doc", content: [{ type: "paragraph", content: [{ type: "text", text: "Write something here." }] }] },
+  },
+});
+
+// Marks tie the rendered elements to their fields, so the editor can
+// select and inline-edit them on the canvas.
+const m = smoodly.marks(textSchema);
+
+function TextView({ title, body, styles }: Props<typeof textSchema>) {
+  return (
+    <smoodly.Section styles={styles}>
+      <div className="container prose">
+        <h2 {...m.field("title")}>{title}</h2>
+        <div {...m.field("body")}><RichText doc={body} /></div>
+      </div>
+    </smoodly.Section>
+  );
+}
+
+export const Text = smoodly.section(textSchema, TextView);

package/templates/{next → blank}/package.json

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