create-ginko 0.4.0 → 0.6.0

package/templates/local-business/ginko.config.ts

@@ -0,0 +1,98 @@
+// Local business template: a physiotherapy practice in Graz with its opening hours (closures, public holidays, hours
+// from a date), treatments with price and duration, the therapists, questions and answers, photos of the practice and
+// how to book and find it, in English (main) and German. Every brick reads Markdown from content/ (source: 'files'),
+// so the site runs without an account. To let the practice 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 { faq, gallery, hourPlans, hours, legal, notices, people, site } from '@lupinum/ginko/basics'
+import { pages } from './app/bricks/pages.ts'
+import { services } from './app/bricks/services.ts'
+import { locales, localized } from './app/routes.ts'
+import { siteUrl } from './site-url.ts'
+
+export default defineSite({
+  site: 'local-business',
+  name: 'Hofer Physio',
+  // `color` fills the share cards: the light `--brand` of app/assets/css/main.css.
+  seo: {
+    description: 'Hofer Physio is a physiotherapy practice in Graz: physiotherapy, manual therapy, sports physiotherapy, lymphatic drainage and massage, by appointment.',
+    color: '#0f766e',
+  },
+  url: siteUrl('https://example.com'),
+  timeZone: 'Europe/Vienna',
+  // Austrian public holidays count for the opening hours (stored as `holidays: 'AT'`), and JSON-LD names Austria.
+  country: 'AT',
+  locales,
+  languages: { en: 'en-GB', de: 'de-AT' },
+  // Prices of the treatments.
+  currency: 'EUR',
+  pages: {
+    home: localized('/'),
+    services: localized('/services'),
+    team: localized('/team'),
+    faq: localized('/faq'),
+    contact: localized('/contact'),
+  },
+  bricks: {
+    // In the order of the Studio's Today page: the hours, the notices, the treatments and the team first.
+    // The usual week, closures such as the Christmas break, and closed on public holidays (content/hours.md). In the
+    // Studio, Today shows today's hours, and "Closed today" is one task.
+    hours: hours({ source: 'files', plans: 'hourPlans' }),
+    // Short lines at the top of every page ("The courtyard is closed for building work"), each until a date
+    // (content/notices/).
+    notices: notices({ source: 'files' }),
+    // Treatments with their price (or "on request", as an explicit choice) and duration (content/services/).
+    services: services({ source: 'files', route: localized('/services/[slug]') }),
+    // The therapists and the front desk, with their qualifications (content/people/). No photos: the site shows initials.
+    people: people({ source: 'files' }),
+    // Other weekly hours for a date range, such as shorter summer hours that repeat every year (content/hourPlans/).
+    hourPlans: hourPlans({ source: 'files' }),
+    // How to book and how to get here (content/visit.md): when the phone is answered, an online booking page if the
+    // practice uses one, and access, parking and public transport. The contact page and the home page show it; the
+    // address, phone and email come from content/site.md.
+    visit: single({
+      label: { de: 'Termine und Anfahrt', en: 'Appointments and directions' },
+      source: 'files',
+      fields: {
+        phoneHours: f.text({ de: 'Telefonisch erreichbar', en: 'Phone hours' }, {
+          max: 80,
+          default: 'Mon–Fri 8:00–12:00',
+          hint: { de: 'Kurz, zum Beispiel „Mo–Fr 08:00–12:00“.', en: 'Short, for example “Mon–Fri 08:00–12:00”.' },
+        }),
+        bookingUrl: f.text({ de: 'Online-Terminbuchung', en: 'Online booking' }, {
+          format: 'url',
+          optional: true,
+          hint: { de: 'Die Adresse Ihrer Buchungsseite, falls Sie eine nutzen. Leer: Termine per Telefon und E-Mail.', en: 'The address of your booking page, if you use one. Empty: appointments by phone and email.' },
+        }),
+        access: f.longtext({ de: 'Barrierefreiheit', en: 'Access' }, { max: 300, optional: true }),
+        parking: f.longtext({ de: 'Parken', en: 'Parking' }, { max: 300, optional: true }),
+        transit: f.longtext({ de: 'Öffentliche Verkehrsmittel', en: 'Public transport' }, { max: 300, optional: true }),
+      },
+      tasks: [
+        { id: 'phone', kind: 'edit', fields: ['phoneHours', 'bookingUrl'], label: { de: 'Telefonzeiten ändern', en: 'Change the phone hours' } },
+        { id: 'directions', kind: 'edit', fields: ['access', 'parking', 'transit'], label: { de: 'Anfahrt ändern', en: 'Change the directions' } },
+      ],
+    }),
+    // Questions and answers: prescription and insurance, what to bring, cancelling (content/faq/).
+    faq: faq({ source: 'files' }),
+    // Photos of the practice on the contact page (content/gallery.md).
+    gallery: gallery({ source: 'files' }),
+    // The first screen of the home page: the practice's name, one line about it and an optional photo (content/home.md).
+    home: single({
+      label: { de: 'Startseite', en: 'Home page' },
+      source: 'files',
+      fields: {
+        title: f.text({ de: 'Titel', en: 'Title' }, { max: 80, default: 'Welcome' }),
+        lead: f.longtext({ de: 'Einleitung', en: 'Lead' }, { max: 200, default: 'A short introduction: who you are and what you offer.' }),
+        image: f.image({ de: 'Foto', en: 'Photo' }, { optional: true }),
+      },
+    }),
+    // About the practice and any other page (content/pages/).
+    pages: pages({ route: localized('/[slug]'), source: 'files' }),
+    // Legal name, address, phone and email for the footer, the imprint, the call and email buttons and the
+    // Physiotherapy JSON-LD (content/site.md). The country comes from `country` above.
+    site: site({ source: 'files' }),
+    // Privacy policy, payment and cancellation terms, imprint: one file per text in content/legal/.
+    legal: legal({ source: 'files', route: localized('/legal/[slug]') }),
+  },
+})

package/templates/local-business/gitignore

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

package/templates/local-business/i18n/de.json

@@ -0,0 +1,49 @@
+{
+  "home": {
+    "title": "Physiotherapie in Graz",
+    "prices": "Behandlungen und Preise",
+    "pricesLead": "Preise pro Einheit. Mit ärztlicher Verordnung erstattet Ihre Krankenkasse einen Teil davon.",
+    "allTreatments": "Alle Behandlungen",
+    "team": "Unser Team",
+    "allTeam": "Das ganze Team",
+    "visit": "Öffnungszeiten und Adresse",
+    "hours": "Öffnungszeiten",
+    "address": "Adresse",
+    "directions": "Parken und öffentliche Anreise",
+    "questions": "Fragen",
+    "allQuestions": "Alle Fragen"
+  },
+  "visit": {
+    "call": "{phone} anrufen",
+    "phoneHours": "Telefonisch erreichbar:",
+    "maps": "In Karten öffnen",
+    "email": "E-Mail schreiben",
+    "bookOnline": "Online buchen",
+    "access": "Barrierefreiheit",
+    "parking": "Parken",
+    "transit": "Öffentliche Verkehrsmittel",
+    "treatedBy": "Es behandelt Sie"
+  },
+  "contact": {
+    "title": "Kontakt",
+    "lead": "Wie Sie einen Termin vereinbaren, wann wir geöffnet haben und wie Sie zur Praxis finden.",
+    "hours": "Öffnungszeiten",
+    "directions": "Adresse und Anfahrt",
+    "practice": "Die Praxis"
+  },
+  "faq": {
+    "title": "Häufige Fragen",
+    "lead": "Zu Verordnung und Krankenkasse, zum ersten Termin und was passiert, wenn Sie nicht kommen können.",
+    "empty": "Noch keine Fragen"
+  },
+  "services": {
+    "title": "Behandlungen",
+    "lead": "Preise pro Einheit. Wir sind eine Wahlpraxis: Mit ärztlicher Verordnung erstattet Ihre Krankenkasse einen Teil des Preises.",
+    "all": "Alle Behandlungen",
+    "empty": "Noch keine Behandlungen",
+    "bookSubject": "Terminanfrage: {title}"
+  },
+  "people": {
+    "lead": "Die Physiotherapeutinnen und Physiotherapeuten, die Sie behandeln, und wer Ihren Anruf entgegennimmt."
+  }
+}

package/templates/local-business/i18n/en.json

@@ -0,0 +1,49 @@
+{
+  "home": {
+    "title": "Physiotherapy in Graz",
+    "prices": "Treatments and prices",
+    "pricesLead": "Prices per session. With a doctor’s prescription, your health insurance refunds part of them.",
+    "allTreatments": "All treatments",
+    "team": "Our team",
+    "allTeam": "The whole team",
+    "visit": "Opening hours and address",
+    "hours": "Opening hours",
+    "address": "Address",
+    "directions": "Parking and public transport",
+    "questions": "Questions",
+    "allQuestions": "All questions"
+  },
+  "visit": {
+    "call": "Call {phone}",
+    "phoneHours": "Phone hours:",
+    "maps": "Open in maps",
+    "email": "Send an email",
+    "bookOnline": "Book online",
+    "access": "Access",
+    "parking": "Parking",
+    "transit": "Public transport",
+    "treatedBy": "Treated by"
+  },
+  "contact": {
+    "title": "Contact",
+    "lead": "How to book an appointment, when we are open and how to find the practice.",
+    "hours": "Opening hours",
+    "directions": "Address and directions",
+    "practice": "The practice"
+  },
+  "faq": {
+    "title": "FAQ",
+    "lead": "About prescriptions and health insurance, your first appointment, and what happens if you cannot come.",
+    "empty": "No questions yet"
+  },
+  "services": {
+    "title": "Treatments",
+    "lead": "Prices per session. We are a private practice: with a doctor’s prescription, your health insurance refunds part of the price.",
+    "all": "All treatments",
+    "empty": "No treatments yet",
+    "bookSubject": "Appointment request: {title}"
+  },
+  "people": {
+    "lead": "The physiotherapists who treat you, and who answers the phone."
+  }
+}

package/templates/local-business/i18n/faq/de.json

@@ -0,0 +1,6 @@
+{
+  "title": "Häufige Fragen",
+  "lead": "Antworten auf die Fragen, die wir am häufigsten hören.",
+  "empty": "Noch keine Fragen",
+  "more": "Ihre Frage ist nicht dabei? Schreiben Sie uns oder rufen Sie an:"
+}

package/templates/local-business/i18n/faq/en.json

@@ -0,0 +1,6 @@
+{
+  "title": "Questions and answers",
+  "lead": "Answers to the questions we are asked most often.",
+  "empty": "No questions yet",
+  "more": "Question not answered? Write to us or call us:"
+}

package/templates/local-business/i18n/gallery/de.json

@@ -0,0 +1,8 @@
+{
+  "title": "Fotoansicht",
+  "open": "Foto {n} von {count}: {alt}",
+  "previous": "Voriges Foto",
+  "next": "Nächstes Foto",
+  "counter": "{n} / {count}",
+  "close": "Schließen"
+}

package/templates/local-business/i18n/gallery/en.json

@@ -0,0 +1,8 @@
+{
+  "title": "Photo viewer",
+  "open": "Photo {n} of {count}: {alt}",
+  "previous": "Previous photo",
+  "next": "Next photo",
+  "counter": "{n} / {count}",
+  "close": "Close"
+}

package/templates/local-business/i18n/hours/de.json

@@ -0,0 +1,27 @@
+{
+  "title": "Öffnungszeiten",
+  "today": "Heute",
+  "todayTimes": "Heute {times}",
+  "closed": "Geschlossen",
+  "and": "und",
+  "now": {
+    "open": "Jetzt geöffnet",
+    "until": "bis {time}",
+    "later": "Heute ab {time} geöffnet",
+    "again": "Heute ab {time} wieder geöffnet",
+    "over": "Für heute geschlossen",
+    "closed": "Heute geschlossen",
+    "unknown": "Für heute sind keine Öffnungszeiten eingetragen.",
+    "next": "Wieder geöffnet am {day} ab {time}"
+  },
+  "holiday": "Feiertag",
+  "holidays": {
+    "sunday": "An Feiertagen haben wir wie am Sonntag geöffnet.",
+    "closed": "An Feiertagen haben wir geschlossen."
+  },
+  "season": "{name}, bis {date}",
+  "seasonUnnamed": "Bis {date}",
+  "from": "Ab {date}",
+  "closures": "Geschlossen an",
+  "closedDays": "geschlossen"
+}

package/templates/local-business/i18n/hours/en.json

@@ -0,0 +1,27 @@
+{
+  "title": "Opening hours",
+  "today": "Today",
+  "todayTimes": "Today {times}",
+  "closed": "Closed",
+  "and": "and",
+  "now": {
+    "open": "Open now",
+    "until": "until {time}",
+    "later": "Opens today at {time}",
+    "again": "Open again today at {time}",
+    "over": "Closed for the rest of today",
+    "closed": "Closed today",
+    "unknown": "No opening hours for today.",
+    "next": "Open again on {day} at {time}"
+  },
+  "holiday": "public holiday",
+  "holidays": {
+    "sunday": "On public holidays we open as on Sunday.",
+    "closed": "On public holidays we are closed."
+  },
+  "season": "{name}, until {date}",
+  "seasonUnnamed": "Until {date}",
+  "from": "From {date}",
+  "closures": "Closures",
+  "closedDays": "closed"
+}

package/templates/local-business/i18n/people/de.json

@@ -0,0 +1,6 @@
+{
+  "title": "Team",
+  "lead": "Die Menschen hinter der Arbeit.",
+  "contact": "Kontakt zu {name}",
+  "empty": "Noch keine Personen"
+}

package/templates/local-business/i18n/people/en.json

@@ -0,0 +1,6 @@
+{
+  "title": "Team",
+  "lead": "The people behind the work.",
+  "contact": "Contact {name}",
+  "empty": "No people yet"
+}

package/templates/local-business/i18n/services/de.json

@@ -0,0 +1,20 @@
+{
+  "title": "Leistungen",
+  "lead": "Was wir anbieten, mit Preisen.",
+  "all": "Alle Leistungen",
+  "empty": "Noch keine Leistungen",
+  "price": "Preis",
+  "priceNet": "Preis (zzgl. MwSt.)",
+  "priceGross": "Preis (inkl. MwSt.)",
+  "onRequest": "Auf Anfrage",
+  "duration": "Dauer",
+  "specs": "Eckdaten",
+  "enquire": "Anfrage senden",
+  "subject": "Anfrage: {title}",
+  "book": "Termin anfragen",
+  "bookSubject": "Terminanfrage: {title}",
+  "call": "{phone} anrufen",
+  "orCall": "Oder anrufen:",
+  "orCallName": "Oder rufen Sie {name} an:",
+  "sheet": "Produktblatt"
+}

package/templates/local-business/i18n/services/en.json

@@ -0,0 +1,20 @@
+{
+  "title": "Services",
+  "lead": "What we offer, with prices.",
+  "all": "All services",
+  "empty": "No services yet",
+  "price": "Price",
+  "priceNet": "Price (plus VAT)",
+  "priceGross": "Price (incl. VAT)",
+  "onRequest": "On request",
+  "duration": "Duration",
+  "specs": "Key facts",
+  "enquire": "Send an enquiry",
+  "subject": "Enquiry: {title}",
+  "book": "Ask for a date",
+  "bookSubject": "Date request: {title}",
+  "call": "Call {phone}",
+  "orCall": "Or call:",
+  "orCallName": "Or call {name}:",
+  "sheet": "Product sheet"
+}

package/templates/local-business/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/local-business/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/local-business/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/local-business/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/local-business/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/local-business/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/local-business/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/local-business/nuxt.config.ts

@@ -0,0 +1,29 @@
+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 family is chosen in main.css (`--font-body`).
+  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()] },
+})