create-smoodly-app 0.0.45 → 0.0.47

package/templates/{blank-intl/supabase/migrations/20260930041056_smoodly_views.sql → astro-blank-intl/supabase/migrations/20261008120100_smoodly_views.sql}

@@ -1,5 +1,5 @@
 -- Smoodly: read views for this app's collections, written by `npx smoodly migrate`
--- (2026-09-30T04:10:56.000Z). One block per collection; the marker's hash is the block's SQL, compared on the next run.
+-- (2026-10-08T12:01:00.000Z). One block per collection; the marker's hash is the block's SQL, compared on the next run.
 -- Never edit a written file: change the collection and run migrate again.
 
 -- smoodly:collection posts sha256:38ba2918f83ab367

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

@@ -0,0 +1,17 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "compilerOptions": {
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ]
+    }
+  },
+  "include": [
+    ".astro/types.d.ts",
+    "**/*"
+  ],
+  "exclude": [
+    "dist"
+  ]
+}

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

@@ -0,0 +1,24 @@
+{
+  "extends": "./astro-blank-intl/tsconfig.json",
+  "compilerOptions": {
+    "incremental": false,
+    "allowImportingTsExtensions": true,
+    "paths": {
+      "@/*": [
+        "./astro-blank-intl/src/*"
+      ],
+      "smoodly": [
+        "../../smoodly/src/index.ts"
+      ],
+      "smoodly/*": [
+        "../../smoodly/src/*"
+      ]
+    }
+  },
+  "include": [
+    "./astro-blank-intl/**/*.ts"
+  ],
+  "exclude": [
+    "./astro-blank-intl/src/live.config.ts"
+  ]
+}

package/templates/astro-blank.tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "./astro-blank/tsconfig.json",
+  "compilerOptions": {
+    "incremental": false,
+    "allowImportingTsExtensions": true,
+    "paths": {
+      "@/*": [
+        "./astro-blank/src/*"
+      ],
+      "smoodly": [
+        "../../smoodly/src/index.ts"
+      ],
+      "smoodly/*": [
+        "../../smoodly/src/*"
+      ]
+    }
+  },
+  "include": [
+    "./astro-blank/**/*.ts"
+  ],
+  "exclude": [
+    "./astro-blank/src/live.config.ts"
+  ]
+}

package/templates/astro-lorem/AGENTS.md

@@ -0,0 +1,55 @@
+# Working in this Smoodly site
+
+This is an Astro site with Smoodly installed: content lives in Supabase, the admin is mounted at /admin by the `smoodly/astro` integration in `astro.config.ts`, and the site reads content through live collections (`src/live.config.ts`). Read README.md first: it says where things are.
+
+## Rules
+
+- **Register schemas in the config; views are files by name.** A section's view is
+  `src/sections/<name>.astro`, an element's `src/elements/<name>.astro`, a page
+  type's `src/page-types/<name>.astro`, an entry page's
+  `src/entry-pages/<collection>.astro`, where <name> is the schema's `name`.
+  The schema is listed in its barrel (`src/smoodly/sections.ts`, `elements.ts`,
+  the config's `pages`; collections and global items in `collections.ts`,
+  `globals.ts`) and `src/smoodly/config.ts` is the one registry. The server
+  names a schema with no file, and a file with no schema, at the first request.
+- **A `.schema.ts` file imports no component.** Zones, toolsets, global items and
+  `node()` take schemas (`z.locked(heroSchema)`), never views.
+- **After a new collection or a `smoodly` upgrade, run `npx smoodly migrate`**
+  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`.
+- **Content from code goes through `createContent(config)`** from `smoodly/astro`:
+  `scripts/seed.ts` is starter content written with it — 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; `npm run seed`.
+- **Reads are live collections.** `src/live.config.ts` names one loader per
+  collection, global item, the pages and the page tree; a view reads with
+  `getLiveCollection("articles", { locale })` or `getLiveEntry("footer", { locale })`
+  from `astro:content`. Every read tags the response, and a publish expires it.
+- **The admin, the preview address and the page shell are injected** by
+  `smoodly()` in `astro.config.ts`; the project has no route file for them. A page
+  file of your own under `src/pages` wins its address. `site` in `astro.config.ts`
+  is the site's own address (from `SITE_URL`).
+- **A link an editor typed goes through `safeHref`** from "smoodly" in an `.astro`
+  view: `<a href={safeHref(link.href)}>`. Astro writes attributes as given, so a
+  `javascript:` URL would reach the page; the template build refuses a shipped
+  view that skips it.
+- **Section styles are inline.** `<Section>` from `smoodly/astro/components` renders
+  the root element with Smoodly's styles set and the node id; marks
+  (`smoodly.marks(schema)`) tie rendered elements to fields.
+- **Multilingual sites.** The locale set is `locales` in `src/smoodly/config.ts`
+  and `i18n` in `astro.config.ts`; the two must agree. UI strings of the site's
+  own go through `src/strings.ts` and `src/messages/<locale>.json`.
+- **Fixed versus open pages.** A page type 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:4321, /admin is the editor
+    npm run build        # checks the schema files (smoodly migrate --check), then astro build
+    npm run start        # the built server (dist/server/entry.mjs)
+    npm run seed         # starter content, idempotent
+    npm run typecheck    # astro check

package/templates/astro-lorem/CLAUDE.md

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

package/templates/astro-lorem/README.md

@@ -0,0 +1,60 @@
+# Smoodly site
+
+Created by `create-smoodly-app`. Content lives in Supabase; the admin is
+mounted at `/admin` by the `smoodly/astro` integration. AGENTS.md holds the
+rules for an agent (or a person) building the site.
+
+    npm run dev          # http://localhost:4321 — /admin is the editor
+
+## Where things are
+
+- `astro.config.ts` — the `smoodly()` integration (it mounts the admin, the preview address and the page shell), the node adapter, the cache and `site` (from `SITE_URL`).
+- `src/smoodly/` — the wiring: `config.ts` (the registry of schemas and the settings), `collections.ts`, `sections.ts`, `elements.ts`, `globals.ts` and `toolsets.ts`. The schemas they register are `*.schema.ts` files under `src/components/`.
+- `src/sections/` — one `<name>.astro` view per section schema, named by the schema's `name`; the header, footer and quote behind the global items are here too.
+- `src/elements/` — one view per element schema, embedded in richtext.
+- `src/page-types/` — one view per page type: `home`, `page` (open; About lives here), `articlesIndex` and `newsIndex` (fixed pages at a collection's path).
+- `src/entry-pages/` — one view per collection that has entry pages: `articles` and `news`.
+- `src/layouts/Layout.astro` — the page shell every view renders: head, header, footer, `src/styles/global.css`.
+- `src/live.config.ts` — the live collections the views read with `getLiveCollection` and `getLiveEntry`.
+- `src/strings.ts`, `src/messages/` — the site's own UI strings in the page's language.
+- `public/images/` — the starter's photos; image fields hold URLs like `/images/hero_image.jpg`.
+- `scripts/seed.ts` — the starter content, written through `createContent(config)`. `npm run seed` is idempotent.
+- `.env` — `SMOODLY_URL`, `SMOODLY_SECRET_KEY`, `SMOODLY_PUBLISHABLE_KEY`.
+
+## What is in the starter
+
+The Lorem Co. site the installer seeded is a tour of the features:
+
+- **Home** — a locked hero (fields only; nobody adds, moves or removes it), then a freeform body: image and text (richtext), the global **quote** placed from the picker's Global group, points (a list with a minimum and a maximum, an object per item), favourite articles (an editor-picked list of refs).
+- **Articles** — a fixed page at the collection's own URL segment, so it is the collection's index: the hero is the editor's, the grid is code fetching published articles.
+- **Company / About** — a path and a page under it (the breadcrumb), the same body sections, plus people.
+- **News** — a collection at a nested address, `company/news`: code owns the whole address, so its index page and posts stay put when an editor renames Company, and nobody can create a page there.
+- **An article** — a collection entry with a richtext body, tags (a localized list), a date and an author ref; versioned, so every save is a snapshot.
+- **Global content** — the header and footer every page renders through \`src/layouts/Layout.astro\`, the contact details the footer reads, the quote pages place.
+
+Reseed an empty database any time with `npm run seed`.
+
+## Moving the admin
+
+The admin is at `/admin`. To serve it somewhere else, say `/studio`:
+
+1. set `smoodly({ adminPath: "/studio" })` in `astro.config.ts`,
+2. set `admin: { path: "/studio" }` in `src/smoodly/config.ts`.
+
+The two must agree; the admin says so when they do not.
+
+## 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`.

package/templates/astro-lorem/_gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.astro/
+.env
+smoodly-export-*

package/templates/astro-lorem/astro.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig, memoryCache } from "astro/config";
+import node from "@astrojs/node";
+import smoodly from "smoodly/astro";
+
+export default defineConfig({
+  output: "server",
+  adapter: node({ mode: "standalone" }),
+  // Pages are cached whole and expire by tag when an editor publishes (one process, one cache).
+  cache: { provider: memoryCache() },
+  // The site's own address: canonical, hreflang and social links are absolute on it. Astro reads astro.config
+  // before .env, so this sees only a SITE_URL set in the shell; when it is unset, smoodly() sets `site` from
+  // SITE_URL in .env. Set SITE_URL where you deploy: `site` is fixed at `astro build`.
+  site: process.env.SITE_URL,
+  integrations: [smoodly({ config: "src/smoodly/config.ts" })],
+});

package/templates/astro-lorem/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "smoodly-site",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "smoodly migrate --check && astro build",
+    "start": "node --env-file-if-exists=.env dist/server/entry.mjs",
+    "seed": "tsx scripts/seed.ts",
+    "typecheck": "astro check"
+  },
+  "dependencies": {
+    "@astrojs/node": "^11.1.6",
+    "@supabase/supabase-js": "^2.113.0",
+    "astro": "^7.3.5",
+    "smoodly": "0.0.47"
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.10",
+    "@types/node": "^26.4.1",
+    "typescript": "^5",
+    "tsx": "^4"
+  }
+}