@evinvest/kitstart 0.1.0

package/template/app/global-not-found.tsx

@@ -0,0 +1,28 @@
+import "./globals.css";
+import { GONE_HEADER, parseGoneHeader } from "@evinvest/kitstart";
+import { headers } from "next/headers";
+import { site } from "@/shared/config/site";
+import { text } from "@/shared/ui/fonts";
+import { Gone } from "@/views/not-found/server";
+
+/**
+ * Every path no route matches — among them each dead path the proxy sends
+ * here (`gone`) — answered 404 with the brand's screen rendered on the
+ * server, so a visitor without JavaScript still gets the offer and the phone.
+ * A document of its own: the root layout lives under `[locale]`.
+ *
+ * It reads the proxy's header, which only this route does: it is not a
+ * boundary inside the cached pages, so they stay static. The proxy strips a
+ * client-sent copy. No `robots` here: Next already emits `noindex` for a 404.
+ */
+export default async function GlobalNotFound() {
+  const gone = parseGoneHeader((await headers()).get(GONE_HEADER));
+  const locale = site.i18n.isLocale(gone.locale) ? gone.locale : site.i18n.defaultLocale;
+  return (
+    <html lang={locale} data-brand={site.brand.id} className={`light ${text.variable}`}>
+      <body>
+        <Gone locale={locale} location={gone.location ?? null} />
+      </body>
+    </html>
+  );
+}

package/template/app/globals.css

@@ -0,0 +1,18 @@
+@import "tailwindcss";
+@import "@evinvest/uikit/styles/tokens.css";
+@import "./brand.css";
+
+/* Tailwind v4 does not scan node_modules: name the packages whose markup it
+   must see. The landing contract test checks the kitstart line. */
+@source "../node_modules/@evinvest/uikit/dist";
+@source "../node_modules/@evinvest/kitstart/dist";
+
+html {
+  scroll-behavior: smooth;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  html {
+    scroll-behavior: auto;
+  }
+}

package/template/app/health/route.ts

@@ -0,0 +1,6 @@
+import { healthRoute } from "@evinvest/kitstart/next";
+
+/** The container's readiness probe. */
+export const dynamic = "force-dynamic";
+
+export const GET = healthRoute();

package/template/app/og/route.tsx

@@ -0,0 +1,27 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ogPalette, ogRoute } from "@evinvest/kitstart/next";
+import { TEXT } from "@/entities/content";
+import { site } from "@/shared/config/site";
+
+/** Drawn once per (place, language, page) per process; baked data only. */
+export const dynamic = "force-dynamic";
+
+/** `[colors.dark]` of assets/brand.toml, inlined at build — not a second copy here. */
+const c = ogPalette();
+
+export const GET = ogRoute(site, {
+  // `withLanding({ ogFiles })` traces the file into the standalone output.
+  fonts: async () => [{ name: "Inter", data: await readFile(join(process.cwd(), "assets/fonts/Inter-Regular.ttf")), weight: 400, style: "normal" }],
+  draw: ({ locale, place, page }) => {
+    const t = TEXT[locale];
+    const f = { place: place?.name[locale] ?? site.brand.name, phone: site.brand.phone };
+    return (
+      <div style={{ display: "flex", flexDirection: "column", width: "100%", height: "100%", padding: 72, background: c.background, color: c.ink, fontFamily: "Inter" }}>
+        <div style={{ display: "flex", fontSize: 44, color: c.primary }}>{site.brand.name}</div>
+        <div style={{ display: "flex", flex: 1, alignItems: "center", fontSize: 68 }}>{t.pages[page].title(f)}</div>
+        {f.phone && <div style={{ display: "flex", fontSize: 28, color: c.inkSoft }}>{f.phone}</div>}
+      </div>
+    );
+  },
+});

package/template/app/quote/route.ts

@@ -0,0 +1,17 @@
+import { quoteRoute } from "@evinvest/kitstart/next";
+import { TEXT } from "@/entities/content";
+import { notifier, serverEnv } from "@/shared/config/env";
+import { site } from "@/shared/config/site";
+
+/** The no-JS path: a plain form POST answered with a 303. */
+export const dynamic = "force-dynamic";
+
+export const POST = quoteRoute(site, {
+  env: serverEnv,
+  notifier,
+  unavailable: locale => {
+    const t = TEXT[locale];
+    const f = { place: site.brand.name, phone: site.brand.phone };
+    return { title: t.serverError.title, heading: t.serverError.headline.join(""), body: t.serverError.body(f), callLabel: t.callLabel(f) };
+  },
+});

package/template/app/robots.ts

@@ -0,0 +1,6 @@
+import { robotsRoute } from "@evinvest/kitstart/next";
+import { site } from "@/shared/config/site";
+
+export const dynamic = "force-dynamic";
+
+export default robotsRoute(site);

package/template/app/sitemap.ts

@@ -0,0 +1,8 @@
+import { sitemapRoute } from "@evinvest/kitstart/next";
+import { places } from "@/shared/config/env";
+import { site } from "@/shared/config/site";
+
+/** Per host, strict: a failing live source is a 5xx, never a shorter list. */
+export const dynamic = "force-dynamic";
+
+export default sitemapRoute(site, places);

package/template/assets/brand.toml

@@ -0,0 +1,68 @@
+# The brand palette, in the kit's token vocabulary — the source of truth.
+# `npm run palette` (the kit's `evinvest-palette`) writes app/brand.css from it
+# and fails on a hole in either scope; the OG card reads [colors.dark] at build;
+# the Figma modes mirror it. These are the kit's demo values: replace them.
+
+wordmark = ["BRA", "ND"] # the second half takes primary
+
+[colors.light]
+background = "#ffffff"
+card = "#f6f8fa"
+muted = "#d2dbe6"
+popover = "#ffffff"
+ink = "#051726"
+ink-soft = "#5a6b7c"
+brand = "#0a2540"
+primary = "#c2703d"
+on-primary = "#051726"
+primary-ink = "#9a5424"
+secondary = "#edf1f5"
+on-secondary = "#051726"
+positive = "#1e9e6a"
+on-positive = "#ffffff"
+accent-trace = "#5a6b7c"
+on-accent-trace = "#ffffff"
+accent-debug = "#5a6b7c"
+on-accent-debug = "#ffffff"
+accent-info = "#5a6b7c"
+on-accent-info = "#ffffff"
+accent-warn = "#e08a3c"
+on-accent-warn = "#051726"
+accent-error = "#d8362a"
+on-accent-error = "#ffffff"
+chart-1 = "#9a5424"
+chart-2 = "#1e9e6a"
+chart-3 = "#e08a3c"
+chart-4 = "#d8362a"
+chart-5 = "#0a2540"
+
+[colors.dark]
+background = "#051726"
+card = "#0a2540"
+muted = "#12395c"
+popover = "#12395c"
+ink = "#ffffff"
+ink-soft = "#a9bdd1"
+brand = "#0a2540"
+primary = "#c2703d"
+on-primary = "#051726"
+primary-ink = "#e08f5c"
+secondary = "#12395c"
+on-secondary = "#ffffff"
+positive = "#1e9e6a"
+on-positive = "#ffffff"
+accent-trace = "#a9bdd1"
+on-accent-trace = "#051726"
+accent-debug = "#a9bdd1"
+on-accent-debug = "#051726"
+accent-info = "#a9bdd1"
+on-accent-info = "#051726"
+accent-warn = "#e08a3c"
+on-accent-warn = "#051726"
+accent-error = "#d8362a"
+on-accent-error = "#ffffff"
+chart-1 = "#e08f5c"
+chart-2 = "#1e9e6a"
+chart-3 = "#e08a3c"
+chart-4 = "#d8362a"
+chart-5 = "#a9bdd1"

package/template/assets/card.toml

@@ -0,0 +1,8 @@
+# The one place a contact fact is written — the printed card, the vCards and
+# the site all read it (`withLanding` inlines it at build).
+#
+# `phone` and `site` are optional for the web: without `site` the whole site
+# is noindex and robots disallow everything — the state before launch. Add
+# them when the owner has them; `phone` must be international ("+33 …").
+name = "Brand"
+email = "hello@brand.example"

package/template/assets/fonts/Inter-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/template/assets/mark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 86.6 100"><path fill="currentColor" d="M43.3 0 86.6 25v50L43.3 100 0 75V25z"/></svg>

package/template/deploy/config.nix

@@ -0,0 +1,24 @@
+# The prod environment of the server, baked into the image as plain env
+# (flake.nix: `prodEnv`). Secret-free: SMTP_URL, SMS_TOKEN and POSTHOG_KEY
+# (and LEAD_NOTIFY_TO/FROM, LOCATIONS_API_URL when used) arrive from the
+# container environment a Secret injects.
+#
+# Explicit because the defaults are dev's: without HOSTNAME the standalone
+# server binds one interface the readiness probe may not reach; without
+# LEADS_DB_PATH or TRUSTED_PROXY the server refuses to start in production
+# (instrumentation.ts), so the pod never turns ready rather than losing a lead
+# or counting the wrong address against the rate limit.
+{ port }:
+{
+  # The mount, not $HOME. Leads are the only durable state this service has.
+  LEADS_DB_PATH = "/data/leads.db";
+  # "cloudflare" is right only when the origin cannot be reached around the
+  # tunnel (no public port, no ingress of its own): then CF-Connecting-IP is
+  # the visitor. If anything else can reach the pod, a client could write that
+  # header itself — use "xff:<n>" for the n proxies of yours in front instead.
+  TRUSTED_PROXY = "cloudflare";
+  HOSTNAME = "0.0.0.0";
+  PORT = toString port;
+  NODE_ENV = "production";
+  NEXT_TELEMETRY_DISABLED = "1";
+}

package/template/eslint.config.mjs

@@ -0,0 +1,28 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+// Next's rules, plus the one boundary a landing must hold that steiger does
+// not see: a client module never imports the server halves of the package.
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  {
+    // The client boundaries; add a client module here when you write one.
+    files: ["src/views/not-found/ui/NotFound.tsx", "src/views/server-error/**", "app/**/error.tsx", "app/**/not-found.tsx"],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            {
+              group: ["@evinvest/kitstart/server", "@evinvest/kitstart/next", "@evinvest/kitstart/next/*", "@/shared/config/env", "@/shared/config/site"],
+              message: "a client module reads BRAND_PUBLIC and the core, never the server halves or the whole site config",
+            },
+          ],
+        },
+      ],
+    },
+  },
+  globalIgnores([".next/**", "node_modules/**", "next-env.d.ts"]),
+]);

package/template/flake.nix

@@ -0,0 +1,46 @@
+{
+  inputs = {
+    v_flakes.url = "github:valeratrades/v_flakes?ref=v1.6";
+    # The lib flake at the tag of the @evinvest/kitstart version in
+    # package-lock.json — mkLanding refuses a mismatch.
+    ev.url = "github:EV-invest/lib?ref=@evinvest/kitstart-v0.1.0";
+    ev.inputs.v_flakes.follows = "v_flakes";
+  };
+
+  outputs = { self, v_flakes, ev }:
+    v_flakes.flake-utils.lib.eachDefaultSystem (
+      system:
+      let
+        pkgs = import v_flakes.default_nixpkgs { inherit system; };
+        sitePort = "59082";
+        landing = ev.lib.mkLanding {
+          inherit pkgs v_flakes sitePort;
+          root = ./.;
+          pname = "brand-landing";
+          buildFiles = [
+            "package.json"
+            "package-lock.json"
+            "app"
+            "src"
+            "assets"
+            "next.config.ts"
+            "tsconfig.json"
+            "postcss.config.mjs"
+            "proxy.ts"
+            "instrumentation.ts"
+          ];
+          prodEnv = import ./deploy/config.nix { port = sitePort; };
+          requiredFiles = [ "assets/fonts/Inter-Regular.ttf" ];
+          smoke = {
+            page = "/fr";
+            og = "/og?l=paris";
+            quote = { location = "paris"; subject = "standard"; locality = "75011"; mobile = "0612345678"; };
+          };
+        };
+      in
+      {
+        inherit (landing) packages checks apps containers;
+        devShells.default = landing.devShell;
+      }
+    );
+}

package/template/instrumentation.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs once when the server starts. A missing prod setting, a lead store that
+ * cannot open, or SMTP with no sender fails startup — every request, `/health`
+ * included, answers 500 and the pod never turns ready — instead of the first
+ * customer's submission.
+ */
+export async function register(): Promise<void> {
+  if (process.env.NEXT_RUNTIME !== "nodejs") return;
+  const { serverEnv, notifier } = await import("@/shared/config/env");
+  const { checkLeadStore } = await import("@evinvest/kitstart/server");
+  notifier();
+  await checkLeadStore(serverEnv());
+}

package/template/next.config.ts

@@ -0,0 +1,5 @@
+import { withLanding } from "@evinvest/kitstart/next/config";
+
+// Everything shared is in `withLanding` (standalone output, the card inlined,
+// ISR bounds, no image optimiser); what is left here is the brand's own.
+export default withLanding({}, { root: process.cwd(), ogFiles: ["./assets/fonts/*.ttf"] });

package/template/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "brand-landing",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=22.13"
+  },
+  "scripts": {
+    "palette": "evinvest-palette --brand brand --out app/brand.css assets/brand.toml",
+    "dev": "npm run palette && next dev",
+    "build": "npm run palette && next build",
+    "postbuild": "rm -rf .next/standalone/.next/static && cp -R .next/static .next/standalone/.next/static",
+    "start": "node .next/standalone/server.js",
+    "typecheck": "next typegen && tsc --noEmit",
+    "test": "vitest run",
+    "size": "kitstart-size",
+    "lint": "eslint . && steiger ./src"
+  },
+  "dependencies": {
+    "@evinvest/analytics": "^0.3.0",
+    "@evinvest/i18n": "^0.9.0",
+    "@evinvest/kitstart": "^0.1.0",
+    "@evinvest/marketing": "^0.3.0",
+    "@evinvest/uikit": "^0.20.0",
+    "next": "16.3.6",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "server-only": "^0.0.1"
+  },
+  "devDependencies": {
+    "@feature-sliced/steiger-plugin": "^0.7.0",
+    "@tailwindcss/postcss": "^4.3.3",
+    "@types/node": "^22.20.4",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "eslint": "^9.39.5",
+    "eslint-config-next": "16.3.6",
+    "steiger": "^0.6.0",
+    "tailwindcss": "^4.3.3",
+    "typescript": "5.9.3",
+    "vitest": "^3.2.4"
+  }
+}

package/template/postcss.config.mjs

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

package/template/proxy.ts

@@ -0,0 +1,11 @@
+import { createProxy } from "@evinvest/kitstart/proxy";
+import { site } from "@/shared/config/site";
+
+export const proxy = createProxy(site);
+
+export const config = {
+  // A literal: Next reads it statically. Everything but the build output,
+  // files included: `decide` passes the routes outside `[locale]` and
+  // `site.publicFiles`, and sends any other path to the 404.
+  matcher: ["/((?!_next/).*)"],
+};

package/template/src/entities/content/index.ts

@@ -0,0 +1,12 @@
+import type { Locale } from "@/shared/config/i18n";
+import { EN } from "./model/en";
+import { FR } from "./model/fr";
+import type { Copy, Facts, Text } from "./model/types";
+
+export type { Copy, Facts, Text } from "./model/types";
+
+export const TEXT = { fr: FR, en: EN } satisfies Record<Locale, Text>;
+
+export function copyFor(locale: Locale, f: Facts): Copy {
+  return { locale, t: TEXT[locale], f };
+}

package/template/src/entities/content/model/en.ts

@@ -0,0 +1,47 @@
+import type { StatusCopy } from "@evinvest/kitstart";
+import type { Facts, Text } from "./types";
+
+const status = (code: string, title: string, headline: readonly [string, string], body: string): StatusCopy<Facts> => ({
+  code,
+  title,
+  eyebrow: title.toUpperCase(),
+  headline,
+  body: () => body,
+  primary: "call",
+  secondary: "home",
+});
+
+export const EN = {
+  pages: {
+    home: { title: f => `Cleaning in ${f.place}`, description: f => `Cleaning in ${f.place}: a fixed price, quoted before we come.` },
+    prices: { title: () => "Our prices", description: f => `Every price in ${f.place}.` },
+  },
+  quoteForm: {
+    title: "Get a price",
+    lede: "An answer within the hour.",
+    submit: "Get the price",
+    privacy: "Your number is used only to answer you.",
+    reassurance: () => "No commitment.",
+    honeypotLabel: "Website",
+  },
+  notFound: status("404", "Page not found", ["This page ", "does not exist."], "The link may be old."),
+  serverError: status("500", "Error", ["Something broke ", "on our side."], "Try again in a moment."),
+  thanks: status("✓", "Request received", ["Thank you, ", "we will call you back."], "We have your request."),
+  callLabel: f => (f.phone ? `Call ${f.phone}` : "Call us"),
+  whatsappLabel: "WhatsApp",
+  whatsappShort: "WhatsApp",
+  whatsappMessage: f => `Hello, I am writing from the ${f.place} page.`,
+  ctaShort: "Quote",
+  backHome: "Back home",
+  tryAgain: "Try again",
+  statusStrip: ["Fixed price", "No commitment"],
+  langName: "English",
+  facts: () => ["Brand SAS"],
+  hero: { title: f => `Cleaning in ${f.place}, at a fixed price.`, lede: "A price quoted before we come." },
+  coverageTitle: "Where we work",
+  brandPage: { title: "Brand", description: "Cleaning at a fixed price.", open: "Open" },
+  contactLabel: "Contact us",
+  subjects: { standard: "Regular cleaning", deep: "Deep cleaning", other: "Other" },
+  quoteLabels: { subject: "Service", locality: "Town or postcode", mobile: "Mobile" },
+  faqs: [{ q: "Can the price change?", a: "No: the price quoted is the price you pay." }],
+} satisfies Text;

package/template/src/entities/content/model/fr.ts

@@ -0,0 +1,47 @@
+import type { StatusCopy } from "@evinvest/kitstart";
+import type { Facts, Text } from "./types";
+
+const status = (code: string, title: string, headline: readonly [string, string], body: string): StatusCopy<Facts> => ({
+  code,
+  title,
+  eyebrow: title.toUpperCase(),
+  headline,
+  body: () => body,
+  primary: "call",
+  secondary: "home",
+});
+
+export const FR = {
+  pages: {
+    home: { title: f => `Ménage à ${f.place}`, description: f => `Ménage à ${f.place} : un prix fixe annoncé avant de venir.` },
+    prices: { title: () => "Nos prix", description: f => `Tous nos prix à ${f.place}.` },
+  },
+  quoteForm: {
+    title: "Recevoir un prix",
+    lede: "Réponse dans l’heure.",
+    submit: "Recevoir le prix",
+    privacy: "Votre numéro ne sert qu’à vous répondre.",
+    reassurance: () => "Sans engagement.",
+    honeypotLabel: "Site web",
+  },
+  notFound: status("404", "Page introuvable", ["Cette page ", "n’existe pas."], "Le lien est peut-être ancien."),
+  serverError: status("500", "Erreur", ["Un problème ", "de notre côté."], "Réessayez dans un instant."),
+  thanks: status("✓", "Demande reçue", ["Merci, ", "nous vous rappelons."], "Nous avons bien reçu votre demande."),
+  callLabel: f => (f.phone ? `Appeler le ${f.phone}` : "Nous appeler"),
+  whatsappLabel: "WhatsApp",
+  whatsappShort: "WhatsApp",
+  whatsappMessage: f => `Bonjour, je vous contacte depuis la page de ${f.place}.`,
+  ctaShort: "Devis",
+  backHome: "Retour à l’accueil",
+  tryAgain: "Réessayer",
+  statusStrip: ["Prix fixe", "Sans engagement"],
+  langName: "Français",
+  facts: () => ["Brand SAS"],
+  hero: { title: f => `Le ménage à ${f.place}, à prix fixe.`, lede: "Un prix annoncé avant de venir." },
+  coverageTitle: "Où nous intervenons",
+  brandPage: { title: "Brand", description: "Le ménage à prix fixe.", open: "Ouvrir" },
+  contactLabel: "Nous contacter",
+  subjects: { standard: "Ménage courant", deep: "Grand ménage", other: "Autre" },
+  quoteLabels: { subject: "Prestation", locality: "Ville ou code postal", mobile: "Mobile" },
+  faqs: [{ q: "Le prix peut-il changer ?", a: "Non : le prix annoncé est celui que vous payez." }],
+} satisfies Text;

package/template/src/entities/content/model/types.ts

@@ -0,0 +1,37 @@
+import type { CopySlice, CoreText, Said as CoreSaid } from "@evinvest/kitstart";
+import type { Locale } from "@/shared/config/i18n";
+import type { Subject } from "@/shared/config/lead";
+import type { PageKey } from "@/shared/config/site";
+
+/**
+ * The facts a sentence may quote. Prose that names the phone or the place
+ * takes them as an argument, so the number in the sentence and the number on
+ * the card are one field.
+ */
+export interface Facts {
+  place: string;
+  /** `null` until the card has a phone. */
+  phone: string | null;
+}
+
+export type Said = CoreSaid<Facts>;
+
+/**
+ * Every string that differs between languages. It extends `CoreText`, the
+ * words the machinery prints; the rest is this brand's own sections. `FR` and
+ * `EN` are checked with `satisfies Text`, so a key in one and not the other is
+ * a compile error.
+ */
+export interface Text extends CoreText<PageKey, Facts> {
+  hero: { title: Said; lede: string };
+  /** The apex of a network of places: its `<head>` and the directory's link. */
+  brandPage: { title: string; description: string; open: string };
+  /** The contact bar's accessible name. */
+  contactLabel: string;
+  coverageTitle: string;
+  subjects: Record<Subject, string>;
+  quoteLabels: { subject: string; locality: string; mobile: string };
+  faqs: readonly { q: string; a: string }[];
+}
+
+export type Copy = CopySlice<Locale, Text, Facts>;

package/template/src/entities/place/api/load.ts

@@ -0,0 +1,12 @@
+import "server-only";
+import { createPlaceLoader } from "@evinvest/kitstart/next";
+import { places } from "@/shared/config/env";
+import { site } from "@/shared/config/site";
+
+/**
+ * The place and how its links are written, from the route params alone — the
+ * link mode is in the `[location]` param, so the page is cached (ISR).
+ * The words for it are composed a layer up (`views`), not here: an entity
+ * does not reach into a sibling slice.
+ */
+export const loadPlaceView = createPlaceLoader(site, places);

package/template/src/entities/place/index.ts

@@ -0,0 +1,3 @@
+// The place model is the package's; this slice binds it to the site. The
+// loader is server-only: `server.ts`.
+export type { Place, PlaceView } from "@evinvest/kitstart";

package/template/src/entities/place/server.ts

@@ -0,0 +1 @@
+export { loadPlaceView } from "./api/load";