create-ailk 0.12.1 → 0.14.0

package/dist/surfaces.js

@@ -299,6 +299,13 @@ export const GATEABLE_SURFACES = [
         routes: [`${ROUTE_ROOT}/software`],
         content: ["content/<locale>/SoftwareProduct"],
     },
+    {
+        // #7744 — the team profile pages, module-less: a roster row enables it,
+        // so only the organization shapes ship /team (person-service does not).
+        id: "team",
+        routes: [`${ROUTE_ROOT}/team`],
+        content: ["content/<locale>/TeamList", "content/<locale>/TeamMember"],
+    },
     {
         id: "tech-articles",
         routes: [`${ROUTE_ROOT}/tech-articles`],
@@ -583,6 +590,9 @@ export const ROUTE_SINCE = {
     "services/[slug]": "0.0.0",
     software: "0.0.0",
     "software/[slug]": "0.0.0",
+    // #7744 — the team profile pages, a new route pair at today's line.
+    team: "0.35.0",
+    "team/[slug]": "0.35.0",
     "tech-articles": "0.0.0",
     "tech-articles/[slug]": "0.0.0",
     terms: "0.22.0",
@@ -824,6 +834,8 @@ export const ROUTE_MESSAGE_NAMESPACES = {
     "(authed)/admin/site": ["admin"],
     "(authed)/admin/team": ["admin"],
     "(authed)/waitlist": ["waitlistDashboard.gate"],
+    // #7744 — the /team hub's empty state reads the `team` namespace.
+    team: ["team"],
 };
 /** Template-relative path of the generated site-nav registry. */
 export const NAV_CONFIG_PATH = "apps/web/lib/nav-config.ts";

package/dist/team-profiles.d.ts

@@ -0,0 +1,29 @@
+/**
+ * One people-slide / team-index member: the `team` section's member shape,
+ * declared here because create-ailk depends on neither
+ * `@working-theory/validation` nor `yaml`.
+ */
+export interface TeamSlideMember {
+    readonly name: string;
+    readonly role: string;
+    readonly links: readonly [
+        {
+            readonly type: "page";
+            readonly url: string;
+            readonly label: string;
+        }
+    ];
+}
+/**
+ * The three seeded people, in seed order: slug, the seed's `title` as `name`,
+ * "{Their title}", and a page link to `/team/<slug>` labelled "{View profile}".
+ */
+export declare const TEAM_SEED_MEMBERS: readonly (TeamSlideMember & {
+    readonly slug: string;
+})[];
+/**
+ * `TEAM_SEED_MEMBERS` whose `<siteRoot>/content/en/TeamMember/<slug>.mdx`
+ * exists (without `slug`), or `undefined` when none does (person-service, or
+ * a site that deleted them). Reads, never writes.
+ */
+export declare function teamSlideMembers(siteRoot: string): TeamSlideMember[] | undefined;

package/dist/team-profiles.js

@@ -0,0 +1,43 @@
+/**
+ * The seeded team (#7744 D8) — the one source of the three placeholder people
+ * the organization shapes ship.
+ *
+ * The `_base` layer installs one `TeamMember` profile per person at
+ * `/team/<slug>` and a `/team` index listing them (#7744 D4); minimalism's
+ * home seeds for the three organization shapes carry a `people` slide listing
+ * the same members, each linking to their profile. `team-profiles.test.ts`
+ * pins that every one of those seeds agrees with `TEAM_SEED_MEMBERS`.
+ *
+ * `node:fs` only: create-ailk ships one runtime dependency (`tar`), and its
+ * scaffold-time readers may not import `yaml` (see `design-package.ts`), so
+ * this module parses nothing — it only checks which profile files a site has.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+function seedMember(slug, ordinal) {
+    return {
+        slug,
+        name: `{${ordinal} team member's name}`,
+        role: "{Their title}",
+        links: [{ type: "page", url: `/team/${slug}`, label: "{View profile}" }],
+    };
+}
+/**
+ * The three seeded people, in seed order: slug, the seed's `title` as `name`,
+ * "{Their title}", and a page link to `/team/<slug>` labelled "{View profile}".
+ */
+export const TEAM_SEED_MEMBERS = [
+    seedMember("first-member", "First"),
+    seedMember("second-member", "Second"),
+    seedMember("third-member", "Third"),
+];
+/**
+ * `TEAM_SEED_MEMBERS` whose `<siteRoot>/content/en/TeamMember/<slug>.mdx`
+ * exists (without `slug`), or `undefined` when none does (person-service, or
+ * a site that deleted them). Reads, never writes.
+ */
+export function teamSlideMembers(siteRoot) {
+    const dir = join(siteRoot, "content", "en", "TeamMember");
+    const members = TEAM_SEED_MEMBERS.filter(({ slug }) => existsSync(join(dir, `${slug}.mdx`))).map(({ slug: _slug, ...member }) => member);
+    return members.length > 0 ? members : undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ailk",
-  "version": "0.12.1",
+  "version": "0.14.0",
   "description": "Scaffolder for AI Launch Kit — `pnpm create ailk@latest <dir>` produces a starter repo consuming @working-theory/* from npm (per ADR 0007).",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,8 +27,8 @@
     "tar": "^7.5.21"
   },
   "devDependencies": {
-    "@working-theory/schema": "0.34.1",
-    "@working-theory/templates": "0.34.1"
+    "@working-theory/schema": "0.36.0",
+    "@working-theory/templates": "0.36.0"
   },
   "repository": {
     "type": "git",

package/release-scope.json

@@ -11,7 +11,7 @@
     "person-service": "released",
     "local-business-product": "deferred"
   },
-  "designs": { "standard": "released", "minimalism": "gated" },
+  "designs": { "standard": "released", "minimalism": "released" },
   "modules": {
     "marketing": "released",
     "docs-blog": "released",

package/site-templates/_base/content/en/TeamList/team.mdx

@@ -0,0 +1,68 @@
+---
+type: "TeamList"
+slug: "team"
+title: "{The team} | {Company name}"
+description: "{One sentence on who the team is and the work they do together.}"
+sections:
+  [
+    {
+      "id": "team-hero",
+      "type": "hero",
+      "data":
+        {
+          "variant": "default",
+          "eyebrow": "{Team}",
+          "headline": "{The people behind the work.}",
+        },
+    },
+    {
+      "id": "team-members",
+      "type": "team",
+      "data":
+        {
+          "variant": "with-large-images",
+          "members":
+            [
+              {
+                "name": "{First team member's name}",
+                "role": "{Their title}",
+                "links":
+                  [
+                    {
+                      "type": "page",
+                      "url": "/team/first-member",
+                      "label": "{View profile}",
+                    },
+                  ],
+              },
+              {
+                "name": "{Second team member's name}",
+                "role": "{Their title}",
+                "links":
+                  [
+                    {
+                      "type": "page",
+                      "url": "/team/second-member",
+                      "label": "{View profile}",
+                    },
+                  ],
+              },
+              {
+                "name": "{Third team member's name}",
+                "role": "{Their title}",
+                "links":
+                  [
+                    {
+                      "type": "page",
+                      "url": "/team/third-member",
+                      "label": "{View profile}",
+                    },
+                  ],
+              },
+            ],
+        },
+    },
+  ]
+---
+
+{/* Placeholder copy — replace every {brace} with your own words before you launch. */}

package/site-templates/_base/content/en/TeamMember/first-member.mdx

@@ -0,0 +1,22 @@
+---
+type: "TeamMember"
+slug: "first-member"
+title: "{First team member's name}"
+description: "{One sentence on who they are and what they do here}"
+schema: { "jobTitle": "{Their title}" }
+sections:
+  [
+    {
+      "id": "profile",
+      "type": "content-block",
+      "data":
+        {
+          "imagerySlot": true,
+          "headline": "{First team member's name}",
+          "body": "{Two or three sentences on what they do here, and the work they are known for.} {One or two sentences on how they came to it, and what a client can expect working with them.}",
+        },
+    },
+  ]
+---
+
+{/* Placeholder copy — replace every {brace} with your own words before you launch. */}

package/site-templates/_base/content/en/TeamMember/second-member.mdx

@@ -0,0 +1,22 @@
+---
+type: "TeamMember"
+slug: "second-member"
+title: "{Second team member's name}"
+description: "{One sentence on who they are and what they do here}"
+schema: { "jobTitle": "{Their title}" }
+sections:
+  [
+    {
+      "id": "profile",
+      "type": "content-block",
+      "data":
+        {
+          "imagerySlot": true,
+          "headline": "{Second team member's name}",
+          "body": "{Two or three sentences on what they do here, and the work they are known for.} {One or two sentences on how they came to it, and what a client can expect working with them.}",
+        },
+    },
+  ]
+---
+
+{/* Placeholder copy — replace every {brace} with your own words before you launch. */}

package/site-templates/_base/content/en/TeamMember/third-member.mdx

@@ -0,0 +1,22 @@
+---
+type: "TeamMember"
+slug: "third-member"
+title: "{Third team member's name}"
+description: "{One sentence on who they are and what they do here}"
+schema: { "jobTitle": "{Their title}" }
+sections:
+  [
+    {
+      "id": "profile",
+      "type": "content-block",
+      "data":
+        {
+          "imagerySlot": true,
+          "headline": "{Third team member's name}",
+          "body": "{Two or three sentences on what they do here, and the work they are known for.} {One or two sentences on how they came to it, and what a client can expect working with them.}",
+        },
+    },
+  ]
+---
+
+{/* Placeholder copy — replace every {brace} with your own words before you launch. */}

package/site-templates/designs/minimalism/DESIGN.md

@@ -1,6 +1,6 @@
 ---
 name: Minimalism
-description: "The minimalism design — the same black-on-white foundation, presented as a nine-slide scroll-snap deck home with a mark-only navigation and a centred footer."
+description: "The minimalism design — the same black-on-white foundation, presented as a scroll-snap deck home (one slide per home section, the landing hero carrying the brand) with a mark-only navigation and a centred footer."
 colors:
   bg: "#ffffff"
   fg: "#000000"
@@ -21,39 +21,126 @@ treatments:
   eyebrowCase: sentence
   placeholders: fill
   checkmarks: plain
+  buttonShape: pill
+  typeScale: design
+  darkInk: accent
+  figures: display
 layout:
   nav: mark-only
   footer: centered
   announcementBanner: false
   home: deck
+  deckPresentation: true
+  innerPages: bare
+  colorMode: light
+  chromeStyle: minimal
+sections:
+  AboutPage:
+    content-block:
+      variant: profile
+  BlogList:
+    hero:
+      variant: centered
+  BookCall:
+    hero:
+      variant: centered
+  ContactPage:
+    hero:
+      variant: centered
+  FAQPage:
+    hero:
+      variant: centered
+  Feature:
+    hero:
+      variant: centered
+  FeaturesList:
+    hero:
+      variant: centered
+  GlossaryList:
+    hero:
+      variant: centered
+  HomePage:
+    hero:
+      variant: centered
+      fill: viewport
+    content-block:
+      variant: statement
+    items:
+      variant: list
+    logoCloud:
+      columns: 5
+      phoneColumns: 2
+      motion: scroll
+      treatment: silhouette
+      actionStyle: links
+    team:
+      variant: with-portraits
+    cta:
+      actionStyle: one-button
+  LandingPage:
+    hero:
+      variant: centered
+  NewsletterSignup:
+    hero:
+      variant: centered
+  PortfolioList:
+    hero:
+      variant: centered
+      surface: none
+      eyebrowTone: muted
+    items:
+      itemStyle: plain
+    faq:
+      surface: none
+    cta:
+      variant: minimal
+  Pricing:
+    hero:
+      variant: centered
+  ServicesList:
+    hero:
+      variant: centered
+    items:
+      itemStyle: plain
+  TeamMember:
+    content-block:
+      variant: profile
+  UseCase:
+    hero:
+      variant: centered
+  UseCasesList:
+    hero:
+      variant: centered
 copy:
   density: sparse
 typography:
   display:
     fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif"
-    fontSize: "3.5rem"
-    fontWeight: 700
+    fontSize: "2.8rem"
+    fontSizeMobile: "1.65rem"
+    fontWeight: 400
     lineHeight: 1.1
     letterSpacing: "normal"
   heading-section:
     fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif"
-    fontSize: "3rem"
-    fontWeight: 700
+    fontSize: "2.8rem"
+    fontSizeMobile: "1.65rem"
+    fontWeight: 400
     lineHeight: 1.1
     letterSpacing: "normal"
   heading-item:
-    fontSize: "2rem"
-    fontWeight: 700
+    fontSize: "1.6875rem"
+    fontWeight: 400
     lineHeight: 1.375
     letterSpacing: "normal"
   body:
     fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif"
-    fontSize: "1.125rem"
+    fontSize: "1.05rem"
     fontWeight: 400
-    lineHeight: 1.5
+    lineHeight: 1.6
   eyebrow:
-    fontSize: "0.875rem"
-    fontWeight: 600
+    fontSize: "1.5rem"
+    fontWeight: 400
     lineHeight: 1.4
     letterSpacing: "0.05em"
 rounded:
@@ -94,7 +181,9 @@ spacing:
 
 ## Overview
 
-The minimalism design is the standard foundation — the same black-on-white wireframe, the same type and the same components — presented as a deck. The home page is a nine-slide deck that snaps one slide per scroll, so the site reads like a presentation before it reads like a website; the rest of the site is quiet and document-like. Its character comes from structure, not a palette: it carries no theme of its own.
+The minimalism design is the standard foundation — the same black-on-white wireframe, the same type and the same components — presented as a deck. The home page is a deck: each home section is one slide, snapping one slide per scroll, and the landing hero carries the brand, so the site reads like a presentation before it reads like a website; the rest of the site is quiet and document-like. Its character comes from structure, not a palette: it carries no theme of its own.
+
+The deck presents slide by slide (`layout.deckPresentation: true`). Each slide fits the screen, and a slide with more to say scrolls inside itself, with its down chevron held in view at its foot. The pinned mark takes the ground of the slide under it, so it shows its dark variant over a dark slide. Each slide has its own link, `#slide-<name>`, which the address bar follows as the reader moves without adding a history entry. Slides fade in as they arrive, unless the reader has asked for reduced motion. Every slide's header is centred, and feature cards stack in one column on phones.
 
 Every page is composed from the AI Launch Kit component library (`@working-theory/ui`). Nothing is hand-built: a page is a list of registered sections, each with a bounded set of variants.
 
@@ -127,9 +216,9 @@ Every page is composed from the AI Launch Kit component library (`@working-theor
 
 ### Neutral
 
-Pure white ground (`bg` `#ffffff`), pure black ink for headings (`fg` `#000000`), and near-black `#333333` for body copy — well above AA on white. **Borders are black** (`#000000`): card outlines, the rule under the navigation, the rules between sections and the rule above the footer are all 1px black lines. Cards are white, not tinted (`surface-secondary` is white too). There is no accent colour — `accent` is black.
+Pure white ground (`bg` `#ffffff`), pure black ink for headings (`fg` `#000000`), and near-black `#333333` for body copy — well above AA on white. **Borders are black** (`#000000`): card outlines, the rule under the navigation (not on the deck home), the rules between sections and the rule above the footer (not on the deck home) are all 1px black lines. Cards are white, not tinted (`surface-secondary` is white too). There is no accent colour — `accent` is black.
 
-Dark mode inverts: black ground, white ink, white rules, white primary button with black label.
+The site is light only (`layout.colorMode: light`, #7742): it shows no theme switch and ignores the reader's system preference. Dark appears only as a deck ground, where a slide inverts: black ground, white ink, white rules, white primary button with black label.
 
 ### Named Rules
 
@@ -139,13 +228,13 @@ Dark mode inverts: black ground, white ink, white rules, white primary button wi
 
 <!-- generated:begin typography -->
 
-| Role              | Family                                                                   | Size       | Weight | Line height | Tracking |
-| ----------------- | ------------------------------------------------------------------------ | ---------- | ------ | ----------- | -------- |
-| `display`         | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `3.5rem`   | 700    | 1.1         | `normal` |
-| `heading-section` | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `3rem`     | 700    | 1.1         | `normal` |
-| `heading-item`    | —                                                                        | `2rem`     | 700    | 1.375       | `normal` |
-| `body`            | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `1.125rem` | 400    | 1.5         | —        |
-| `eyebrow`         | —                                                                        | `0.875rem` | 600    | 1.4         | `0.05em` |
+| Role              | Family                                                                   | Size        | Weight | Line height | Tracking |
+| ----------------- | ------------------------------------------------------------------------ | ----------- | ------ | ----------- | -------- |
+| `display`         | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `2.8rem`    | 400    | 1.1         | `normal` |
+| `heading-section` | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `2.8rem`    | 400    | 1.1         | `normal` |
+| `heading-item`    | —                                                                        | `1.6875rem` | 400    | 1.375       | `normal` |
+| `body`            | `system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif` | `1.05rem`   | 400    | 1.6         | —        |
+| `eyebrow`         | —                                                                        | `1.5rem`    | 400    | 1.4         | `0.05em` |
 
 <!-- generated:end -->
 
@@ -153,15 +242,15 @@ System sans throughout; no web font.
 
 ### Hierarchy
 
-| Role            | Size     | Weight | Notes                                                                                 |
-| --------------- | -------- | ------ | ------------------------------------------------------------------------------------- |
-| Hero headline   | 3.5rem   | 700    | Normal tracking, line-height 1.1; 2.5rem below 1024px                                 |
-| Section heading | 3rem     | 700    | Normal tracking, line-height 1.1; 2.25rem below 1024px, always under the hero         |
-| Item heading    | 2rem     | 700    | Card, feature and step titles; 1.5rem below 1024px                                    |
-| Body            | 1.125rem | 400    | `#333333`, line-height 1.5; section copy capped at 36rem (about 70 characters a line) |
-| Section label   | 0.875rem | 600    | Uppercase, +0.05em tracking today — the small label above a section heading           |
+| Role            | Size      | Weight | Notes                                                                                                |
+| --------------- | --------- | ------ | ---------------------------------------------------------------------------------------------------- |
+| Hero headline   | 2.8rem    | 400    | Normal tracking, line-height 1.1; 1.65rem below 1024px                                               |
+| Section heading | 2.8rem    | 400    | Normal tracking, line-height 1.1; 1.65rem below 1024px — a statement, the same size as the hero      |
+| Item heading    | 1.6875rem | 400    | Card, feature and step titles; 1.5rem below 1024px                                                   |
+| Body            | 1.05rem   | 400    | `#333333`, line-height 1.6; content-block body copy capped at 36rem (about 70 characters a line)     |
+| Section label   | 1.5rem    | 400    | Sentence case, 400, 1.5rem, the body face — the label above a section heading, larger than body copy |
 
-Measured from the rendered scaffold (1440px and 390px wide), not transcribed from tokens. Bold headings at normal tracking follow the foundation's pinned direction (#6493).
+Measured from the rendered scaffold (1440px and 390px wide), not transcribed from tokens. Every heading — hero, statement, list title and person name — is set at 400 at normal tracking, as on the bondcap reference; stat figures take the display face at 400 with no gradient. The design compiles these sizes and weights into the site's `theme:` (`treatments.typeScale: design`, `treatments.figures: display`).
 
 The small label above a section heading is **kept** as part of this foundation's voice (operator-disposed 2026-09-22) and is headed toward the treatment below.
 
@@ -175,6 +264,9 @@ The small label above a section heading is **kept** as part of this foundation's
 | `footer`             | `centered`  |
 | `announcementBanner` | `false`     |
 | `home`               | `deck`      |
+| `innerPages`         | `bare`      |
+| `colorMode`          | `light`     |
+| `chromeStyle`        | `minimal`   |
 
 | Spacing          | Value    |
 | ---------------- | -------- |
@@ -187,7 +279,22 @@ The small label above a section heading is **kept** as part of this foundation's
 
 <!-- generated:end -->
 
-Home is the `deck` layout: nine full-viewport slides with scroll-snap. The navigation is `mark-only`, the footer is `centered`, and there is no announcement banner (`layout.home: deck`, `layout.nav: mark-only`, `layout.footer: centered` — the design's own knobs, which any template on this design gets without declaring a `layout`). Every page this site carries is listed in its roster of record, `.ailk-site-manifest.json` at the site root. Shared foundation: a 1280px container, sections at 7rem (4rem below 1024px), card grids at 1.5rem, breakpoints 320 / 768 / 1024 / 1440.
+Home is the `deck` layout: one full-viewport slide per home section, with scroll-snap. The landing is bondcap's first slide, and it carries the brand: the site's wordmark (`/wordmark.svg`, or the home hero's own `lockup`) sits in the headline's place, centred in a viewport-filling band, with one action below it drawn as a pill whatever the corner treatment, and the deck's chevron at its foot. The home hero's `backdrop` image, when one is set, fills the slide behind them; with none the slide is a clean band in its own ground. The hero's other copy does not show on slide 1, so it belongs on slide 2. The design writes this as its HomePage hero preset (`variant: centered`, `fill: viewport`); an owner who wants a different first slide sets another hero variant, which keeps its own composition and shows the logomark instead. Either way the landing carries the brand, so the header is bare on slide 1 and reveals the mark from slide 2. The header stays bare on every slide: no bar, no rule and no buttons, only the logomark, centred. Each slide is one full viewport with its content centred vertically, and a chevron button at its foot moves to the next slide, and the last slide's up-chevron returns to the first; with reduced motion the move is instant. The footer is the closing slide: one viewport tall, holding only the wordmark, at most two contact lines (the business's town and region, and its contact email) and one muted legal line (`layout.chromeStyle: minimal`, #7742). There is no Sign in or Sign up anywhere on the home; they sit in every inner page's footer. One wheel notch or one swipe moves exactly one slide; there is no animated transition, and with reduced motion the deck scrolls freely. The navigation is `mark-only`, the footer is `centered`, and there is no announcement banner (`layout.home: deck`, `layout.nav: mark-only`, `layout.footer: centered` — the design's own knobs, which any template on this design gets without declaring a `layout`). Every page this site carries is listed in its roster of record, `.ailk-site-manifest.json` at the site root. Shared foundation: a 1280px container, sections at 7rem (4rem below 1024px), card grids at 1.5rem, breakpoints 320 / 768 / 1024 / 1440. On a new site, the home starts as the design's arc — landing, who we are, proof where the site has logos, how we work, what we offer, why us, the person on a solo site — every line a placeholder.
+
+## Page treatments
+
+Minimalism renders two kinds of page. These are the bondcap checklist's § A, word for word; its § B and § C are the deck rules, its § E type, ink and buttons, and its § F chrome and system pages.
+
+<!-- prettier-ignore -->
+| Treatment | Pages | What applies |
+|---|---|---|
+| Presentation | The home deck; any page an owner marks as a statement page | § B, § C, § E |
+| Document | Pricing, service and product detail, FAQ, glossary, blog, docs, legal, contact, about (for a person-service site, see § D) | § E, § F |
+
+A1. On a document page, body content stays left-aligned for reading, and a section may carry more than one action (one per pricing tier, for example).
+A2. A site can keep a standard-style section look on any page type, through the design's per-page-type section presets.
+
+A document page's title is centred through this design's per-page-type presets: every inner page type that places a hero carries `hero: { variant: centered }` in the `sections:` block above (F2).
 
 ## Copy
 
@@ -211,6 +318,10 @@ Copy density: sparse — minimalism pages carry far fewer words than a standard
 | `treatments.eyebrowCase`  | `sentence` |
 | `treatments.placeholders` | `fill`     |
 | `treatments.checkmarks`   | `plain`    |
+| `treatments.buttonShape`  | `pill`     |
+| `treatments.typeScale`    | `design`   |
+| `treatments.darkInk`      | `accent`   |
+| `treatments.figures`      | `display`  |
 
 <!-- generated:end -->
 
@@ -220,7 +331,18 @@ Square corners everywhere (`theme.corners: square`) — buttons, cards, the auth
 
 ### Buttons
 
-Primary: black fill, white label, 0.5rem corners. Secondary: transparent with a black 1px outline and black label. Both are the library `Button`.
+One shape: every button is a pill (`theme.buttonShape: pill`), while text fields keep the square corners. Primary: black fill, white label. Secondary: transparent with a black 1px outline and black label. Both are the library `Button`. A home slide carries at most one button; any other action on it is a text link.
+
+### Section looks
+
+The deck home's sections take these looks from the design's `sections` presets; a document page keeps its sections' own looks and every action.
+
+- **Statement** — `content-block` `variant: statement`: one centred display-size headline, two lines at most, nothing else.
+- **List** — `items` `variant: list`: centred display-size rows with no rules and a generous row gap, each row a link, accent ink on a dark slide. A headline with no eyebrow is set as the slide's small section label above the rows.
+- **Logo wall** — `logoCloud` `columns: 5`, `phoneColumns: 2`, `motion: scroll`, `treatment: silhouette`: five columns (two on phones) in one ink, drifting slowly upward between faded edges; `actionStyle: links` makes "View all" a text link.
+- **Portraits** — `team` `variant: with-portraits`: frameless portraits, three columns (two on phones), the grid and a short last row centred, names on hover and focus at desktop width and beneath each portrait on phones, each portrait a link.
+- **One button** — `cta` `actionStyle: one-button`: the first action stays a button, the second is a text link.
+- **Archive** (opt-in, not preset) — `reports-list` `variant: archive`: a centred grid of report links, five per row (three on phones), the last row centred, at the list's row gap; a headline with no eyebrow is the section label.
 
 ### Cards / Containers
 
@@ -228,7 +350,15 @@ White panels with a black 1px outline, 0.75rem corners, `card` (1.5rem) padding.
 
 ### Navigation
 
-Mark-only: the logomark alone, top left. No link row and no buttons in the header.
+Mark-only: no link row. On the deck home the header is bare: no bar, no rule and no buttons, only the logomark, centred, revealed from slide 2. Every other page wears the bare header too (`layout.innerPages: bare`, #7742): a back arrow to the home and the logomark, no rule and no buttons. Sign in / Sign up (the Account link when signed in) move to that page's one-bar footer.
+
+### Footer
+
+On the deck home the footer is the deck's closing slide (#7742): one viewport tall with its content centred, the wordmark (an image wordmark at the display size), at most two contact lines and one muted legal line (copyright, Privacy, Terms, Cookie settings, FAQ), and an up-chevron button at its foot that returns to the first slide. No nav links, social icons, theme switch, language switcher or Sign in / Sign up. Every other page ends in one bar: the copyright, the legal links and Sign in / Sign up (the Account link when signed in). The cookie banner sits on the page ground with a hairline above it and no shadow, and the deck's chevron rises above it while it shows.
+
+### Index and profile pages
+
+The portfolio and services index pages are the label and title centred on the page ground, then the listing unboxed: no grey band, no tinted tile and no card frame. The About page and each team member's page (`/team/<slug>`) are profiles: the name centred and large, the bio on the left and a frameless portrait on the right, stacked portrait first on a phone. These are the design's section presets (`sections:` above).
 
 ## Where this is heading
 
@@ -237,7 +367,7 @@ The foundation's pinned direction is the pacing of a classic wireframe marketing
 | Trait                                                  | How it is set                                                                                     |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
 | Square corners on buttons, cards and inputs            | `theme.corners: square` in `_site.mdx`                                                            |
-| Section label in sentence case, bold, no tracking      | `theme.eyebrowCase: sentence`                                                                     |
+| Section label in sentence case, no tracking            | `theme.eyebrowCase: sentence`                                                                     |
 | Solid grey image placeholders, no outline              | `theme.placeholders: fill`                                                                        |
 | Bare check and cross marks, no circle badge            | `theme.checkmarks: plain`                                                                         |
 | Plain, uncarded feature and step items                 | per section: `itemStyle: plain`, and `variant: steps` for an image beside a numbered list         |
@@ -249,6 +379,6 @@ The foundation's pinned direction is the pacing of a classic wireframe marketing
 
 - **Do** keep every page built from registered sections. If a section you need does not exist, request it rather than writing one-off markup.
 - **Do** set your brand colours (`primary`, `primaryFg`, `accent`, per mode) in `content/_site.mdx` `brand.colors` and your fonts (`display`, `body`) in `brand.fonts`; they reach every section and survive applying another design, which replaces `theme:`.
-- **Don't** add a colour accent. The foundation's one idea is black on white; a brand pass adds colour deliberately, through `brand.colors`.
+- **Don't** add a colour accent to a light ground. The foundation's one idea is black on white; a brand pass adds colour deliberately, through `brand.colors`. `accent` is the ink of headings and labels on a dark ground (`treatments.darkInk: accent`); its value is the site's own, `brand.colors.dark.accent`, and it defaults to white.
 - **Don't** replace a black rule with a shadow or a grey fill.
 - **Don't** hard-code the "heading toward" values above into a page. They arrive through the platform, or not at all.