create-shapio 0.3.1 → 0.4.1

package/templates/astro/src/lib/types.ts

@@ -1,3 +1,5 @@
+import type { SeoResolved } from '@shapio/client';
+
 /**
  * Content as the Shapio delivery API returns it for this site's models (shapio/). Delivery
  * entries are flat: system attributes next to the fields, keyed by API key. Media fields are asset views,
@@ -24,6 +26,7 @@ export type Media = {
   variants: MediaVariant[];
 };
 
+/** Rich text as delivery returns it with `richText=html`: sanitized HTML rendered from the document. */
 export type RichText = { format: 'shapio-richtext'; version: number; html: string };
 
 type EntryBase = {
@@ -61,6 +64,8 @@ export type Page = EntryBase & {
   slug: string;
   description: string | null;
   sections: Section[];
+  /** The built-in SEO fields, read with `seo=resolved` (the site's defaults filled in). */
+  seo: SeoResolved;
 };
 
 export type Author = EntryBase & { name: string; bio: string | null; avatar: Media | null };
@@ -74,6 +79,8 @@ export type Article = EntryBase & {
   /** Populated (`populate=author`) or just the ID; null when the author is not published. */
   author: Author | string | null;
   publishedOn: string;
+  /** The built-in SEO fields, read with `seo=resolved` (the site's defaults filled in). */
+  seo: SeoResolved;
 };
 
 /** The `siteSettings` singleton: one entry per site, read by its API ID. */

package/templates/astro/src/pages/[locale]/[...slug].astro

@@ -23,6 +23,6 @@ type Props = { page: Page; locale: Locale };
 const { page, locale } = Astro.props;
 ---
 
-<Base title={page.title} description={page.description} locale={locale} alternatePath={pagePath(otherLocale(locale), page.slug)}>
+<Base title={page.title} seo={page.seo} locale={locale} alternatePath={pagePath(otherLocale(locale), page.slug)}>
   <div lang={page.locale} set:html={renderPage(page)} />
 </Base>

package/templates/astro/src/pages/[locale]/articles/[slug].astro

@@ -20,6 +20,6 @@ const { locale, article } = Astro.props;
 const context = { locale, strings: stringsFor(locale) };
 ---
 
-<Base title={article.title} description={article.excerpt} locale={locale} alternatePath={articlePath(otherLocale(locale), article.slug)}>
+<Base title={article.title} seo={article.seo} type="article" locale={locale} alternatePath={articlePath(otherLocale(locale), article.slug)}>
   <Fragment set:html={renderArticle(article, context)} />
 </Base>

package/templates/next/.env.example

@@ -13,3 +13,5 @@ SHAPIO_WEBHOOK_SECRET=
 NEXT_TELEMETRY_DISABLED=1
 # Optional: the Shapio URL the browser calls for draft previews, when it differs from SHAPIO_URL.
 # NEXT_PUBLIC_SHAPIO_URL=https://cms.example.com
+# Optional: this site's public origin; pages then carry a canonical URL and og:url.
+# SITE_URL=https://www.example.com

package/templates/next/package.json

@@ -17,8 +17,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@shapio/client": "^0.3.1",
-    "@shapio/visual": "^0.3.1",
+    "@shapio/client": "^0.4.1",
+    "@shapio/visual": "^0.4.1",
     "next": "16.3.8",
     "react": "19.3.0",
     "react-dom": "19.3.0"

package/templates/next/scripts/lib/content.ts

@@ -448,15 +448,56 @@ export type EntrySpec = {
   publish: boolean;
 };
 
+/**
+ * The SEO fields of one locale (the built-in `seo` component, per locale): a page describes itself with its
+ * description, an article with its excerpt and its cover (a shared field, so it comes from the English data).
+ * The title stays empty: `?seo=resolved` falls back to the entry's own title, through the site's template.
+ */
+const seoOf = (data: Record<string, unknown>, shared: Record<string, unknown>) => ({
+  description: data.excerpt ?? data.description ?? null,
+  image: shared.cover ?? null,
+});
+
+const withSeo = (content: Localized<Record<string, unknown>>): Localized<Record<string, unknown>> => ({
+  en: { ...content.en, seo: seoOf(content.en, content.en) },
+  fr: { ...content.fr, seo: seoOf(content.fr, content.en) },
+});
+
 export const entries = (media: MediaIds, authorId: string): EntrySpec[] => [
-  { model: 'page', slug: 'home', content: home(media), publish: true },
-  { model: 'page', slug: 'about', content: about(), publish: true },
+  { model: 'page', slug: 'home', content: withSeo(home(media)), publish: true },
+  { model: 'page', slug: 'about', content: withSeo(about()), publish: true },
   {
     model: 'article',
     slug: 'modelling-without-a-deploy',
-    content: modelling(media, authorId),
+    content: withSeo(modelling(media, authorId)),
+    publish: true,
+  },
+  {
+    model: 'article',
+    slug: 'why-builds-pin-a-snapshot',
+    content: withSeo(snapshots(media, authorId)),
     publish: true,
   },
-  { model: 'article', slug: 'why-builds-pin-a-snapshot', content: snapshots(media, authorId), publish: true },
-  { model: 'article', slug: 'winter-projects', content: draft(media, authorId), publish: false },
+  { model: 'article', slug: 'winter-projects', content: withSeo(draft(media, authorId)), publish: false },
 ];
+
+/**
+ * The site's SEO defaults (Settings → SEO; `PUT /api/admin/site/seo`): the name and template match the
+ * siteSettings singleton's site name, the description its tagline; the hero image is the default social image.
+ */
+export const seoDefaults = (media: MediaIds) => ({
+  locales: {
+    en: {
+      siteName: String(SITE_SETTINGS.en.siteName),
+      titleTemplate: `%s · ${String(SITE_SETTINGS.en.siteName)}`,
+      description: String(SITE_SETTINGS.en.tagline),
+    },
+    fr: {
+      siteName: String(SITE_SETTINGS.fr.siteName),
+      titleTemplate: `%s · ${String(SITE_SETTINGS.fr.siteName)}`,
+      description: String(SITE_SETTINGS.fr.tagline),
+    },
+  },
+  imageId: media.hero,
+  twitterHandle: '@northwindstudio',
+});

package/templates/next/scripts/seed.ts

@@ -4,6 +4,7 @@ import { setTimeout as delay } from 'node:timers/promises';
 import { parseArgs } from 'node:util';
 import {
   buildUploadForm,
+  SEO_COMPONENT_ID,
   ShapioApiError,
   type MediaAsset,
   type SchemaApplyInput,
@@ -15,6 +16,7 @@ import {
   AUTHOR,
   entries,
   IMAGES,
+  seoDefaults,
   SITE_SETTINGS,
   type EntrySpec,
   type ImageSpec,
@@ -29,8 +31,9 @@ import { createPng } from './lib/png.js';
  * 2. the models and components in shapio/ through the schema apply API (live, no restart; the same planner
  *    as `shapio schema apply` and the admin), as the site's own (SHAPIO_SITE, else the token's site, else the
  *    primary): a starter's schema belongs to the first site it is seeded on;
+ *    The built-in SEO component (components/seo.json) is the exception: it is always shared with every site;
  * 3. placeholder images, an author, the site settings, pages and articles in English and French, published
- *    per locale;
+ *    per locale, and the site's SEO defaults (Settings → SEO);
  * 4. a deployment connection named "Preview" whose preview URL opens this starter's /preview/ page (the
  *    entry document's Preview pane and visual editing; it triggers no builds). The site's URL is SITE_URL, else
  *    the starter's `--site-url` (its local dev server);
@@ -50,6 +53,8 @@ const PREVIEW_PATH = '/preview/?model={modelKey}&id={entryId}&locale={locale}#to
 /** A placeholder build hook: the connection has no triggers, so nothing is ever sent to it. */
 const PREVIEW_BUILD_HOOK = 'https://build.invalid/shapio-starter';
 const REVALIDATE_WEBHOOK_NAME = 'Site revalidation';
+/** The request's site's SEO defaults (`site.settings`). */
+const SEO_DEFAULTS_PATH = '/api/admin/site/seo';
 /** The events that change what a published site shows (the starter's route ignores any others). */
 const REVALIDATE_EVENTS = [
   'entry.published',
@@ -58,6 +63,8 @@ const REVALIDATE_EVENTS = [
   'change_set.shipped',
   'schema.activated',
   'schema.deleted',
+  // The site's SEO defaults changed: every page's head shows them.
+  'site.updated',
 ];
 /** A local site needs Shapio's OUTBOUND_PRIVATE_NETWORK_ALLOWLIST too; the webhook opts in for loopback only. */
 const LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]']);
@@ -129,8 +136,11 @@ const applySchema = async (client: ShapioClient) => {
   try {
     response = await client.admin.schema.apply({
       definitions,
-      // Every definition is the site's own (sites/<key>/ in a pulled tree), never shared by default.
-      scopes: definitions.map(() => 'site' as const),
+      // Every definition is the site's own (sites/<key>/ in a pulled tree), never shared by default, except
+      // the built-in SEO component: Shapio knows it by its fixed ID, so one shared copy serves every site.
+      scopes: definitions.map((definition) =>
+        (definition as { id?: unknown }).id === SEO_COMPONENT_ID ? ('network' as const) : ('site' as const),
+      ),
       base: FIRST_APPLY_BASE,
       prune: false,
       dryRun: false,
@@ -143,7 +153,8 @@ const applySchema = async (client: ShapioClient) => {
         "This starter's schema already belongs to another site of this instance: a starter's schema belongs " +
           'to the first site it is seeded on. To reuse it on this site, share it with all sites ' +
           'with a network admin token (`shapio schema scope <apiKey> --shared --site <that site>` for each ' +
-          'component, then author, page, article and siteSettings) and seed again, or seed a separate instance.',
+          'component, then author, page, article and siteSettings) and seed again, or seed a separate instance. ' +
+          'The SEO component is always shared; a site that keeps its own copy of it blocks the others.',
         { cause: error },
       );
     }
@@ -259,6 +270,16 @@ const ensureSiteSettings = async (client: ShapioClient) => {
   log('Published siteSettings (en, fr)');
 };
 
+/** The site's SEO defaults: the texts per locale, the default social image and the Twitter handle. */
+const ensureSeoDefaults = async (client: ShapioClient, media: MediaIds) => {
+  const current = await client.request<{ version: number }>(SEO_DEFAULTS_PATH);
+  await client.request(SEO_DEFAULTS_PATH, {
+    method: 'PUT',
+    body: { expectedVersion: current.version, seo: seoDefaults(media) },
+  });
+  log('Set the SEO defaults (en, fr)');
+};
+
 const upsertEntry = async (client: ShapioClient, spec: EntrySpec) => {
   const found = await client.admin.content.list(spec.model, {
     filters: { slug: { $eq: spec.slug } },
@@ -413,6 +434,7 @@ const main = async () => {
     await applySchema(admin.client);
     const media = await ensureMedia(admin.client);
     await ensureSiteSettings(admin.client);
+    await ensureSeoDefaults(admin.client, media);
     const authorId = await ensureAuthor(admin.client, media.avatar);
     for (const spec of entries(media, authorId)) {
       await upsertEntry(admin.client, spec);

package/templates/next/scripts/smokeHttp.ts

@@ -5,7 +5,8 @@ import { parseArgs } from 'node:util';
  * `npm run smoke`, after `npm run seed`, `npm run build` and starting the built site (`npm run start` or
  * `npm run preview`): fetches the site's pages over HTTP and checks the seeded content in English and French,
  * the site settings singleton, rich text, media variants and the author, that the draft article is not
- * served, that content carries the visual-editing attributes (@shapio/visual's `shapioAttr`), and that the
+ * served, that content carries the visual-editing attributes (@shapio/visual's `shapioAttr`), that pages carry
+ * their SEO tags (the entry's SEO fields with the site's defaults: title template, Open Graph, Twitter), and that the
  * preview page is served with a `frame-ancestors` policy. The same checks run against every starter, so all
  * three render the same blog.
  *
@@ -28,6 +29,9 @@ const PAGES: readonly PageCheck[] = [
       ['.webp', 'responsive image variants'],
       ['Northwind Studio', 'site name from the siteSettings singleton'],
       ['Built with Shapio', 'footer from the siteSettings singleton'],
+      ['<title>Home · Northwind Studio</title>', 'title through the SEO title template'],
+      ['property="og:image"', 'og:image (the default social image)'],
+      ['name="twitter:site" content="@northwindstudio"', 'twitter:site from the SEO defaults'],
     ],
   },
   {
@@ -36,6 +40,7 @@ const PAGES: readonly PageCheck[] = [
       ['Un contenu qui évolue aussi vite que votre produit', 'hero heading'],
       ['lang="fr"', 'lang="fr"'],
       ['Studio Northwind', 'site name from the siteSettings singleton'],
+      ['<title>Accueil · Studio Northwind</title>', 'title through the French SEO title template'],
     ],
   },
   {
@@ -43,6 +48,7 @@ const PAGES: readonly PageCheck[] = [
     expect: [
       ['Modelling content without a deploy', 'article list'],
       ['Why our builds pin a snapshot', 'second article'],
+      ['<title>Journal · Northwind Studio</title>', 'a page without an entry: title through the template'],
     ],
   },
   {
@@ -55,6 +61,10 @@ const PAGES: readonly PageCheck[] = [
       ['data-shapio-entry="', 'visual-editing entry attribute'],
       ['data-shapio-path="title"', 'visual-editing attribute on the title'],
       ['data-shapio-path="body"', 'visual-editing attribute on the body'],
+      ['<title>Modelling content without a deploy · Northwind Studio</title>', 'SEO title (resolved)'],
+      ['property="og:type" content="article"', 'og:type article'],
+      ['Nothing restarted.', 'SEO description from the entry'],
+      ['name="twitter:card" content="summary_large_image"', 'twitter:card with the cover image'],
     ],
   },
   { path: `/fr/articles/${ARTICLE}/`, expect: [['Modéliser du contenu sans déploiement', 'title']] },

package/templates/next/shapio/components/seo.json

@@ -0,0 +1,114 @@
+{
+  "apiKey": "seo",
+  "category": "Built-in",
+  "description": "Search and social metadata: title, description, image, canonical URL and indexing.",
+  "display": {
+    "titleFieldId": "3fe294a9-6af9-4019-8b32-43010822e45a"
+  },
+  "fields": [
+    {
+      "apiKey": "title",
+      "deprecated": false,
+      "editor": {
+        "id": "textInput",
+        "options": {}
+      },
+      "filterable": false,
+      "id": "3fe294a9-6af9-4019-8b32-43010822e45a",
+      "label": "Title",
+      "localized": false,
+      "public": true,
+      "required": false,
+      "settings": {},
+      "sortable": false,
+      "type": "string",
+      "unique": false
+    },
+    {
+      "apiKey": "description",
+      "deprecated": false,
+      "editor": {
+        "id": "textarea",
+        "options": {}
+      },
+      "filterable": false,
+      "id": "6d1917f3-94a2-4391-ba1f-a98d14577b93",
+      "label": "Description",
+      "localized": false,
+      "public": true,
+      "required": false,
+      "settings": {},
+      "sortable": false,
+      "type": "text",
+      "unique": false
+    },
+    {
+      "apiKey": "image",
+      "deprecated": false,
+      "editor": {
+        "id": "mediaPicker",
+        "options": {}
+      },
+      "filterable": false,
+      "id": "d27c9354-4afc-4583-93b4-367214a7714a",
+      "label": "Social image",
+      "localized": false,
+      "public": true,
+      "required": false,
+      "settings": {
+        "allowedKinds": [
+          "image"
+        ],
+        "multiple": false
+      },
+      "sortable": false,
+      "type": "media",
+      "unique": false
+    },
+    {
+      "apiKey": "canonical",
+      "deprecated": false,
+      "editor": {
+        "id": "textInput",
+        "options": {}
+      },
+      "filterable": false,
+      "id": "17b374b6-cd85-444e-8403-20c7458ed29e",
+      "label": "Canonical URL",
+      "localized": false,
+      "public": true,
+      "required": false,
+      "settings": {
+        "protocols": [
+          "https",
+          "http"
+        ]
+      },
+      "sortable": false,
+      "type": "url",
+      "unique": false
+    },
+    {
+      "apiKey": "noindex",
+      "deprecated": false,
+      "editor": {
+        "id": "toggle",
+        "options": {}
+      },
+      "filterable": false,
+      "id": "e8346f99-dc3c-4b5c-906f-4854e03c9a57",
+      "label": "Hide from search engines",
+      "localized": false,
+      "public": true,
+      "required": false,
+      "settings": {},
+      "sortable": false,
+      "type": "boolean",
+      "unique": false
+    }
+  ],
+  "icon": "search",
+  "id": "f3905a00-d2a3-4c62-899a-c894bfd6cb9b",
+  "kind": "component",
+  "label": "SEO"
+}

package/templates/next/shapio/models/article.json

@@ -140,6 +140,27 @@
       "sortable": true,
       "type": "date",
       "unique": false
+    },
+    {
+      "apiKey": "seo",
+      "deprecated": false,
+      "editor": {
+        "id": "seoEditor",
+        "options": {}
+      },
+      "filterable": false,
+      "id": "a3f1c0de-7b52-4e0a-9d1e-5c2b8e4f6a01",
+      "label": "SEO",
+      "localized": true,
+      "public": true,
+      "required": false,
+      "settings": {
+        "component": "f3905a00-d2a3-4c62-899a-c894bfd6cb9b",
+        "repeatable": false
+      },
+      "sortable": false,
+      "type": "component",
+      "unique": false
     }
   ],
   "id": "1679d89c-747f-4dfc-955f-7d47bd5e4f6b",

package/templates/next/shapio/models/page.json

@@ -83,6 +83,27 @@
       "sortable": false,
       "type": "dynamiczone",
       "unique": false
+    },
+    {
+      "apiKey": "seo",
+      "deprecated": false,
+      "editor": {
+        "id": "seoEditor",
+        "options": {}
+      },
+      "filterable": false,
+      "id": "b7e2d1af-3c64-4f1b-8e2a-6d3c9f5a7b02",
+      "label": "SEO",
+      "localized": true,
+      "public": true,
+      "required": false,
+      "settings": {
+        "component": "f3905a00-d2a3-4c62-899a-c894bfd6cb9b",
+        "repeatable": false
+      },
+      "sortable": false,
+      "type": "component",
+      "unique": false
     }
   ],
   "id": "4c09af05-f302-4d8f-ba03-bb838d3afbd2",

package/templates/next/src/app/[locale]/[[...slug]]/page.tsx

@@ -1,8 +1,9 @@
 import type { Metadata } from 'next';
 import { notFound } from 'next/navigation';
 import { Sections } from '../../../components/Sections';
+import { pageMetadata } from '../../../lib/metadata';
 import { listPages } from '../../../lib/shapio';
-import { HOME_SLUG, toLocale, type Locale } from '../../../lib/site';
+import { HOME_SLUG, pagePath, toLocale, type Locale } from '../../../lib/site';
 
 /**
  * Pages from the `page` collection; `home` is the locale's front page (`/en/`), the others `/en/<slug>/`.
@@ -25,7 +26,14 @@ const findPage = async (locale: Locale, slug: string[] | undefined) => {
 export const generateMetadata = async ({ params }: PageParams): Promise<Metadata> => {
   const { locale, slug } = await params;
   const page = await findPage(toLocale(locale), slug);
-  return page ? { title: page.title, description: page.description ?? undefined } : {};
+  return page
+    ? pageMetadata({
+        title: page.title,
+        seo: page.seo,
+        locale: toLocale(locale),
+        path: pagePath(locale, page.slug),
+      })
+    : {};
 };
 
 const ContentPage = async ({ params }: PageParams) => {

package/templates/next/src/app/[locale]/articles/[slug]/page.tsx

@@ -1,8 +1,9 @@
 import type { Metadata } from 'next';
 import { notFound } from 'next/navigation';
 import { ArticleView } from '../../../../components/ArticleView';
+import { pageMetadata } from '../../../../lib/metadata';
 import { listArticles } from '../../../../lib/shapio';
-import { stringsFor, toLocale, type Locale } from '../../../../lib/site';
+import { articlePath, stringsFor, toLocale, type Locale } from '../../../../lib/site';
 
 /**
  * Published articles only: a draft's URL is a 404. Articles published after the build render on their first
@@ -21,7 +22,15 @@ const findArticle = async (locale: Locale, slug: string) =>
 export const generateMetadata = async ({ params }: ArticleParams): Promise<Metadata> => {
   const { locale, slug } = await params;
   const article = await findArticle(toLocale(locale), slug);
-  return article ? { title: article.title, description: article.excerpt ?? undefined } : {};
+  return article
+    ? pageMetadata({
+        title: article.title,
+        seo: article.seo,
+        type: 'article',
+        locale: toLocale(locale),
+        path: articlePath(locale, article.slug),
+      })
+    : {};
 };
 
 const ArticlePage = async ({ params }: ArticleParams) => {

package/templates/next/src/app/[locale]/articles/page.tsx

@@ -1,13 +1,15 @@
 import type { Metadata } from 'next';
 import { ArticleCard } from '../../../components/ArticleCard';
+import { pageMetadata } from '../../../lib/metadata';
 import { listArticles } from '../../../lib/shapio';
-import { stringsFor, toLocale } from '../../../lib/site';
+import { articlesPath, stringsFor, toLocale } from '../../../lib/site';
 
 type ArticlesParams = { params: Promise<{ locale: string }> };
 
-export const generateMetadata = async ({ params }: ArticlesParams): Promise<Metadata> => ({
-  title: stringsFor(toLocale((await params).locale)).articles,
-});
+export const generateMetadata = async ({ params }: ArticlesParams): Promise<Metadata> => {
+  const locale = toLocale((await params).locale);
+  return pageMetadata({ title: stringsFor(locale).articles, locale, path: articlesPath(locale) });
+};
 
 const ArticlesPage = async ({ params }: ArticlesParams) => {
   const locale = toLocale((await params).locale);

package/templates/next/src/app/[locale]/colophon/page.tsx

@@ -1,13 +1,15 @@
 import type { Metadata } from 'next';
 import { RichText } from '../../../components/RichText';
+import { pageMetadata } from '../../../lib/metadata';
 import { getSiteSettings } from '../../../lib/shapio';
-import { stringsFor, toLocale } from '../../../lib/site';
+import { colophonPath, stringsFor, toLocale } from '../../../lib/site';
 
 type ColophonParams = { params: Promise<{ locale: string }> };
 
-export const generateMetadata = async ({ params }: ColophonParams): Promise<Metadata> => ({
-  title: stringsFor(toLocale((await params).locale)).colophon,
-});
+export const generateMetadata = async ({ params }: ColophonParams): Promise<Metadata> => {
+  const locale = toLocale((await params).locale);
+  return pageMetadata({ title: stringsFor(locale).colophon, locale, path: colophonPath(locale) });
+};
 
 /** The singleton page: the siteSettings entry's colophon, one per locale. */
 const ColophonPage = async ({ params }: ColophonParams) => {

package/templates/next/src/app/[locale]/layout.tsx

@@ -27,10 +27,14 @@ export const generateStaticParams = () => LOCALES.map((locale) => ({ locale }));
 
 type LocaleParams = { params: Promise<{ locale: string }> };
 
+/**
+ * The fallback title and the icon. Every page sets its own complete title (`title.absolute`, already through
+ * the site's title template from Shapio's SEO defaults), so this layout applies no template of its own.
+ */
 export const generateMetadata = async ({ params }: LocaleParams): Promise<Metadata> => {
   const locale = toLocale((await params).locale);
   const siteName = (await getSiteSettings(locale))?.siteName ?? stringsFor(locale).siteName;
-  return { title: { template: `%s · ${siteName}`, default: siteName }, icons: '/favicon.svg' };
+  return { title: siteName, icons: '/favicon.svg' };
 };
 
 type LocaleLayoutProps = LocaleParams & { children: ReactNode };

package/templates/next/src/app/api/revalidate/route.ts

@@ -1,13 +1,13 @@
 import { webhookSecret } from '../../../lib/config';
 import { log } from '../../../lib/log';
-import { revalidateChanges } from '../../../lib/revalidation';
-import { REVALIDATING_EVENTS } from '../../../lib/revalidationTargets';
+import { revalidateChanges, revalidateEveryPage } from '../../../lib/revalidation';
+import { REVALIDATING_EVENTS, SITE_WIDE_EVENTS } from '../../../lib/revalidationTargets';
 import { readWebhookEvent } from '../../../lib/webhookEvent';
 
 /**
  * POST /api/revalidate/ (with the slash: `trailingSlash` redirects the other form, and Shapio's webhooks do not
  * follow redirects): the target of the Shapio webhook the seed creates (publish, unpublish, delete,
- * change set shipped, schema change). A signed delivery refreshes the pages whose content changed since the
+ * change set shipped, schema change, site settings). A signed delivery refreshes the pages whose content changed since the
  * snapshot the site shows (src/lib/revalidation.ts). A failure answers 500, so Shapio retries the delivery.
  */
 export const POST = async (request: Request) => {
@@ -21,6 +21,9 @@ export const POST = async (request: Request) => {
     return Response.json({ event: event.type, ignored: true });
   }
   try {
+    if (SITE_WIDE_EVENTS.includes(event.type)) {
+      return Response.json({ event: event.type, ...revalidateEveryPage() });
+    }
     return Response.json({ event: event.type, ...(await revalidateChanges()) });
   } catch (error) {
     log(

package/templates/next/src/lib/config.ts

@@ -8,6 +8,8 @@
  * - SHAPIO_WEBHOOK_SECRET: the signing secret of the Shapio webhook that calls /api/revalidate (runtime only;
  *   `npm run seed` writes it).
  * - SHAPIO_SITE: optional; the site key on a multi-site Shapio (default: the token's site, else the primary).
+ * - SITE_URL: optional; this site's public origin, e.g. https://www.example.com. Pages then carry a canonical
+ *   URL (and `og:url`) unless the entry sets its own.
  * - NEXT_PUBLIC_SHAPIO_URL: the Shapio URL the browser calls for previews (defaults to SHAPIO_URL; inlined into
  *   the client bundle at build time).
  */
@@ -30,6 +32,8 @@ export const deliveryToken = () => {
 
 export const siteKey = () => read('SHAPIO_SITE');
 
+export const siteUrl = () => read('SITE_URL');
+
 export const configuredSnapshot = (): number | undefined => {
   // Spelled out (not read(name)): next.config.ts hands the pinned snapshot over through Next's `env`, which
   // replaces this exact expression at build time.