create-ginko 0.4.0 → 0.5.0

package/templates/saas/README.md

@@ -0,0 +1,264 @@
+# SaaS
+
+A complete website for a software product: what it does and for whom in one sentence on the home page, the plans
+with their prices per month and per year, a free trial that leads to your app, the changelog with an RSS feed,
+questions and answers, a blog, customer logos and a quote, the facts about security and data, and legal texts. In
+English, German and French, with light and dark mode. Built with [Nuxt](https://nuxt.com) and
+[Ginko](https://github.com/lupinum-dev/ginko). All content is Markdown in `content/`; the site needs no account and no
+database. The sample is "Planwerk", a fictional German company with a web app for planning shifts in care homes and
+small clinics.
+
+| Light | Dark |
+|---|---|
+| ![The SaaS template's home page in light mode](.github/screenshots/home-light.png) | ![The SaaS template's home page in dark mode](.github/screenshots/home-dark.png) |
+
+## Quick start
+
+```bash
+npm create ginko@latest my-site -- --template saas
+```
+
+This copies the template into `my-site`, keeps the languages you choose (`--locales en` for English only,
+`--locales de,en` for German first), moves the sample notice to this week, sets the site id and writes a `.env` with a
+new `NUXT_APP_SECRET`. Then:
+
+```bash
+cd my-site
+npm install
+npm run dev
+```
+
+Or copy the folder as it is, with all three languages, through Nuxt's own command:
+
+```bash
+npm create nuxt@latest my-site -- -t github:lupinum-dev/ginko/templates/saas#release
+```
+
+Copy `.env.example` to `.env` and fill in `NUXT_APP_SECRET` (see below). The `#release` branch follows the latest
+Ginko release, so both commands give you the same files. With this route the sample notice keeps its date: once that
+day has passed, it is simply not shown.
+
+## Deploy
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Flupinum-dev%2Fginko%2Ftree%2Frelease%2Ftemplates%2Fsaas&env=NUXT_APP_SECRET&envDescription=Signs%20the%20share%20card%20URLs.%20Any%2032%20or%20more%20random%20characters.)
+
+Any host that runs Node works: `npm run build` writes a server to `.output/`, started with
+`node .output/server/index.mjs`. Set these variables where the site runs:
+
+| Variable | What |
+|---|---|
+| `NUXT_APP_SECRET` | Signs the URLs of the share cards. 32 or more random characters (`openssl rand -hex 32`). |
+| `NUXT_PUBLIC_SITE_URL` | The address of the live site, for example `https://www.planwerk.example`. On Vercel the production address is used when this is not set. |
+
+A build on Vercel stops with a message while the address is still `example.com`, so search engines never see wrong
+links. Other builds (CI, your computer) only print a warning.
+
+**Static files.** This site can also be built as static files for any web host (`npm run generate`, output in
+`.output/public/`). Nothing on it depends on today's date except the notices and the releases: with static files, a
+notice leaves the site with the next build after its last day, not at midnight, and a release dated after the build day
+appears with the first build on or after that date. `draft: true` in a release file holds that release back. Rebuild
+when you change a notice or a release, and add a daily rebuild (for example a Vercel cron job or a scheduled GitHub
+Action).
+
+## Develop, build, preview
+
+| Command | What |
+|---|---|
+| `npm run dev` | the site with live reload on http://localhost:3000; drafts show here |
+| `npm run check` | Checks the content files in a few seconds: missing or wrong fields, dates, prices, links between pages and files in `public/`. Each problem names the file and the field. |
+| `npm run build` | the production build in `.output/`; drafts are left out |
+| `npm run generate` | static files instead of a server |
+| `npm run preview` | runs the build locally |
+| `npm run lint` | ESLint |
+| `npm run typecheck` | TypeScript and Vue types |
+
+`.github/workflows/ci.yml` runs lint, typecheck and build on every push. It needs no settings.
+
+## Edit content
+
+Every text is a Markdown file. The main language has no suffix (`about.md`); a translation adds the language code
+(`about.de.md`, `about.fr.md`) and repeats only what it translates: prices, dates, versions, links and images come
+from the main file. A page (a post, a free page or a legal text) shows in a language only when its translation has
+every required text. Plans, releases and questions without a translation show in the main language. The number at the
+start of a file name sets the order. After each change, run `npm run check`.
+
+Files point to other entries by id: the folder and the file name without number and language, so
+`content/people/1.lena-hartmann.md` is `people/lena-hartmann`. The `slug` is only the address on the site: renaming a
+file breaks the references to it, changing the `slug` does not. Write dates as `2026-10-24` and prices as a plain
+number in euros (`95` or `12.50`).
+
+The rows of `features` and `facts` in `content/home.md` and of `included` in a plan are translated row by row: a
+translation lists them in the same order as the main file. When you add, remove or move a row in the main file, do the
+same at the same place in each translation (write `- {}` for a row with nothing to translate). `npm run check` reports
+a translation with a different number of rows.
+
+| On the site | File |
+|---|---|
+| Home page: what the product does and for whom, lead, picture of the product, the link to the free trial, the features, the security and data facts | `content/home.md` (`title`, `lead`, `image`, `trialUrl`, `features` and `facts` as rows of `title` and `text`; and `home.de.md`, `home.fr.md`) |
+| Plans and prices | `content/pricing/<n>.<name>.md`: `name`, `summary` (for whom), `pricing` (`price` or `onRequest`, always one of the two), `monthly` and `yearly` (in euros, `89` or `89.50`; both required with `pricing: price`; write the number without quotes or a thousands separator: `2290`, not `2.290`, which reads as 2.29), `included` (rows of `item`), `recommended: true` on one plan, `actionLabel`, `actionUrl` (the sign-up page of your app; empty: the contact page, or without one an email to the address of `content/site.md` with the plan's name in the subject) |
+| Changelog | `content/changelog/v<version>.md` (`v4-6-0.md`: a dot in a file name reads as a language): `version`, `date`, then the text: one sentence (the summary on the home page and in the feed), a line `<!-- more -->`, and the changes under `### New`, `### Improved` and `### Fixed` |
+| FAQ | `content/faq/<n>.<name>.md`: `question`, `answer`; the pricing page shows the first three, so keep billing, cancellation and data export at the top |
+| Help center (`/help`) | `content/docs/<n>.<name>.md`: `title`, `description` (the line on the start page's card), `section` (a heading in the navigation; the pages after it belong to it), then the text; each translation sets its own address with `slug:`. Steps, notes and tables are Markdown components (`::steps`, `::callout`). The box under every help page is `app/components/DocsPageEnd.vue`, the start page `app/pages/help/index.vue` |
+| Blog | `content/posts/<name>.md`: `title`, `description` (the summary), `date`, `authors` (people by id, `[people/lena-hartmann]`), `tags`, `image` (the cover, 3:2); `draft: true` keeps a post off the site |
+| Authors of the blog | `content/people/<n>.<name>.md`: `name`, `role`, `bio`; no photo needed, the site shows initials |
+| Customer logos | `content/logos/<n>.<name>.md`: `name`, `image` (an SVG or PNG in `public/logos/`), `url` |
+| Quote on the home page | `content/quotes/<n>.<name>.md`: `text`, `name`, `role`; the home page shows the first |
+| Security, about us, contact and other pages | `content/pages/<n>.<name>.md`; each translation sets its own address with `slug:`. The contact page shows the address, email and phone of `content/site.md` under its title (`app/components/pages/Top.vue`) |
+| Notices above the header | `content/notices/<n>.<name>.md`: `text` (at most 140 characters; in quotes when it contains a colon), `until` (the last day it shows, like `2026-12-31`, in the `timeZone` of `ginko.config.ts`; without it the notice stays until you delete the file). A translation has only `text`. |
+| Name, address, register entry, VAT number, email, phone | `content/site.md` (footer, imprint, the contact page, search engines) |
+| Privacy policy, terms of service, imprint | `content/legal/` (placeholders for Germany: replace them before you go live) |
+| Site name, description for search engines, currency | `ginko.config.ts` (`name`, `seo.description`, `currency`) |
+| Menu, footer links, the line under the name in the footer, VAT | `app/app.config.ts` |
+| The home page's title in search results and tabs, section titles, the texts of the pages | `i18n/<language>.json` (`home.title` is "Shift planning for care homes and small clinics"); the features' own texts are in `i18n/<feature>/<language>.json`, and a key set in `i18n/<language>.json` wins (this template renames "News" to "Blog" that way) |
+
+**Prices.** Every plan says how it is priced: `pricing: price` with `monthly` and `yearly`, or `pricing: onRequest`.
+The pricing page shows both prices of each plan in the visitor's language with tabular numbers ("€219 per month",
+"or €2,190 per year"), so it needs no switch; search engines get the same prices (a Product with one Offer per month
+and one per year). A plan on request shows "On request" and gives search engines no price. A priced plan without one
+of its amounts is a mistake: the build stops on it and names the file, and the Studio does not save it. The page says
+"All prices plus VAT" (`vat: 'excluded'` in `app/app.config.ts`, which also tells search engines); set
+`vat: 'included'` if your prices include it.
+
+**Changelog.** The newest release comes first, by `date`. Each release has its own address on the changelog page
+(`/changelog#v4-6-0`), so a notice or a post can link to it. Each language has a feed at `<changelog page>/rss.xml`
+(`/changelog/rss.xml`, `/de/neuerungen/rss.xml`, `/fr/nouveautes/rss.xml`) with the version, the summary and the
+date of each release; the blog has its own at `<blog page>/rss.xml`.
+
+**Help center.** The help pages come from `@lupinum/ginko-docs` and sit inside the site's header and footer, with a
+navigation beside them (on phones behind "Contents"), a search and "On this page". The layer's own texts (such as the
+search field's) are `docs.*` keys; a key set in `i18n/<language>.json` wins (`docs.searchPlaceholder` is "Search
+help…" here). Its README lists what else you can change: [Customize](https://www.npmjs.com/package/@lupinum/ginko-docs#customize).
+
+**Free trial.** "Start free trial" is a link to your app (`trialUrl` in `content/home.md`, and `actionUrl` of each
+plan). The site itself has no sign-up form and sends no data anywhere.
+
+Notices show in file-number order, smallest first: give the newest a smaller number than the others (the sample is
+`5.`; `0.` works, and numbers may have gaps). At most two show at once.
+
+## Make it yours
+
+- **Name.** `name` in `ginko.config.ts` (header, footer, share cards, search engines). The sample name also appears as
+  text in `seo.description` in `ginko.config.ts`, `legalName` in `content/site.md` and the sample texts in
+  `content/` (home, pages, FAQ, people, posts, changelog, notices); `grep -rl Planwerk content` lists them. Replace what
+  is left. On phones the header can show a shorter name: set `shortName` in `app/app.config.ts` (the commented line).
+- **Menu.** `nav` in `app/app.config.ts` holds at most six items: a page of
+  `ginko.config.ts` (`{ page: 'pricing', label: { … } }`, label per language, the same words as the page's title) or
+  a page of `content/pages/` by id (`{ entry: 'pages/security' }` is `content/pages/1.security.md`). `footer` takes the
+  same items and an address on another site: `{ url: 'https://app.planwerk.example/login', label: { … } }` is the
+  "Sign in" link to your app, in the footer and in the phone menu.
+- **Logo.** Put the file in `public/` and set `logo: { src: '/logo.svg', width: 140, height: 32 }` in
+  `app/app.config.ts`. Without it, the header shows the name.
+- **Picture of the product.** `content/home.md` shows `public/media/rota.svg`, a neutral drawing of a shift plan.
+  Replace it with a screenshot of your product (16:9, PNG or WebP, about 1600 × 900 pixels) and describe it in `alt`
+  in each language file. If you keep the drawing, change its violets (`#7c3aed`, `#5b21b6`, `#a78bfa`) in
+  `public/media/rota.svg` to your colour.
+- **Colour.** `--brand` and `--brand-foreground` in `app/assets/css/main.css`, once for light and once for dark
+  (`.dark`), and the light value as `seo.color` in `ginko.config.ts` (the background of the share cards). This
+  template uses violet (`--brand` `#6d28d9`, dark `#c4b5fd`). In dark mode the closing band uses
+  `--brand-surface: #4c1d95` with `--brand-surface-foreground: #f5f3ff` (in `.dark`); set `--brand-surface` to a deep
+  shade of your colour and `--brand-surface-foreground` to the text colour on it, or delete both to use `--brand`. Text on the colour needs a contrast of at least 4.5:1 in both modes; check each pair
+  with a contrast checker (for example webaim.org/resources/contrastchecker). `DESIGN.md` has the rules.
+- **Fonts.** `--font-body` in `main.css`. `@nuxt/fonts` downloads the fonts at build time and serves them from your
+  site.
+- **Organisation type.** `organization: 'Organization'` in `app/app.config.ts` tells search engines what you are;
+  address and contact come from `content/site.md`, the country from `country` in `ginko.config.ts`.
+- **Addresses.** The words of the addresses per language (`pricing` → `preise`, `tarifs`; `changelog` →
+  `neuerungen`, `nouveautes`) are in `app/routes.ts`. Change a word there; the pages, the menu and the links follow.
+
+`DESIGN.md` explains the tokens and components. The parts in `app/components/ui/` are
+[shadcn-vue](https://www.shadcn-vue.com) components.
+
+## Add a page
+
+**A text page:** add `content/pages/4.integrations.md` with a `title`, an optional `summary` and the text below the
+frontmatter. It appears at `/integrations`; each translation sets its own address with `slug:` (`slug: schnittstellen`
+in `4.integrations.de.md` gives `/de/schnittstellen`). Add `{ entry: 'pages/integrations' }` to `nav` or `footer` in
+`app/app.config.ts` to link it.
+
+**A page with its own layout:** add a Vue file in `app/pages/`, for example `app/pages/customers.vue`. Start it with
+`<BlockPageHeader>` and call `usePageSeo()`, like `app/pages/faq.vue`. Register it in `ginko.config.ts` under `pages`
+(`customers: localized('/customers')`) and add the words of its address per language to `segments` in
+`app/routes.ts` (`customers: { en: 'customers', de: 'kunden', fr: 'clients' }`). It then answers at `/customers`,
+`/de/kunden` and `/fr/clients`, and `useGinkoPath()('customers')` links to it.
+
+## Add or remove a language
+
+The languages are the `locales` list in `app/routes.ts`; the first is the main language, whose addresses have no
+prefix.
+
+- **Remove one:** start fresh with `npm create ginko@latest my-site -- --template saas --locales en,de`, or delete it
+  from `locales` and from the maps in `app/routes.ts` and `languages` in `ginko.config.ts`, then delete its files
+  (`*.fr.md`, `i18n/fr.json`, `i18n/*/fr.json`) and its labels in `app/app.config.ts`.
+- **Add one** (for example Italian): add `'it'` to `locales` and a word per address in `app/routes.ts`, its tag to
+  `languages` in `ginko.config.ts` (`it: 'it-IT'`), and the Italian labels of `nav` and `tagline` in
+  `app/app.config.ts` (without them they show in the main language). Add `i18n/it.json` and the texts of every
+  `i18n/<feature>/en.json` translated as `i18n/<feature>/it.json`.
+- **Translate the content** as `content/**/*.it.md`. A page shows in the new language only once it has its
+  translation file: without one it is not on the Italian site, the menu leaves it out, and links to it lead to its page
+  in the main language. Plans, releases and questions show in the main language until they are translated. Translate
+  at least the legal texts (`content/legal/`) before the language goes live.
+
+## Add a sign-up or contact form
+
+The site sends no data to other companies, so it has no forms: "Start free trial" opens your app, and "Ask for a quote"
+leads to the contact page, which says what to send. For a contact form, link to a form service of your choice and name
+it in your privacy policy.
+
+## Remove a feature
+
+Links in the content name pages by their key (`[changelog]($page.changelog)`). After you remove a page, search
+`content/` for `$page.<key>` and remove or change those links: the build stops on a link that leads nowhere.
+
+| Feature | Delete |
+|---|---|
+| Pricing | `content/pricing/`, the `pricing` brick and `pages.pricing` in `ginko.config.ts`, its `nav` item, the hero's second button and the price note under it in `app/pages/index.vue` (`useLowestPrice()`, `usePricingVat()`, and `path` from `useGinkoPath()`; `heroNote` keeps only `t('home.trialNote')`), the sentence about the pricing page in `content/legal/2.terms*.md`, `app/pages/pricing.vue`, `app/components/pricing/`, `app/bricks/pricing.ts`, `app/composables/usePricing.ts`, `i18n/pricing/`, the `pricing` keys in `i18n/<language>.json`, and `"pricing"` in `package.json` → `ginko.features` |
+| Changelog | `content/changelog/`, the `changelog` brick and `pages.changelog`, its `nav` item, the "Latest changes" section and `useLatestReleases` in `app/pages/index.vue`, `app/pages/changelog.vue`, `app/components/changelog/`, `app/composables/useChangelog.ts`, `app/utils/changelog.ts`, `server/middleware/changelog-feed.ts`, `i18n/changelog/`, the `changelog` keys in `i18n/<language>.json`, `"changelog"` in `ginko.features`; the links to `$page.changelog` in `content/posts/swap-requests*.md` and `content/pages/2.about*.md` |
+| FAQ | `content/faq/`, the `faq` brick and `pages.faq`, its `nav` item, `app/pages/faq.vue`, `app/components/pricing/More.vue` (the questions below the plans), `app/components/block/Faq.vue`, `app/components/ui/accordion/`, `i18n/faq/`, the `faq` and `pricing.questions` keys in `i18n/<language>.json`, `"faq"` in `ginko.features`; the links to `$page.faq` in `content/pages/3.contact*.md` |
+| Blog | `content/posts/`, `content/people/`, the `posts` and `people` bricks and `pages.news`, `news` in `segments` of `app/routes.ts`, its `nav` item, `app/pages/news/`, `app/components/InitialsAvatar.vue`, `people` and `posts` in the import of `ginko.config.ts`, `app/components/blog/`, `app/composables/useBlog.ts`, `server/middleware/news-feed.ts`, the team on the About page in `app/components/pages/Top.vue` (and its `about` keys in `i18n/<language>.json`), the "Responsible for the blog" section of `content/legal/3.imprint*.md`, `i18n/blog/`, the `blog` keys in `i18n/<language>.json`, `"blog"` in `ginko.features` |
+| Help center | `content/docs/`, the `docs` brick and `pages.help`, its `nav` item, `@lupinum/ginko-docs` in `extends` of `nuxt.config.ts` and in `package.json`, `components` in `ginko.config.ts`, `app/pages/help/`, `app/components/help/`, `app/components/DocsPageEnd.vue`, the `--docs-*` lines in `app/assets/css/main.css`, the `help` and `docs` keys in `i18n/<language>.json`; the links to `$page.help` in `content/pages/3.contact*.md` |
+| Logos and quotes | `content/logos/`, `content/quotes/`, `public/logos/`, the `logos` and `quotes` bricks and their import in `ginko.config.ts`, the "Customers" section of `app/pages/index.vue` (`useGinko('logos')`, `useGinko('quotes')`, `quote`, and the section with `BlockLogos` and `BlockQuote`), `app/bricks/logos-quotes.ts`, `app/components/block/Logos.vue`, `Quote.vue`, `"logos-quotes"` in `ginko.features` |
+| Notices | `content/notices/`, the `notices` brick, `<SiteNotice />` in `app/layouts/default.vue`, `app/components/site/Notice.vue` |
+| A language | see "Add or remove a language" |
+| Dark mode | `<SiteThemeToggle />` in `app/components/site/Header.vue`, `app/components/site/ThemeToggle.vue`, and `@nuxtjs/color-mode` with its `colorMode` options in `nuxt.config.ts` and `package.json` |
+| Share cards | `nuxt-og-image` and `@takumi-rs/core` in `nuxt.config.ts` and `package.json`; then `NUXT_APP_SECRET` is not needed |
+
+## Before you deploy
+
+- [ ] `NUXT_PUBLIC_SITE_URL` (or `url` in `ginko.config.ts`) is your real address.
+- [ ] `NUXT_APP_SECRET` is set where the site runs.
+- [ ] `content/site.md` shows your real legal name, address, register entry, VAT number and contact details.
+- [ ] Every plan has your prices or `pricing: onRequest`, the "plus VAT" note fits your prices, and the answers in
+      `content/faq/` say the same as your terms.
+- [ ] `trialUrl` in `content/home.md`, each plan's `actionUrl`, the sign-in link (`footer` in `app/app.config.ts`) and the
+      link on the contact page lead to your app, not to `app.planwerk.example`.
+- [ ] The sample phone numbers and emails are replaced: they reach nobody (the numbers start their local part
+      with 0, the emails end in .example), so a forgotten one fails quietly.
+- [ ] The facts about security and data (`facts` in `content/home.md`, `content/pages/1.security.md`) describe your
+      real hosting, backups and contracts.
+- [ ] The placeholders in `content/legal/` are replaced by your own texts, and the ones you do not need are deleted.
+- [ ] The sample changelog, posts, quote, customer logos and the drawing of the product are replaced or deleted;
+      quotes and logos only with the customer's permission.
+- [ ] Every image you added has alt text in each language file that shows it and a source in `MEDIA.md`.
+
+## Move to the Studio
+
+Ginko Studio is Lupinum's hosted editor: your team adds a changelog entry or a notice from the browser, changes a
+price or answers a new question, and the Today page shows how old the newest changelog entry is. It is open by
+invitation, and Lupinum moves your content with you. The site stays the same code: each brick in `ginko.config.ts`
+loses its `source: 'files'` (the help center's `docsCollection` gets `source: 'platform'`), and its content then comes
+from the Studio. The help center's search box is built from files, so it finds no help page that lives in the Studio.
+Until then, everything here works without it. Ask at [lupinum.com](https://lupinum.com).
+
+## Updating
+
+Move all Ginko packages to the same version in one step:
+
+```bash
+npm install @lupinum/ginko@latest @lupinum/ginko-content@latest @lupinum/ginko-i18n@latest
+```
+
+The release notes list "Template files changed": compare those files with yours if you want the changes.
+
+## License
+
+Code: MIT (see `LICENSE`). Media: see `MEDIA.md`.

package/templates/saas/app/app.config.ts

@@ -0,0 +1,37 @@
+import type { SiteAppConfig } from './composables/useSiteAppConfig'
+
+// The brand and navigation of the site. The name is `name` in ginko.config.ts; colours and fonts are in
+// app/assets/css/main.css; address and contact are in content/site.md.
+export default defineAppConfig({
+  site: {
+    // shortName: 'Pw', // shown on phones instead of the name
+    // logo: { src: '/logo.svg', width: 140, height: 32 },
+    // One line under the name in the footer, per language.
+    tagline: {
+      en: 'Shift planning for care homes and small clinics.',
+      de: 'Dienstplanung für Pflegeheime und kleine Kliniken.',
+      fr: 'La planification des équipes pour les EHPAD et les petites cliniques.',
+    },
+    organization: 'Organization',
+    // At most 6. A page of ginko.config.ts (`page`, with its label per language; keep it the same as the page's
+    // title) or an entry of content/pages/ by id (`pages/<file name without number>`).
+    nav: [
+      { page: 'pricing', label: { en: 'Pricing', de: 'Preise', fr: 'Tarifs' } },
+      { page: 'changelog', label: { en: 'Changelog', de: 'Neuerungen', fr: 'Nouveautés' } },
+      { page: 'faq', label: { en: 'FAQ', de: 'Häufige Fragen', fr: 'Questions fréquentes' } },
+      { page: 'help', label: { en: 'Help', de: 'Hilfe', fr: 'Aide' } },
+      { entry: 'pages/contact' },
+    ],
+    footer: [
+      { entry: 'pages/security' },
+      { entry: 'pages/about' },
+      { page: 'news', label: { en: 'Blog', de: 'Blog', fr: 'Blog' } },
+      // The sign-in of the app, for customers: a quiet link here and in the phone menu, no second button in the header.
+      { url: 'https://app.planwerk.example/login', label: { en: 'Sign in', de: 'Anmelden', fr: 'Se connecter' } },
+    ],
+    // For example { label: 'LinkedIn', url: 'https://www.linkedin.com/company/planwerk' }.
+    socials: [],
+    // Prices to businesses, plus VAT: the pricing page says so, and so does the prices' JSON-LD.
+    vat: 'excluded',
+  } satisfies SiteAppConfig,
+})

package/templates/saas/app/app.vue

@@ -0,0 +1,7 @@
+<!-- Synced from templates/_features/site/app/app.vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<template>
+  <NuxtRouteAnnouncer />
+  <NuxtLayout>
+    <NuxtPage />
+  </NuxtLayout>
+</template>

package/templates/saas/app/assets/css/main.css

@@ -0,0 +1,30 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+@import "./tokens.css";
+
+/* This template's accent and fonts (DESIGN.md "Your accent"). Everything else comes from tokens.css.
+   saas: violet. White on the accent 7.1:1 light; the accent on the page 7.1:1 light; #2e1065 on the dark accent
+   8.3:1; the dark accent on the page 10.7:1. The focus ring and links in text use the accent. */
+:root {
+  --brand: #6d28d9;
+  --brand-foreground: #ffffff;
+  /* @nuxt/fonts serves Inter from the site and adds size-matched fallbacks. */
+  --font-body: "Inter", ui-sans-serif, system-ui, sans-serif;
+  /* The help center (@lupinum/ginko-docs) lines up with the header and sticks below it (h-16, md:h-18, border). */
+  --docs-max: var(--container-page);
+  --docs-gutter: var(--spacing-gutter);
+  --docs-top: calc(4rem + 1px);
+}
+
+@media (min-width: 48rem) {
+  :root { --docs-top: calc(4.5rem + 1px); }
+}
+
+.dark {
+  --brand: #c4b5fd;
+  --brand-foreground: #2e1065;
+  /* The closing band in dark mode: a deep violet instead of the light accent, so it does not outshine the page.
+     #f5f3ff on #4c1d95 10.0:1. */
+  --brand-surface: #4c1d95;
+  --brand-surface-foreground: #f5f3ff;
+}