create-goodfellow 0.0.0-stage → 0.2.0

package/templates/next/content/pages/index.json

@@ -0,0 +1,215 @@
+{
+  "version": 1,
+  "data": {
+    "content": [
+      {
+        "type": "Section",
+        "props": {
+          "id": "Section-hero",
+          "background": "primary",
+          "backgroundImage": "",
+          "className": "",
+          "content": [
+            {
+              "type": "Heading",
+              "props": {
+                "id": "Heading-hero",
+                "align": "left",
+                "className": "",
+                "level": "h1",
+                "text": "Welcome to my site"
+              }
+            },
+            {
+              "type": "Text",
+              "props": {
+                "id": "Text-hero",
+                "align": "left",
+                "className": "mt-4 max-w-2xl text-lg opacity-90",
+                "content": "<p>This page is stored as a file in your site's repository. Edit it in the admin panel, or change <code>content/pages/index.json</code> directly.</p>"
+              }
+            },
+            {
+              "type": "Flex",
+              "props": {
+                "id": "Flex-hero",
+                "align": "center",
+                "className": "mt-8",
+                "direction": "row",
+                "gap": "md",
+                "items": [
+                  {
+                    "type": "Button",
+                    "props": {
+                      "id": "Button-primary",
+                      "className": "",
+                      "href": "/about",
+                      "label": "About us",
+                      "newTab": false,
+                      "size": "lg",
+                      "variant": "secondary"
+                    }
+                  },
+                  {
+                    "type": "Button",
+                    "props": {
+                      "id": "Button-secondary",
+                      "className": "",
+                      "href": "/about",
+                      "label": "Contact",
+                      "newTab": false,
+                      "size": "lg",
+                      "variant": "outline"
+                    }
+                  }
+                ],
+                "justify": "start",
+                "wrap": true
+              }
+            }
+          ],
+          "padding": "lg",
+          "width": "normal"
+        }
+      },
+      {
+        "type": "Section",
+        "props": {
+          "id": "Section-features",
+          "background": "none",
+          "backgroundImage": "",
+          "className": "",
+          "content": [
+            {
+              "type": "Heading",
+              "props": {
+                "id": "Heading-features",
+                "align": "center",
+                "className": "mb-10",
+                "level": "h2",
+                "text": "Everything in one place"
+              }
+            },
+            {
+              "type": "Grid",
+              "props": {
+                "id": "Grid-features",
+                "className": "",
+                "columns": "3",
+                "gap": "md",
+                "items": [
+                  {
+                    "type": "Section",
+                    "props": {
+                      "id": "Section-feature-1",
+                      "background": "none",
+                      "backgroundImage": "",
+                      "className": "rounded-lg border px-2 py-6",
+                      "content": [
+                        {
+                          "type": "Heading",
+                          "props": {
+                            "id": "Heading-feature-1",
+                            "align": "left",
+                            "className": "",
+                            "level": "h3",
+                            "text": "Pages"
+                          }
+                        },
+                        {
+                          "type": "Text",
+                          "props": {
+                            "id": "Text-feature-1",
+                            "align": "left",
+                            "className": "mt-2 text-muted-foreground",
+                            "content": "<p>Build pages from blocks: sections, columns, text, images and buttons.</p>"
+                          }
+                        }
+                      ],
+                      "padding": "none",
+                      "width": "full"
+                    }
+                  },
+                  {
+                    "type": "Section",
+                    "props": {
+                      "id": "Section-feature-2",
+                      "background": "none",
+                      "backgroundImage": "",
+                      "className": "rounded-lg border px-2 py-6",
+                      "content": [
+                        {
+                          "type": "Heading",
+                          "props": {
+                            "id": "Heading-feature-2",
+                            "align": "left",
+                            "className": "",
+                            "level": "h3",
+                            "text": "Your design"
+                          }
+                        },
+                        {
+                          "type": "Text",
+                          "props": {
+                            "id": "Text-feature-2",
+                            "align": "left",
+                            "className": "mt-2 text-muted-foreground",
+                            "content": "<p>Set colors and fonts once in the site settings, and every page follows.</p>"
+                          }
+                        }
+                      ],
+                      "padding": "none",
+                      "width": "full"
+                    }
+                  },
+                  {
+                    "type": "Section",
+                    "props": {
+                      "id": "Section-feature-3",
+                      "background": "none",
+                      "backgroundImage": "",
+                      "className": "rounded-lg border px-2 py-6",
+                      "content": [
+                        {
+                          "type": "Heading",
+                          "props": {
+                            "id": "Heading-feature-3",
+                            "align": "left",
+                            "className": "",
+                            "level": "h3",
+                            "text": "No hosting bills"
+                          }
+                        },
+                        {
+                          "type": "Text",
+                          "props": {
+                            "id": "Text-feature-3",
+                            "align": "left",
+                            "className": "mt-2 text-muted-foreground",
+                            "content": "<p>The whole site is static files, so free hosting is enough.</p>"
+                          }
+                        }
+                      ],
+                      "padding": "none",
+                      "width": "full"
+                    }
+                  }
+                ]
+              }
+            }
+          ],
+          "padding": "lg",
+          "width": "normal"
+        }
+      }
+    ],
+    "root": {
+      "props": {
+        "className": "",
+        "description": "",
+        "image": "",
+        "title": "Welcome"
+      }
+    }
+  }
+}

package/templates/next/content/pages/news.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "data": {
+    "content": [
+      {
+        "type": "Section",
+        "props": {
+          "id": "Section-news-list",
+          "background": "none",
+          "backgroundImage": "",
+          "className": "",
+          "content": [
+            {
+              "type": "Heading",
+              "props": {
+                "id": "Heading-news",
+                "align": "left",
+                "className": "",
+                "level": "h1",
+                "text": "News"
+              }
+            },
+            {
+              "type": "CollectionList",
+              "props": {
+                "id": "CollectionList-news",
+                "className": "mt-8",
+                "collection": "news",
+                "columns": "3",
+                "dateField": "date",
+                "emptyText": "No news yet.",
+                "imageField": "image",
+                "layout": "cards",
+                "limit": 0,
+                "order": "default",
+                "show": "all",
+                "summaryField": "summary"
+              }
+            }
+          ],
+          "padding": "lg",
+          "width": "normal"
+        }
+      }
+    ],
+    "root": {
+      "props": {
+        "className": "",
+        "description": "The latest news.",
+        "image": "",
+        "title": "News"
+      }
+    }
+  }
+}

package/templates/next/content/site.json

@@ -0,0 +1,25 @@
+{
+  "version": 1,
+  "description": "A website built with Goodfellow.",
+  "favicon": "/media/favicon.svg",
+  "language": "en",
+  "logo": {
+    "alt": "My site",
+    "src": "/media/logo.svg"
+  },
+  "theme": {
+    "colors": {
+      "border": "#e2e8f0",
+      "muted": "#f1f5f9",
+      "mutedForeground": "#64748b",
+      "primary": "#1e3a8a",
+      "primaryForeground": "#ffffff"
+    },
+    "fonts": {
+      "body": "Inter",
+      "heading": "Fraunces"
+    }
+  },
+  "title": "My site",
+  "titleTemplate": "%s | My site"
+}

package/templates/next/content/styles/custom.css

@@ -0,0 +1,4 @@
+/* Site-wide CSS. Anything here overrides the blocks' own styles. */
+.gf-header {
+  border-bottom: 1px solid var(--color-border);
+}

package/templates/next/goodfellow.config.tsx

@@ -0,0 +1,17 @@
+import { blocks, categories } from "@goodfellow-cms/blocks";
+import { defineConfig } from "@goodfellow-cms/core";
+// import { github } from "@goodfellow-cms/github";
+// import { gitlab } from "@goodfellow-cms/gitlab";
+import { installedBlocks, installedCategories } from "./blocks/installed";
+
+export default defineConfig({
+  // The built-in blocks, and those installed from the admin panel's Blocks screen.
+  // Add your own here too, e.g. `blocks: { ...blocks, ...installedBlocks, MassTimes }`.
+  blocks: { ...blocks, ...installedBlocks },
+  categories: { ...categories, ...installedCategories },
+
+  // Where the site is stored. Once this is set, builds include the admin panel at /admin.
+  // See README.md for how to set up sign-in.
+  // backend: github({ repo: "your-name/your-site" }),
+  // backend: gitlab({ project: "your-name/your-site", clientId: "your-application-id" }),
+});

package/templates/next/lib/site.ts

@@ -0,0 +1,5 @@
+import { goodfellowPages } from "@goodfellow-cms/next";
+import config from "@/goodfellow.config";
+
+/** The site's pages, shared by the routes that show them. */
+export const site = goodfellowPages(config);

package/templates/next/next.config.ts

@@ -0,0 +1,7 @@
+import { withGoodfellow } from "@goodfellow-cms/next/config";
+
+// Builds the site as static files in out/. Add your own Next.js settings inside withGoodfellow({ ... }).
+export default withGoodfellow({
+  // Stops `next dev` adding AGENTS.md and CLAUDE.md to the site.
+  agentRules: false,
+});

package/templates/next/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@goodfellow-cms/template-next",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev --port 4321",
+    "build": "next build && goodfellow-next finish out",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@goodfellow-cms/admin": "workspace:*",
+    "@goodfellow-cms/blocks": "workspace:*",
+    "@goodfellow-cms/core": "workspace:*",
+    "@goodfellow-cms/github": "workspace:*",
+    "@goodfellow-cms/gitlab": "workspace:*",
+    "@goodfellow-cms/next": "workspace:*",
+    "@goodfellow-cms/react": "workspace:*",
+    "@puckeditor/core": "0.23.0",
+    "class-variance-authority": "0.7.1",
+    "clsx": "2.1.1",
+    "cn": "0.4.0",
+    "embla-carousel-react": "8.6.0",
+    "lucide-react": "1.52.0",
+    "next": "16.3.8",
+    "radix-ui": "1.7.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tailwind-merge": "3.7.0",
+    "tw-animate-css": "1.4.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "4.3.3",
+    "@types/node": "^22.19.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "tailwindcss": "4.3.3",
+    "typescript": "5.9.3"
+  }
+}

package/templates/next/postcss.config.mjs

@@ -0,0 +1,3 @@
+export default {
+  plugins: { "@tailwindcss/postcss": {} },
+};

package/templates/next/public/media/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40"><rect width="40" height="40" rx="10" fill="#1e3a8a"/><path d="M12 28V12h6.5a5 5 0 0 1 0 10H16v6zm4-9.5h2.4a1.75 1.75 0 0 0 0-3.5H16z" fill="#fff"/></svg>

package/templates/next/public/media/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40"><rect width="40" height="40" rx="10" fill="#1e3a8a"/><path d="M12 28V12h6.5a5 5 0 0 1 0 10H16v6zm4-9.5h2.4a1.75 1.75 0 0 0 0-3.5H16z" fill="#fff"/></svg>

package/templates/next/public/media/placeholder.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 450"><rect width="800" height="450" fill="#e2e8f0"/><path d="M0 450 260 210l140 130 110-90 290 200z" fill="#cbd5e1"/><circle cx="600" cy="130" r="50" fill="#cbd5e1"/></svg>

package/templates/next/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "allowJs": true,
+    "esModuleInterop": true,
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/parish/.github/workflows/deploy.yml

@@ -0,0 +1,84 @@
+# Builds the site and publishes it with GitHub Pages whenever the main branch
+# changes (including every Publish in the admin panel), and once a night so
+# date-based content stays current. Each night it first installs Goodfellow's
+# newest fixes, and publishes them only if the site still builds with them,
+# unless content/updates.json turns automatic updates off.
+# In the repository's Settings → Pages, set "Source" to "GitHub Actions".
+# See README.md.
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  schedule:
+    - cron: "17 4 * * *"
+  workflow_dispatch:
+    inputs:
+      update:
+        description: "Update Goodfellow first: fixes, latest, or a release such as 0.5.0 (an older one goes back to it). Leave empty to only build."
+        required: false
+        default: ""
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  update:
+    # Each night, and when the admin panel's Updates screen asks.
+    if: github.event_name == 'schedule' || (github.event_name == 'workflow_dispatch' && inputs.update != '')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      sha: ${{ steps.update.outputs.sha }}
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - id: update
+        env:
+          TO: ${{ inputs.update || 'automatic' }}
+        run: npx goodfellow update --publish --to "$TO"
+
+  build:
+    needs: update
+    # Also when there was no update to run, or it didn't work: the site is built either way.
+    if: ${{ !cancelled() }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          # The update's commit, when it published one.
+          ref: ${{ needs.update.outputs.sha || github.sha }}
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 22
+          cache: npm
+      - id: pages
+        uses: actions/configure-pages@v5
+      - run: npm ci
+      # Project sites live in a subfolder (/repository-name/); user and organization sites don't.
+      - run: npx goodfellow build --base "${{ steps.pages.outputs.base_path }}/"
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    if: ${{ !cancelled() && needs.build.result == 'success' }}
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

package/templates/parish/.gitlab-ci.yml

@@ -0,0 +1,28 @@
+# Builds the site and publishes it with GitLab Pages whenever the default
+# branch changes (including every Publish in the admin panel). On scheduled
+# pipelines, which the admin panel's Updates screen sets up to run each night,
+# it first installs Goodfellow's newest fixes, unless content/updates.json turns
+# automatic updates off (or the release GOODFELLOW_UPDATE names), and publishes
+# them only if the site still builds with them. That
+# needs "Allow Git push requests to the repository" under Settings → CI/CD →
+# Job token permissions, which the Updates screen turns on. See README.md.
+pages:
+  image: node:22
+  cache:
+    key:
+      files: [package-lock.json]
+    paths: [.npm/]
+  script:
+    - npm ci --cache .npm --prefer-offline
+    - |
+      if [ "$CI_PIPELINE_SOURCE" = "schedule" ] || [ -n "$GOODFELLOW_UPDATE" ]; then
+        git remote set-url origin "https://gitlab-ci-token:${CI_JOB_TOKEN}@${CI_SERVER_FQDN:-$CI_SERVER_HOST}/${CI_PROJECT_PATH}.git"
+        npx goodfellow update --publish --to "${GOODFELLOW_UPDATE:-automatic}" || echo "The update wasn't published; building the site as it is."
+      fi
+    # Pages may serve the site from a subfolder, such as https://group.gitlab.io/site/.
+    - export GOODFELLOW_BASE="$(node -e 'console.log(new URL(process.env.CI_PAGES_URL).pathname)')"
+    - npx goodfellow build
+  pages:
+    publish: dist
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

package/templates/parish/README.md

@@ -0,0 +1,128 @@
+# St. Joseph Parish (example)
+
+An example parish website built with [Goodfellow](https://github.com/goodfellow-cms/goodfellow-cms). **St. Joseph Parish is made up**: its name, address, phone number, staff, history, Mass times and events are invented, and the pictures are simple drawings. Replace them all with your own before putting the site online.
+
+Start a site from this example with `npm create goodfellow@latest my-parish -- --template parish`.
+
+## Working on the site
+
+<!-- goodfellow-repository -->
+> **In the Goodfellow repository**, this folder is part of a pnpm workspace, so `npm install` doesn't work here. From the repository's root, run `pnpm install` and `pnpm build` (get pnpm with `corepack enable`, or `npm install -g pnpm`), then `pnpm dev` in this folder. The `npm` commands below are for a site of your own, created with `npm create goodfellow`, which leaves this note out.
+<!-- /goodfellow-repository -->
+
+```sh
+npm install
+npm run dev      # site at http://localhost:4321, admin panel at http://localhost:4321/admin
+npm run build    # builds the site into dist/
+npm run preview  # serves dist/
+```
+
+On your own computer, the admin panel saves straight to the files in `content/`.
+
+## What's in it
+
+- **Pages:** home, Mass times, sacraments, events, news, bulletins, about us and contact, with a submenu under **Parish life**.
+- **Collections**, edited under **Collections** in the admin panel:
+  - **Events**, with a date, time and place. The home page shows the next three, and the events page splits upcoming and past events. Lists of upcoming events change by date, so the site's nightly rebuild keeps them current.
+  - **News** stories, newest first.
+  - **Bulletins:** each one links to a PDF uploaded on the **Media** screen.
+  - **Staff**, listed on the About us page. They have no pages of their own, and the **Order** field sets who comes first.
+- **Contact details** (address, phone and email) are set once in **Site settings → General**, and shown in the footer and on the contact page by the **Contact details** block.
+- **More blocks**, such as an FAQ and tabs, can be added on the admin panel's **Blocks** screen. See [Add blocks](https://goodfellow-cms.github.io/goodfellow-cms/docs/add-blocks).
+- **The parish's own blocks**, in `blocks/`, show how a developer adds blocks to a site. They're listed under **Parish** in the editor:
+  - **Mass times:** a list of days and times, each with an optional note.
+  - **Scripture quote:** a short passage with its reference. The example uses the Douay-Rheims Bible (Challoner revision), a Catholic translation in the public domain; most modern translations need permission to quote.
+  - **Notice:** an announcement that stands out from the text around it.
+
+  Each block is a React component plus the fields the editor shows for it. They're added to the editor in `goodfellow.config.tsx`. Never rename a block's key or its fields once pages use them, since content files refer to them by name. Parts of a block that respond to visitors, such as a button that shows more, go in a file starting with `"use client"`, and only pages that use them load JavaScript: see [Interactive blocks](https://goodfellow-cms.github.io/goodfellow-cms/docs/interactive-blocks).
+
+## Making it yours
+
+1. In **Site settings**, change the parish's name, contact details, logo, colors and fonts.
+2. Edit the Mass times on the home page and the Mass times page.
+3. Replace the example events, news, staff and bulletins under **Collections**, and the pictures on the **Media** screen.
+4. Rewrite the about us, sacraments and contact pages, and remove the note at the bottom of the footer (in **Header & footer**).
+
+## Putting the site online
+
+Setup takes four steps. It's done once, usually by whoever set up the site.
+
+### 1. Store the site on GitHub or GitLab
+
+Create an empty repository on GitHub or GitLab, without a README, and push this folder to it:
+
+```sh
+git remote add origin https://github.com/your-name/your-site.git   # unless origin is already set
+git push -u origin main
+```
+
+`create-goodfellow` makes the new site a git repository on the branch `main`, with everything, `package-lock.json` included, in its first commit, and sets `origin` when it's given the repository. Commit any changes since (`git add -A` and `git commit`) before pushing.
+
+### 2. Tell Goodfellow where the site is stored
+
+If you gave the repository when creating the site with `npm create goodfellow`, this is already done. Otherwise, in `goodfellow.config.tsx`, uncomment one `backend` line and its `import`, and fill in your repository:
+
+```tsx
+import { github } from "@goodfellow-cms/github";
+
+export default defineConfig({
+  blocks,
+  categories,
+  backend: github({ repo: "your-name/your-site" }),
+});
+```
+
+Builds include the admin panel at `/admin` only once a backend is set. If the live site is built from a branch other than the repository's default branch, add `branch: "name"`.
+
+Also set the site's address under **Site settings → General → Site address**, including any subfolder (such as `https://your-name.github.io/your-site`). It's used for the sitemap and for link previews.
+
+### 3. Choose a host
+
+Each host's free plan has its own rules about business use. If the site is for a business, sells anything, shows ads, or is built or looked after by someone who's paid for it, check those rules first. As of October 2026, GitHub Pages and Vercel's free plan don't allow most of these, and GitLab Pages has no rule against them that we know of. See [Hosts and business sites](https://goodfellow-cms.github.io/goodfellow-cms/docs/hosts) in Goodfellow's documentation.
+
+**GitHub Pages** (free for public repositories; not for online businesses or shops)
+
+1. In the repository on GitHub, go to **Settings → Pages** and set **Source** to **GitHub Actions**.
+2. Push. `.github/workflows/deploy.yml` builds and publishes the site on every change and once a night. If your main branch isn't called `main`, change it in that file.
+
+**GitLab Pages** (free, including for private projects; no rule against business sites that we know of)
+
+1. Push. `.gitlab-ci.yml` builds and publishes the site on every change to the default branch.
+2. For nightly rebuilds, add a schedule under **Build → Pipeline schedules**.
+3. The site's address is under **Deploy → Pages**.
+
+**Vercel** (works with GitHub and GitLab; the free plan is for non-commercial sites only)
+
+1. Import the repository in Vercel. `vercel.ts` already has the right settings, and has Vercel send the site's redirects itself.
+2. For nightly rebuilds, create a deploy hook under **Settings → Git → Deploy Hooks**, and call it from a scheduled GitHub Action or GitLab pipeline schedule.
+
+Delete the setup files for the hosts you don't use.
+
+### 4. Set up sign-in
+
+**GitHub:** nothing to set up. Editors sign in at `/admin` with an access token. The admin panel links to GitHub's token page with the right permissions already chosen. On that page, under **Repository access**, choose **Only select repositories** and pick the site.
+
+- Editors who are collaborators on someone else's personal repository can't use that kind of token. They can use the "broader token" link instead. Alternatively, move the repository into a free GitHub organization and make editors members.
+
+**GitLab:** editors can sign in with an access token straight away. For one-click **Sign in with GitLab**, register the admin panel with GitLab once:
+
+1. Go to your profile's **Preferences → Applications** (or the group's **Settings → Applications**) and add an application.
+2. Set:
+   - **Redirect URI:** the admin panel's address with a trailing slash, such as `https://your-site.example/admin/`.
+   - **Confidential:** leave this **off**.
+   - **Scopes:** `api`.
+3. Copy the **Application ID** into the config: `gitlab({ project: "your-name/your-site", clientId: "…" })`.
+
+Every editor needs permission to change the repository: on GitHub, write access; on GitLab, the Developer role or higher.
+
+## Images and files
+
+Upload images and files, such as the weekly bulletin, on the admin panel's **Media** screen, or with the **Choose image** button wherever an image goes. They're saved in `public/media/`, and large photos are made web-sized automatically.
+
+## Writing with AI
+
+The admin panel's **AI** tab can draft pages, rewrite blocks and fill in events and news stories. Each editor picks an AI service there. Claude and some others need the editor's own API key and charge for use; there are free options, including copying the request into a chat app such as Claude.ai. To offer only some services, or to turn the assistant off, see `ai` in [Configuration](https://goodfellow-cms.github.io/goodfellow-cms/docs/configuration).
+
+## Publishing
+
+Each **Publish** in the admin panel saves its changes as one commit to the main branch, which starts a new build. The admin panel shows when the live site has been updated, usually within a minute or two. If someone else changed the same page in the meantime, publishing stops and explains what happened, instead of overwriting their work.