create-ginko 0.4.0 → 0.6.0

package/templates/starter/content/pages/1.about.de.md

@@ -0,0 +1,20 @@
+---
+title: Über mich
+slug: ueber-mich
+summary: Klara Brenner, Übersetzerin für Deutsch und Englisch seit 2014.
+---
+
+## Wer ich bin
+
+Ich bin in Freiburg und Edinburgh aufgewachsen und übersetze seit 2014 zwischen Deutsch und Englisch. Davor war ich
+sechs Jahre Lektorin in einem Kunstbuchverlag.
+
+## Woran ich arbeite
+
+Die meisten Aufträge kommen von Museen und Forschungsinstituten: Wandtexte, Kataloge, Fachartikel und Berichte.
+Jeden Text, der in Druck geht, liest nach mir ein muttersprachliches Korrektorat.
+
+## Zusammenarbeit
+
+Schreiben Sie mir mit dem Text, dem Termin und dem Ort, an dem er erscheint. Ich antworte auf jede Anfrage
+innerhalb von zwei Werktagen.

package/templates/starter/content/pages/1.about.md

@@ -0,0 +1,18 @@
+---
+title: About
+summary: Klara Brenner, translator for German and English since 2014.
+---
+
+## Who I am
+
+I grew up in Freiburg and Edinburgh and have translated between German and English since 2014. Before that I
+worked for six years as an editor at an art book publisher.
+
+## What I work on
+
+Most of my work comes from museums and research institutes: wall texts, catalogues, papers and reports. For every
+text that goes to print, a native-speaker proofreader reads it after me.
+
+## Working together
+
+Write to me with the text, the deadline and where it will appear. I answer every request within two working days.

package/templates/starter/content/pages/2.contact.de.md

@@ -0,0 +1,17 @@
+---
+# Die Kontaktdaten über dem Text kommen aus content/site.md, die auch Fußzeile und Impressum füllt; ändern Sie sie dort,
+# einmal. Diese Website hat kein Kontaktformular und schickt deshalb keine Daten an andere Unternehmen. Für ein
+# Formular siehe die README.
+title: Kontakt
+slug: kontakt
+summary: "Schreiben oder anrufen: Ich antworte innerhalb von zwei Werktagen."
+---
+
+## Was Sie mir schicken
+
+Den Text oder eine Probeseite, den Termin und den Ort, an dem die Übersetzung erscheint. Für ein Buch genügt für
+einen ersten Preis die Seitenzahl.
+
+## Telefonzeiten
+
+Montag bis Donnerstag, 9 bis 16 Uhr. Außerhalb dieser Zeiten rufe ich am nächsten Werktag zurück.

package/templates/starter/content/pages/2.contact.md

@@ -0,0 +1,15 @@
+---
+# The contact details above the text come from content/site.md, which also fills the footer and the imprint; change
+# them there, once. This site has no contact form, so it sends no data to other companies. To add a form, see the README.
+title: Contact
+summary: "Write or call: I answer within two working days."
+---
+
+## What to send
+
+The text or a sample page, the deadline, and where the translation will appear. For a book, the number of pages
+is enough for a first price.
+
+## Phone hours
+
+Monday to Thursday, 9:00 to 16:00. Outside these hours I call back on the next working day.

package/templates/starter/content/site.md

@@ -0,0 +1,12 @@
+---
+# This file fills the contact details in the header and footer, the imprint and the data for search engines.
+# Header and footer: email and phone.
+email: hallo@klarabrenner.example
+phone: '+49 761 0123 4567'
+# Imprint and search engines: name and address. Register and VAT fields (registryCourt, registryNumber, vatId) are optional;
+# add them here when they apply to you.
+legalName: Klara Brenner
+street: Mühlbachhof 4
+postalCode: '79098'
+city: Freiburg im Breisgau
+---

package/templates/starter/eslint.config.mjs

@@ -0,0 +1,12 @@
+// @ts-check
+import withNuxt from './.nuxt/eslint.config.mjs'
+import { tailwindClassesConfig } from './eslint.tailwind.mjs'
+
+export default withNuxt(
+  {
+    // An optional TypeScript prop is `undefined` when not passed; a default for each would only repeat that.
+    rules: { 'vue/require-default-prop': 'off' },
+  },
+  // A class Tailwind does not know is an error (tokens.css removes the default palette, scale, radii and shadows).
+  tailwindClassesConfig,
+)

package/templates/starter/eslint.tailwind.mjs

@@ -0,0 +1,33 @@
+// Synced from templates/_features/ui/eslint.tailwind.mjs by `pnpm templates sync`. Edit the source, not this copy.
+// @ts-check
+// Lint rule shared by every template: a class Tailwind does not know is an error.
+// tokens.css switches off Tailwind's default palette, type scale, radii and shadows, so a class such as `text-sm`,
+// `shadow-lg` or `bg-red-500` generates no CSS and does nothing. Without this rule that mistake is silent.
+// Tailwind reads the template's CSS entry (the same file the build uses), so a new token is known at once.
+import betterTailwind from 'eslint-plugin-better-tailwindcss'
+
+/**
+ * Classes that are not Tailwind on purpose. Each one is a hook for a stylesheet, a script or the print layout.
+ * The plugin treats every entry as an unanchored regular expression, so each one must be anchored (`^name$`):
+ * a bare 'dark' would also skip `dark:bg-red-500`. Keep this list short; never add a real pattern.
+ */
+const allowedClasses = [
+  // Plain CSS classes written in tokens.css (not Tailwind utilities).
+  '^prose$', // ProseBody: the reading column and the styles for rendered Markdown
+  '^surface-primary$', // BlockCta: a band in the accent colour that swaps text, buttons and focus ring
+  // Not a style at all: the colour-mode class. Tailwind's `dark:` variant reads it, so the lightbox sets it on
+  // itself to stay dark in light mode.
+  '^dark$',
+]
+
+export const tailwindClassesConfig = {
+  name: 'ginko/unknown-tailwind-classes',
+  files: ['app/**/*.vue', 'app/**/*.ts'],
+  plugins: { 'better-tailwindcss': betterTailwind },
+  settings: {
+    'better-tailwindcss': { entryPoint: 'app/assets/css/main.css' },
+  },
+  rules: {
+    'better-tailwindcss/no-unknown-classes': ['error', { ignore: allowedClasses }],
+  },
+}

package/templates/starter/ginko.config.ts

@@ -0,0 +1,42 @@
+// Starter template: a neutral site with free pages, notices, legal texts and contact details, in English and German.
+// Every brick reads Markdown from content/ (source: 'files'), so the site runs without an account.
+// To let editors change a brick in Ginko Studio later, remove `source: 'files'` from it (README, "Move to the Studio").
+import { defineSite, f, single } from '@lupinum/ginko'
+import { legal, notices, site } from '@lupinum/ginko/basics'
+import { pages } from './app/bricks/pages.ts'
+import { locales, localized } from './app/routes.ts'
+import { siteUrl } from './site-url.ts'
+
+export default defineSite({
+  site: 'starter',
+  name: 'Klara Brenner',
+  // `color` fills the share cards: the light `--brand` of app/assets/css/main.css.
+  seo: { description: 'A new website, built with Ginko.', color: '#18181b' },
+  url: siteUrl('https://example.com'),
+  timeZone: 'Europe/Berlin',
+  locales,
+  currency: 'EUR',
+  pages: {
+    home: localized('/'),
+  },
+  bricks: {
+    // The home page: title, lead and a short text (content/home.md).
+    home: single({
+      label: { de: 'Startseite', en: 'Home page', fr: 'Page d’accueil' },
+      source: 'files',
+      fields: {
+        title: f.text({ de: 'Titel', en: 'Title', fr: 'Titre' }, { max: 80, default: 'Welcome' }),
+        lead: f.longtext({ de: 'Einleitung', en: 'Lead', fr: 'Introduction' }, { max: 300, default: 'A short introduction: who you are and what you offer.' }),
+        body: f.markdown({ de: 'Text', en: 'Text', fr: 'Texte' }, { profile: 'page', optional: true }),
+      },
+    }),
+    // About, Contact and any other page: content/pages/.
+    pages: pages({ route: localized('/[slug]'), source: 'files' }),
+    // Short notices above the header, each until a date (content/notices/).
+    notices: notices({ source: 'files' }),
+    // Name, address and contact for the footer and search engines (content/site.md).
+    site: site({ source: 'files' }),
+    // Privacy policy, terms and imprint at /legal/<slug> (content/legal/).
+    legal: legal({ route: localized('/legal/[slug]'), source: 'files' }),
+  },
+})

package/templates/starter/gitignore

@@ -0,0 +1,7 @@
+node_modules
+.nuxt
+.output
+.data
+dist
+.env
+*.log

package/templates/starter/i18n/de.json

@@ -0,0 +1,6 @@
+{
+  "home": {
+    "more": "Mehr erfahren",
+    "empty": "Noch keine Seiten"
+  }
+}

package/templates/starter/i18n/en.json

@@ -0,0 +1,6 @@
+{
+  "home": {
+    "more": "Find out more",
+    "empty": "No pages yet"
+  }
+}

package/templates/starter/i18n/site/de.json

@@ -0,0 +1,39 @@
+{
+  "skip": "Zum Inhalt springen",
+  "home": "Startseite",
+  "nav": {
+    "label": "Hauptnavigation",
+    "open": "Navigation öffnen",
+    "title": "Navigation"
+  },
+  "close": "Schließen",
+  "theme": "Dunkles Design",
+  "language": {
+    "label": "Sprache",
+    "untranslated": "{language}: Diese Seite ist nicht übersetzt, zur Startseite"
+  },
+  "footer": {
+    "pages": "Seiten",
+    "contact": "Kontakt",
+    "legal": "Rechtliches",
+    "links": "Anderswo"
+  },
+  "notice": "Hinweis",
+  "updated": "Stand: {date}",
+  "empty": "Legen Sie eine Datei in <code>{path}</code> an.",
+  "error": {
+    "code": "Fehler {code}",
+    "notFound": "Seite nicht gefunden",
+    "notFoundText": "Vielleicht ist die Adresse falsch geschrieben, oder die Seite wurde verschoben.",
+    "failed": "Etwas ist schiefgelaufen",
+    "failedText": "Bitte laden Sie die Seite neu. Wenn der Fehler bleibt, versuchen Sie es später noch einmal.",
+    "home": "Zur Startseite"
+  },
+  "imprint": {
+    "address": "Anschrift",
+    "registry": "Registereintrag",
+    "vat": "Umsatzsteuer-ID",
+    "email": "E-Mail",
+    "phone": "Telefon"
+  }
+}

package/templates/starter/i18n/site/en.json

@@ -0,0 +1,39 @@
+{
+  "skip": "Skip to content",
+  "home": "Home",
+  "nav": {
+    "label": "Main",
+    "open": "Open navigation",
+    "title": "Navigation"
+  },
+  "close": "Close",
+  "theme": "Dark mode",
+  "language": {
+    "label": "Language",
+    "untranslated": "{language}: this page is not translated, go to the home page"
+  },
+  "footer": {
+    "pages": "Pages",
+    "contact": "Contact",
+    "legal": "Legal",
+    "links": "Elsewhere"
+  },
+  "notice": "Notice",
+  "updated": "Last updated {date}",
+  "empty": "Add a file to <code>{path}</code>.",
+  "error": {
+    "code": "Error {code}",
+    "notFound": "Page not found",
+    "notFoundText": "The address may be mistyped, or the page has moved.",
+    "failed": "Something went wrong",
+    "failedText": "Please reload the page. If the error stays, try again later.",
+    "home": "Go to the home page"
+  },
+  "imprint": {
+    "address": "Address",
+    "registry": "Register",
+    "vat": "VAT number",
+    "email": "Email",
+    "phone": "Phone"
+  }
+}

package/templates/starter/modules/feature-messages.ts

@@ -0,0 +1,19 @@
+// Synced from templates/_features/site/modules/feature-messages.ts by `pnpm templates sync`. Edit the source, not this copy.
+import { readdirSync, statSync } from 'node:fs'
+import type {} from '@lupinum/ginko-i18n'
+import { createResolver, defineNuxtModule } from 'nuxt/kit'
+
+// The texts of the shared components: each folder in i18n/ (i18n/site/en.json, …) is read under its folder name, so
+// `useI18n('site')` finds them. The site's own i18n/<code>.json still wins per key, so a text is changed there, not
+// in the shared files. Files of a language the site does not have are ignored.
+export default defineNuxtModule({
+  meta: { name: 'feature-messages' },
+  setup(_options, nuxt) {
+    const { resolve } = createResolver(nuxt.options.rootDir)
+    const root = resolve('i18n')
+    const folders = readdirSync(root).filter((name) => statSync(resolve('i18n', name)).isDirectory())
+    nuxt.hook('ginko-i18n:sources', (sources) => {
+      for (const namespace of folders) sources.push({ namespace, dir: resolve('i18n', namespace) })
+    })
+  },
+})

package/templates/starter/modules/feeds/index.ts

@@ -0,0 +1,22 @@
+// Synced from templates/_features/site/modules/feeds/index.ts by `pnpm templates sync`. Edit the source, not this copy.
+import { existsSync, readdirSync } from 'node:fs'
+import { defineNuxtModule } from 'nuxt/kit'
+import { feedRoutes } from './routes.ts'
+
+// `nuxt generate` writes the pages it finds by following links, but a feed is no page: the crawler skips `.xml` links.
+// So static files get the RSS feeds of the features (`server/middleware/<page key>-feed.ts`, rules in ./routes.ts)
+// only when they are listed. A server build (`nuxt build`) answers the feeds at request time and is left as it is.
+export default defineNuxtModule({
+  meta: { name: 'feeds' },
+  setup(_options, nuxt) {
+    const pages = (nuxt.options as { ginko?: { pages?: Record<string, Record<string, string>> } }).ginko?.pages
+    const dir = `${nuxt.options.rootDir}/server/middleware`
+    if (!pages || !existsSync(dir)) return
+    const routes = feedRoutes(readdirSync(dir), pages)
+    if (!routes.length) return
+    nuxt.hook('nitro:config', (nitro) => {
+      if (!nitro.static) return
+      nitro.prerender = { ...nitro.prerender, routes: [...(nitro.prerender?.routes ?? []), ...routes] }
+    })
+  },
+})

package/templates/starter/modules/feeds/routes.ts

@@ -0,0 +1,13 @@
+// Synced from templates/_features/site/modules/feeds/routes.ts by `pnpm templates sync`. Edit the source, not this copy.
+/**
+ * The feed addresses a static build must list: `<page>/rss.xml` in every language for each feed the template has. A
+ * feed is a file `server/middleware/<page key>-feed.ts` (the blog's `news-feed.ts`, the changelog's
+ * `changelog-feed.ts`) whose page key is in `pages` of ginko.config.ts; a feed without its page has no address.
+ */
+export function feedRoutes(middleware: readonly string[], pages: Record<string, Record<string, string>>): string[] {
+  return middleware.flatMap((file) => {
+    const key = /^(.+)-feed\.ts$/.exec(file)?.[1]
+    const paths = key && Object.hasOwn(pages, key) ? pages[key] : undefined
+    return paths ? Object.values(paths).map((path) => `${path.replace(/\/$/, '')}/rss.xml`) : []
+  })
+}

package/templates/starter/modules/page-paths/index.ts

@@ -0,0 +1,26 @@
+// Synced from templates/_features/site/modules/page-paths/index.ts by `pnpm templates sync`. Edit the source, not this copy.
+import { defineNuxtModule, tryImportModule } from 'nuxt/kit'
+import { pagePaths, toConfig, toNuxt, type Segments, type SiteConfig } from './paths.ts'
+
+// Gives each Vue page of app/pages/ its address per language (rules in ./paths.ts) as `definePageMeta({ i18n: { paths } })`
+// would, so the page files of the shared features stay the same in every template.
+export default defineNuxtModule({
+  meta: { name: 'page-paths' },
+  async setup(_options, nuxt) {
+    const site = (nuxt.options as { ginko?: SiteConfig }).ginko
+    if (!site?.locales.length) return
+    // The words of app/routes.ts (a template without `segments` has none).
+    const routes = await tryImportModule<{ segments?: Segments }>(`${nuxt.options.srcDir}/routes.ts`)
+    const segments = routes?.segments ?? {}
+
+    nuxt.hook('pages:extend', (pages) => {
+      for (const page of pages) {
+        if (page.meta?.i18n !== undefined) continue
+        const file = toConfig(page.path)
+        const paths = pagePaths(site, segments, file)
+        if (!paths || Object.values(paths).every((path) => path === file)) continue
+        page.meta = { ...page.meta, i18n: { paths: Object.fromEntries(Object.entries(paths).map(([locale, path]) => [locale, toNuxt(path)])) } }
+      }
+    })
+  },
+})

package/templates/starter/modules/page-paths/paths.ts

@@ -0,0 +1,48 @@
+// Synced from templates/_features/site/modules/page-paths/paths.ts by `pnpm templates sync`. Edit the source, not this copy.
+// The address of each Vue page in every language, from ginko.config.ts, so a page and its links never disagree.
+// A page in app/pages/ answers at its file path in the main language (`news/index.vue` at /news) and with the language
+// prefix in the others (/de/news). When ginko.config.ts gives that page other words per language (`pages.news` is
+// `/de/aktuelles` in German, or the legal route `/de/rechtliches/[slug]`), the page answers there instead:
+//   1. a path of `pages` or of a brick `route` that is the file path in one of the languages: its paths in all of them;
+//   2. else a key of `pages` named like the file's first folder (`news/[slug].vue` and `pages.news`): that page's path
+//      per language, followed by the rest of the file path (`/de/aktuelles/[slug]`). A part of that rest that
+//      `segments` in app/routes.ts has a word for is translated too (`menu/print.vue`: `/de/speisekarte/drucken`),
+//      so a nested page can have its own word without a `pages` key (a key puts the page into the sitemap).
+// So a feature page keeps its file name in every template, and a template renames it in ginko.config.ts alone
+// (app/routes.ts). A page whose definePageMeta sets `i18n` keeps its own paths.
+// This file is the pure part (unit tested); index.ts is the Nuxt module.
+
+type PathMap = Record<string, string | undefined>
+/** `segments` of app/routes.ts: the word of a path part per language. */
+export type Segments = Record<string, Record<string, string | undefined> | undefined>
+export interface SiteConfig { locales: readonly string[], pages?: Record<string, PathMap>, bricks?: Record<string, { route?: PathMap }> }
+
+/** `/news/:slug()` (Nuxt) ↔ `/news/[slug]` (ginko.config.ts). */
+export const toConfig = (path: string) => path.replace(/:(\w+)\(\)/g, '[$1]')
+export const toNuxt = (path: string) => path.replace(/\[(\w+)\]/g, ':$1()')
+
+/**
+ * The path of a page file (`/menu/print`, `/news/[slug]`) per language without the language prefix, or undefined when
+ * ginko.config.ts and `segments` give it none (the page then answers at its file path).
+ */
+export function pagePaths(site: SiteConfig, segments: Segments, file: string): Record<string, string> | undefined {
+  const [main] = site.locales
+  /** A configured path without its language prefix: `/de/aktuelles` → `/aktuelles`. */
+  const bare = (locale: string, path: string) => {
+    if (locale === main) return path
+    if (path === `/${locale}`) return '/'
+    return path.startsWith(`/${locale}/`) ? path.slice(locale.length + 1) : path
+  }
+  const maps = [...Object.values(site.pages ?? {}), ...Object.values(site.bricks ?? {}).flatMap((brick) => (brick.route ? [brick.route] : []))]
+  const exact = maps.find((map) => site.locales.some((locale) => map[locale] !== undefined && bare(locale, map[locale]!) === file))
+  if (exact) return Object.fromEntries(site.locales.flatMap((locale) => (exact[locale] ? [[locale, bare(locale, exact[locale]!)]] : [])))
+  const [, key, ...rest] = file.split('/')
+  const page = key ? site.pages?.[key] : undefined
+  if (!page) return undefined
+  return Object.fromEntries(site.locales.flatMap((locale) => {
+    const base = page[locale] === undefined ? undefined : bare(locale, page[locale]!)
+    if (base === undefined) return []
+    const tail = rest.map((part) => `/${segments[part]?.[locale] ?? part}`).join('')
+    return [[locale, `${base === '/' ? '' : base}${tail}` || '/']]
+  }))
+}

package/templates/starter/nuxt.config.ts

@@ -0,0 +1,27 @@
+import tailwindcss from '@tailwindcss/vite'
+import ginko from './ginko.config.ts'
+import { checkSiteUrl } from './site-url.ts'
+
+export default defineNuxtConfig({
+  compatibilityDate: '2026-10-01',
+  modules: [
+    '@lupinum/ginko/nuxt',
+    '@nuxt/eslint',
+    '@nuxt/fonts',
+    '@nuxtjs/color-mode',
+    'nuxt-og-image',
+    'shadcn-nuxt',
+  ],
+  ginko,
+  css: ['~/assets/css/main.css'],
+  // Light and dark follow the visitor's system until they pick one with the toggle; `.dark` on <html>.
+  colorMode: { classSuffix: '', preference: 'system', fallback: 'light', storageKey: 'color-mode' },
+  // Fonts are downloaded at build time and served from the site itself: no request to Google from the visitor.
+  // The families are chosen in main.css (`--font-body`, `--font-heading`).
+  fonts: { defaults: { weights: ['400 700'], styles: ['normal'], subsets: ['latin', 'latin-ext'] } },
+  shadcn: { prefix: '', componentDir: './app/components/ui' },
+  hooks: {
+    'build:before': () => checkSiteUrl(ginko.url),
+  },
+  vite: { plugins: [tailwindcss()] },
+})

package/templates/starter/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "starter",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "nuxt dev",
+    "check": "ginko check",
+    "build": "nuxt build",
+    "generate": "nuxt generate",
+    "preview": "nuxt preview",
+    "lint": "eslint .",
+    "typecheck": "nuxt typecheck",
+    "postinstall": "nuxt prepare"
+  },
+  "dependencies": {
+    "@lucide/vue": "^1.57.0",
+    "@lupinum/ginko": "^0.5.0",
+    "@lupinum/ginko-content": "^0.5.0",
+    "@lupinum/ginko-i18n": "^0.5.0",
+    "@nuxt/fonts": "^1.0.1",
+    "@nuxtjs/color-mode": "^4.0.1",
+    "@takumi-rs/core": "^2.15.1",
+    "@vueuse/core": "^15.0.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "nuxt": "^4.6.1",
+    "nuxt-og-image": "^7.0.3",
+    "reka-ui": "^2.11.0",
+    "shadcn-nuxt": "^2.8.2",
+    "tailwind-merge": "^3.7.0",
+    "vue": "^3.5.43"
+  },
+  "devDependencies": {
+    "@nuxt/eslint": "^1.17.0",
+    "@tailwindcss/vite": "^4.3.3",
+    "@types/node": "^24.0.0",
+    "eslint": "^10.12.0",
+    "eslint-plugin-better-tailwindcss": "^4.9.1",
+    "tailwindcss": "^4.3.3",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^6.0.3",
+    "vue-tsc": "^3.3.13"
+  },
+  "engines": {
+    "node": "^22.22.3 || ^24.15.0 || >=26"
+  },
+  "ginko": {
+    "sampleAnchor": "2026-10-15",
+    "features": [
+      "ui",
+      "site",
+      "pages"
+    ]
+  }
+}

package/templates/starter/pnpm-workspace.yaml

@@ -0,0 +1,6 @@
+# pnpm only: packages whose install scripts may run. pnpm 11 stops `pnpm install` on any other install script.
+# npm ignores this file.
+allowBuilds:
+  esbuild: true
+  # @nuxt/eslint's import resolver: its install script only checks for a prebuilt binary.
+  unrs-resolver: false

package/templates/starter/server/plugins/font-preload.ts

@@ -0,0 +1,17 @@
+// Synced from templates/_features/site/server/plugins/font-preload.ts by `pnpm templates sync`. Edit the source, not this copy.
+import { useServerHooks } from 'nuxt/server'
+
+// Preloads the basic Latin file of each web font (@nuxt/fonts writes its @font-face rules into the page's head), so
+// the browser fetches it with the page instead of after the stylesheet and the scripts. Text set in the fallback
+// re-wraps when the font arrives late, and a heading that gains a line pushes the page down (layout shift). @nuxt/fonts'
+// own `preload` option puts the file into the build manifest, but the server renders no link for it.
+const FACE = /@font-face\s*\{[^}]*\}/g
+const LATIN = /unicode-range:\s*U\+(?:\?\?|0-FF)(?=[,;}])/i
+const WOFF2 = /url\(\s*["']?([^"')]+\.woff2)["']?\s*\)/
+
+export default () => {
+  useServerHooks().hook('render:html', (html) => {
+    const urls = new Set((html.head.join('').match(FACE) ?? []).filter((face) => LATIN.test(face)).flatMap((face) => WOFF2.exec(face)?.[1] ?? []))
+    if (urls.size) html.head.unshift([...urls].map((url) => `<link rel="preload" as="font" type="font/woff2" href="${url}" crossorigin>`).join(''))
+  })
+}

package/templates/starter/site-url.ts

@@ -0,0 +1,21 @@
+// Synced from templates/_features/site/site-url.ts by `pnpm templates sync`. Edit the source, not this copy.
+// The site's public address (TEMPLATES T12), read once by ginko.config.ts: NUXT_PUBLIC_SITE_URL, else the production
+// address Vercel sets (VERCEL_PROJECT_PRODUCTION_URL), else `fallback` from ginko.config.ts. Canonical links, the
+// sitemap and share cards start with it, so a Vercel deploy with the example address must not happen.
+
+/** The address to use, without a trailing slash. */
+export function siteUrl(fallback: string): string {
+  const env = process.env.NUXT_PUBLIC_SITE_URL || (process.env.VERCEL_PROJECT_PRODUCTION_URL ? `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}` : '')
+  return (env || fallback).replace(/\/+$/, '')
+}
+
+/**
+ * Stops a Vercel build that would still use an example.com address and names the variable to set. Any other build
+ * (CI, a local build, another host) only prints a warning, so a fresh copy of the template builds as it is.
+ */
+export function checkSiteUrl(url: string): void {
+  if (!/^https?:\/\/([^/]+\.)?example\.com(\/|$)/.test(url)) return
+  const message = `The site address is still ${url}. Set NUXT_PUBLIC_SITE_URL to the address of the live site (for example https://www.my-site.com) in the build environment, or change \`url\` in ginko.config.ts.`
+  if (process.env.VERCEL) throw new Error(message)
+  console.warn(`Warning: ${message} Canonical links, the sitemap and share cards use this address.`)
+}

package/templates/starter/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./.nuxt/tsconfig.app.json" },
+    { "path": "./.nuxt/tsconfig.server.json" },
+    { "path": "./.nuxt/tsconfig.shared.json" },
+    { "path": "./.nuxt/tsconfig.node.json" }
+  ]
+}

package/templates/starter.json

@@ -0,0 +1,11 @@
+{
+  "locales": [
+    "en",
+    "de"
+  ],
+  "shift": {
+    "notices": [
+      "until"
+    ]
+  }
+}