create-ailk 0.8.0 → 0.10.0

package/release-scope.json

@@ -0,0 +1,25 @@
+{
+  "templates": {
+    "marketing-site-free": "released",
+    "marketing-site": "released",
+    "saas-product": "gated"
+  },
+  "shapes": {
+    "organization-product": "released",
+    "organization-service": "released",
+    "local-business-service": "released",
+    "person-service": "released",
+    "local-business-product": "deferred"
+  },
+  "designs": { "standard": "released", "minimalism": "gated" },
+  "modules": {
+    "marketing": "released",
+    "docs-blog": "released",
+    "scheduling": "released",
+    "signal-collectors": "released",
+    "workspace": "gated",
+    "multi-tenant": "gated",
+    "commerce": "gated"
+  },
+  "levels": { "free": "released", "pro": "released", "pro-plus": "gated" }
+}

package/site-templates/_base/content/en/UseCase/persona-1.mdx

@@ -1,7 +1,8 @@
 ---
 type: "UseCase"
 slug: "persona-1"
-title: "{Use case 1: the job this customer hires your product to do}"
+placeholder: true
+title: "{Use case 1: the job this customer hires your product or service to do}"
 description: "{Two sentences on who this customer is and the result they get}"
 sections:
   [
@@ -10,14 +11,14 @@ sections:
       "type": "hero",
       "data":
         {
-          "eyebrow": "Use cases",
-          "headline": "{Use case 1: the job this customer hires your product to do}",
+          "eyebrow": "Customers",
+          "headline": "{Use case 1: the job this customer hires your product or service to do}",
           "subheadline": "{Two sentences on who this customer is and the result they get}",
           "primaryCta": { "label": "{Primary CTA}", "href": "/contact" },
           "secondaryCta":
             {
               "label": "{Secondary CTA}",
-              "href": "/pricing",
+              "href": "/about",
               "variant": "outline",
             },
         },
@@ -27,7 +28,7 @@ sections:
       "type": "feature",
       "data":
         {
-          "headline": "{How this customer uses your product}",
+          "headline": "{How this customer uses your product or service}",
           "description": "{Two or three sentences on how it works and what changes for the reader}",
           "features":
             [
@@ -58,7 +59,7 @@ sections:
           "secondaryCta":
             {
               "label": "{Secondary CTA}",
-              "href": "/pricing",
+              "href": "/about",
               "variant": "outline",
             },
         },

package/site-templates/_base/content/en/UseCase/persona-2.mdx

@@ -1,7 +1,8 @@
 ---
 type: "UseCase"
 slug: "persona-2"
-title: "{Use case 2: the job this customer hires your product to do}"
+placeholder: true
+title: "{Use case 2: the job this customer hires your product or service to do}"
 description: "{Two sentences on who this customer is and the result they get}"
 sections:
   [
@@ -10,14 +11,14 @@ sections:
       "type": "hero",
       "data":
         {
-          "eyebrow": "Use cases",
-          "headline": "{Use case 2: the job this customer hires your product to do}",
+          "eyebrow": "Customers",
+          "headline": "{Use case 2: the job this customer hires your product or service to do}",
           "subheadline": "{Two sentences on who this customer is and the result they get}",
           "primaryCta": { "label": "{Primary CTA}", "href": "/contact" },
           "secondaryCta":
             {
               "label": "{Secondary CTA}",
-              "href": "/pricing",
+              "href": "/about",
               "variant": "outline",
             },
         },
@@ -27,7 +28,7 @@ sections:
       "type": "feature",
       "data":
         {
-          "headline": "{How this customer uses your product}",
+          "headline": "{How this customer uses your product or service}",
           "description": "{Two or three sentences on how it works and what changes for the reader}",
           "features":
             [
@@ -58,7 +59,7 @@ sections:
           "secondaryCta":
             {
               "label": "{Secondary CTA}",
-              "href": "/pricing",
+              "href": "/about",
               "variant": "outline",
             },
         },

package/site-templates/_base/content/en/UseCase/persona-3.mdx

@@ -1,7 +1,8 @@
 ---
 type: "UseCase"
 slug: "persona-3"
-title: "{Use case 3: the job this customer hires your product to do}"
+placeholder: true
+title: "{Use case 3: the job this customer hires your product or service to do}"
 description: "{Two sentences on who this customer is and the result they get}"
 sections:
   [
@@ -10,14 +11,14 @@ sections:
       "type": "hero",
       "data":
         {
-          "eyebrow": "Use cases",
-          "headline": "{Use case 3: the job this customer hires your product to do}",
+          "eyebrow": "Customers",
+          "headline": "{Use case 3: the job this customer hires your product or service to do}",
           "subheadline": "{Two sentences on who this customer is and the result they get}",
           "primaryCta": { "label": "{Primary CTA}", "href": "/contact" },
           "secondaryCta":
             {
               "label": "{Secondary CTA}",
-              "href": "/pricing",
+              "href": "/about",
               "variant": "outline",
             },
         },
@@ -27,7 +28,7 @@ sections:
       "type": "feature",
       "data":
         {
-          "headline": "{How this customer uses your product}",
+          "headline": "{How this customer uses your product or service}",
           "description": "{Two or three sentences on how it works and what changes for the reader}",
           "features":
             [
@@ -58,7 +59,7 @@ sections:
           "secondaryCta":
             {
               "label": "{Secondary CTA}",
-              "href": "/pricing",
+              "href": "/about",
               "variant": "outline",
             },
         },

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 nine-slide scroll-snap deck home with a mark-only navigation and a centred footer."
 colors:
   bg: "#ffffff"
   fg: "#000000"
@@ -15,6 +15,19 @@ colors:
   fg-dark: "#ffffff"
   border-dark: "#ffffff"
   brand-dark: "#ffffff"
+  text-muted-dark: "#cccccc"
+treatments:
+  corners: square
+  eyebrowCase: sentence
+  placeholders: fill
+  checkmarks: plain
+layout:
+  nav: mark-only
+  footer: centered
+  announcementBanner: false
+  home: deck
+copy:
+  density: sparse
 typography:
   display:
     fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif"
@@ -69,9 +82,12 @@ spacing:
   stays on-system.
   Edit the canonical file, never a copy — a test holds every copy to it.
 
-  The tokens above describe what the site RENDERS today. Colours come from
-  content/_site.mdx (`theme.colors`); type, radius and spacing are platform
-  defaults a site cannot override yet — see "Where this is heading" below.
+  The tokens above describe what the site RENDERS today. The design's own
+  colours and shape knobs live in content/_site.mdx `theme:`, which
+  `create-ailk apply-design` replaces wholesale; the owner's brand colours and
+  fonts live beside it in `brand.colors` and `brand.fonts`, which applying a
+  design never rewrites. Radius and spacing are platform defaults a site
+  cannot override yet — see "Where this is heading" below.
 -->
 
 # Minimalism
@@ -84,6 +100,27 @@ Every page is composed from the AI Launch Kit component library (`@working-theor
 
 ## Colors
 
+<!-- generated:begin colors -->
+
+| Key                 | Value     | Compiles to                                                                                                    |
+| ------------------- | --------- | -------------------------------------------------------------------------------------------------------------- |
+| `bg`                | `#ffffff` | `light.bg`                                                                                                     |
+| `fg`                | `#000000` | `light.text`                                                                                                   |
+| `surface`           | `#ffffff` | `light.surface`                                                                                                |
+| `surface-secondary` | `#ffffff` | `light.bgMuted`                                                                                                |
+| `border`            | `#000000` | `light.border`                                                                                                 |
+| `text-muted`        | `#333333` | `light.textMuted`                                                                                              |
+| `brand`             | `#000000` | `light.primary`                                                                                                |
+| `fg-on-brand`       | `#ffffff` | `light.primaryFg`                                                                                              |
+| `accent`            | `#000000` | `light.accent`                                                                                                 |
+| `bg-dark`           | `#000000` | `dark.bg`, `dark.bgMuted` (fallback of L1), `dark.surface` (fallback of L2), `dark.primaryFg` (fallback of L4) |
+| `fg-dark`           | `#ffffff` | `dark.text`                                                                                                    |
+| `border-dark`       | `#ffffff` | `dark.border`                                                                                                  |
+| `brand-dark`        | `#ffffff` | `dark.primary`, `dark.accent` (fallback of L5)                                                                 |
+| `text-muted-dark`   | `#cccccc` | `dark.textMuted`                                                                                               |
+
+<!-- generated:end -->
+
 ### Primary
 
 **Black** (`brand` `#000000`) fills the primary button; its label is white. The secondary button is white with a black hairline and black label.
@@ -100,6 +137,18 @@ Dark mode inverts: black ground, white ink, white rules, white primary button wi
 
 ## Typography
 
+<!-- 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` |
+
+<!-- generated:end -->
+
 System sans throughout; no web font.
 
 ### Hierarchy
@@ -118,10 +167,53 @@ The small label above a section heading is **kept** as part of this foundation's
 
 ## Layout
 
+<!-- generated:begin layout -->
+
+| Knob                 | Value       |
+| -------------------- | ----------- |
+| `nav`                | `mark-only` |
+| `footer`             | `centered`  |
+| `announcementBanner` | `false`     |
+| `home`               | `deck`      |
+
+| Spacing          | Value    |
+| ---------------- | -------- |
+| `section`        | `7rem`   |
+| `section-mobile` | `4rem`   |
+| `card`           | `1.5rem` |
+| `grid`           | `1.5rem` |
+| `container`      | `1280px` |
+| `measure`        | `36rem`  |
+
+<!-- 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.
 
+## Copy
+
+<!-- generated:begin copy -->
+
+Copy density: sparse — minimalism pages carry far fewer words than a standard site; keep every block to its headline and one sentence.
+<!-- generated:end -->
+
 ## Shapes
 
+<!-- generated:begin shapes -->
+
+| Rounded  | Value     |
+| -------- | --------- |
+| `button` | `0.5rem`  |
+| `card`   | `0.75rem` |
+
+| Treatment                 | Value      |
+| ------------------------- | ---------- |
+| `treatments.corners`      | `square`   |
+| `treatments.eyebrowCase`  | `sentence` |
+| `treatments.placeholders` | `fill`     |
+| `treatments.checkmarks`   | `plain`    |
+
+<!-- generated:end -->
+
 Square corners everywhere (`theme.corners: square`) — buttons, cards, the auth card, image placeholders; the tokens above are the base foundation's defaults a site overrides.
 
 ## Components
@@ -156,7 +248,7 @@ The foundation's pinned direction is the pacing of a classic wireframe marketing
 ## Do's and Don'ts
 
 - **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** change colours in `content/_site.mdx` `theme.colors`; they reach every section.
-- **Don't** add a colour accent. The foundation's one idea is black on white; a brand pass adds colour deliberately, through the theme.
+- **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** 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.

package/site-templates/designs/minimalism/sample/README.md

@@ -0,0 +1,48 @@
+# The `minimalism` design's home-deck sample
+
+> Narrative moved here from the retired minimalism template's `TEMPLATE-MANIFEST.md` when
+> that tree retired (spec 6892 D4/D5) — `minimalism` is a design, not a template, so it
+> carries no generated manifest of its own. This file is NOT installed onto a scaffold
+> (`installDesignSample` copies only `content/**` and `public/**`); it documents the sample for
+> maintainers of this design.
+
+The second Pro template (#5589) that first wore this design was a reports-first site whose home
+is a **nine-slide scroll-snap deck**, shaped after the reference captured in
+`docs/research/bondcap-capture/`. Structure and design are the reference; **the copy is not** —
+every line in `content/en/HomePage/home.mdx` is placeholder English of the same shape and length.
+
+`layout.home: "deck"` (the `minimalism` design's own layout knob) makes every direct section
+child of `home.mdx` one full-viewport snap target, in order. The mark is hidden on slide 1 (the
+deck-hero landing state) and revealed from slide 2 on.
+
+| #   | Slide             | Section                                                        | Ground                   | Action                                                     |
+| --- | ----------------- | -------------------------------------------------------------- | ------------------------ | ---------------------------------------------------------- |
+| 1   | Landing           | `hero` (`backdrop`)                                            | gradient band + backdrop | `{Primary CTA} →` → `/reports`, centered; 44px scroll cue. |
+| 2   | Tagline           | `content-block` (`align: center`, `fill: viewport`)            | light                    | —                                                          |
+| 3   | Our community     | `logoCloud` (`actions`)                                        | light                    | `Refer someone →` → `/referral`, bottom-centered at 44px   |
+| 4   | Reports headline  | `content-block` (`align: center`, `fill: viewport`)            | light                    | —                                                          |
+| 5   | Special reports   | `reports-list` (`list`, `tone: on-dark`)                       | dark (`gradient-dark`)   | four dated titles → `/reports/<slug>`                      |
+| 6   | Favorites         | `reports-list` (`list`, `tone: on-dark`)                       | dark (`gradient-dark`)   | year-only titles → `/reports/<slug>`                       |
+| 7   | Services headline | `content-block` (`align: center`, `fill: viewport`)            | light                    | `Hire me →` → `/meet`                                      |
+| 8   | Partners          | `team` (`with-large-images`, `hoverReveal`, `phoneColumns: 2`) | light                    | `About us →` → `/about`, bottom-centered at 44px           |
+| 9   | Closing           | `cta` (`minimal`)                                              | light                    | `Contact me →` → `/contact`, centered                      |
+
+## The site principle
+
+Every slide's action sits at the bottom, centered, at 44px or larger; grids are 2-up on a phone.
+This is held by bounded section props on the sections above, never by a `className` override or
+hand-rolled markup (`.claude/rules/frontend.md` § Chrome Composes Blocks).
+
+## The 11 SVGs
+
+`public/hero-backdrop.svg`, `public/wordmark-placeholder.svg`, three `public/logo-placeholder-*.svg`
+and six `public/avatar-placeholder-*.svg` — all placeholders, referenced only from this sample's
+`home.mdx` (the avatars are also referenced by the retired bespoke `AboutPage` seed, which did not
+move with this design — its team slide is the only remaining consumer). They ride with the design
+because the deck uses all 11; a shape/design pair that does not install this sample never ships
+them (D4).
+
+## Copy density
+
+This design declares `copy: { density: "sparse" }` in its `DESIGN.md` — its pages, this deck
+included, carry far fewer words than a standard site.

package/site-templates/{minimalism-site → designs/minimalism/sample}/content/en/HomePage/home.mdx

@@ -2,7 +2,7 @@
 type: "HomePage"
 slug: "home"
 title: "Your Company"
-description: "Placeholder home for the minimalism-site template — a nine-slide scroll-snap deck. Replace every line before you launch."
+description: "Placeholder home for the minimalism design — a nine-slide scroll-snap deck. Replace every line before you launch."
 sections:
   [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: Standard
-description: The standard design — the black-on-white foundation any shape wears by default: full navigation, a multi-column footer, the document-scroll home.
+description: "The standard design — the black-on-white foundation any shape wears by default: full navigation, a multi-column footer, the document-scroll home."
 colors:
   bg: "#ffffff"
   fg: "#000000"
@@ -15,6 +15,19 @@ colors:
   fg-dark: "#ffffff"
   border-dark: "#ffffff"
   brand-dark: "#ffffff"
+  text-muted-dark: "#cccccc"
+treatments:
+  corners: square
+  eyebrowCase: sentence
+  placeholders: fill
+  checkmarks: plain
+layout:
+  nav: full
+  footer: columns
+  announcementBanner: false
+  home: default
+copy:
+  density: standard
 typography:
   display:
     fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, sans-serif"
@@ -69,9 +82,12 @@ spacing:
   stays on-system.
   Edit the canonical file, never a copy — a test holds every copy to it.
 
-  The tokens above describe what the site RENDERS today. Colours come from
-  content/_site.mdx (`theme.colors`); type, radius and spacing are platform
-  defaults a site cannot override yet — see "Where this is heading" below.
+  The tokens above describe what the site RENDERS today. The design's own
+  colours and shape knobs live in content/_site.mdx `theme:`, which
+  `create-ailk apply-design` replaces wholesale; the owner's brand colours and
+  fonts live beside it in `brand.colors` and `brand.fonts`, which applying a
+  design never rewrites. Radius and spacing are platform defaults a site
+  cannot override yet — see "Where this is heading" below.
 -->
 
 # Standard
@@ -84,6 +100,27 @@ Every page is composed from the AI Launch Kit component library (`@working-theor
 
 ## Colors
 
+<!-- generated:begin colors -->
+
+| Key                 | Value     | Compiles to                                                                                                    |
+| ------------------- | --------- | -------------------------------------------------------------------------------------------------------------- |
+| `bg`                | `#ffffff` | `light.bg`                                                                                                     |
+| `fg`                | `#000000` | `light.text`                                                                                                   |
+| `surface`           | `#ffffff` | `light.surface`                                                                                                |
+| `surface-secondary` | `#ffffff` | `light.bgMuted`                                                                                                |
+| `border`            | `#000000` | `light.border`                                                                                                 |
+| `text-muted`        | `#333333` | `light.textMuted`                                                                                              |
+| `brand`             | `#000000` | `light.primary`                                                                                                |
+| `fg-on-brand`       | `#ffffff` | `light.primaryFg`                                                                                              |
+| `accent`            | `#000000` | `light.accent`                                                                                                 |
+| `bg-dark`           | `#000000` | `dark.bg`, `dark.bgMuted` (fallback of L1), `dark.surface` (fallback of L2), `dark.primaryFg` (fallback of L4) |
+| `fg-dark`           | `#ffffff` | `dark.text`                                                                                                    |
+| `border-dark`       | `#ffffff` | `dark.border`                                                                                                  |
+| `brand-dark`        | `#ffffff` | `dark.primary`, `dark.accent` (fallback of L5)                                                                 |
+| `text-muted-dark`   | `#cccccc` | `dark.textMuted`                                                                                               |
+
+<!-- generated:end -->
+
 ### Primary
 
 **Black** (`brand` `#000000`) fills the primary button; its label is white. The secondary button is white with a black hairline and black label.
@@ -100,6 +137,18 @@ Dark mode inverts: black ground, white ink, white rules, white primary button wi
 
 ## Typography
 
+<!-- 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` |
+
+<!-- generated:end -->
+
 System sans throughout; no web font.
 
 ### Hierarchy
@@ -118,10 +167,53 @@ The small label above a section heading is **kept** as part of this foundation's
 
 ## Layout
 
+<!-- generated:begin layout -->
+
+| Knob                 | Value     |
+| -------------------- | --------- |
+| `nav`                | `full`    |
+| `footer`             | `columns` |
+| `announcementBanner` | `false`   |
+| `home`               | `default` |
+
+| Spacing          | Value    |
+| ---------------- | -------- |
+| `section`        | `7rem`   |
+| `section-mobile` | `4rem`   |
+| `card`           | `1.5rem` |
+| `grid`           | `1.5rem` |
+| `container`      | `1280px` |
+| `measure`        | `36rem`  |
+
+<!-- generated:end -->
+
 Full navigation; a multi-column footer; the default home. The home-only announcement banner is off by default (`layout.announcementBanner`). 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.
 
+## Copy
+
+<!-- generated:begin copy -->
+
+Copy density: standard — pages carry the ordinary amount of body copy for their section.
+<!-- generated:end -->
+
 ## Shapes
 
+<!-- generated:begin shapes -->
+
+| Rounded  | Value     |
+| -------- | --------- |
+| `button` | `0.5rem`  |
+| `card`   | `0.75rem` |
+
+| Treatment                 | Value      |
+| ------------------------- | ---------- |
+| `treatments.corners`      | `square`   |
+| `treatments.eyebrowCase`  | `sentence` |
+| `treatments.placeholders` | `fill`     |
+| `treatments.checkmarks`   | `plain`    |
+
+<!-- generated:end -->
+
 Square corners everywhere (`theme.corners: square`) — buttons, cards, the auth card, image placeholders; the tokens above are the base foundation's defaults a site overrides.
 
 ## Components
@@ -156,8 +248,8 @@ The foundation's pinned direction is the pacing of a classic wireframe marketing
 ## Do's and Don'ts
 
 - **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** change colours in `content/_site.mdx` `theme.colors`; they reach every section.
-- **Don't** add a colour accent. The foundation's one idea is black on white; a brand pass adds colour deliberately, through the theme.
+- **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** 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.