create-ailk 0.7.0 → 0.9.0

package/site-templates/shapes/local-business-service/TEMPLATE-MANIFEST.md

@@ -0,0 +1,356 @@
+# Template manifest — `local-business-service`
+
+> The Free `local-business-service` shape starter (#6757, roadmap § 6 Phase 2) — a local business selling a service in one service area, scaffolded keyless with no `--template` alias of its own. Generated file: the regions between `<!-- generated:begin <id> -->` and `<!-- generated:end -->` are produced by `scripts/build-template-manifest.mjs --template local-business-service --check` from the composed layer stack (this tree → `_base` → the always-copied overlay), each roster row's MDX `sections[]`, and `component-catalog.json`. Everything outside the markers is written by hand.
+
+| Field                  | Value                                                                                                                                      |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| Starter                | `local-business-service` (a `SHAPE_STARTERS` entry, not a `--template` alias)                                                              |
+| Level                  | Free (derived from `requires` — `marketing` only; never declared)                                                                          |
+| `requires`             | `[marketing]`                                                                                                                              |
+| `extends`              | `_base` — lineage only, never level                                                                                                        |
+| Delivery               | keyless — ships in the tarball at `site-templates/shapes/local-business-service/`                                                          |
+| Sample content posture | every line of copy is a **placeholder**; no seed carries a price (D4)                                                                      |
+| `mainEntity`           | `LocalBusiness` (this shape's own — the overlay `_site.mdx` keeps `siteIdentity.kind: Organization`; the owner sets `kind: LocalBusiness`) |
+
+## 1. Chrome
+
+This starter declares **no `layout` block** — the default marketing chrome.
+
+### Layout knobs (#5612)
+
+<!-- generated:begin layout -->
+
+| Knob                 | Value     |
+| -------------------- | --------- |
+| `nav`                | `full`    |
+| `footer`             | `columns` |
+| `announcementBanner` | `false`   |
+| `home`               | `default` |
+
+<!-- generated:end -->
+
+### Theme (locked)
+
+<!-- generated:begin theme -->
+
+| Setting                  | Value      |
+| ------------------------ | ---------- |
+| `corners`                | `square`   |
+| `eyebrowCase`            | `sentence` |
+| `placeholders`           | `fill`     |
+| `checkmarks`             | `plain`    |
+| `colors.light.bg`        | `#ffffff`  |
+| `colors.light.bgMuted`   | `#ffffff`  |
+| `colors.light.surface`   | `#ffffff`  |
+| `colors.light.border`    | `#000000`  |
+| `colors.light.text`      | `#000000`  |
+| `colors.light.textMuted` | `#333333`  |
+| `colors.light.primary`   | `#000000`  |
+| `colors.light.primaryFg` | `#ffffff`  |
+| `colors.light.accent`    | `#000000`  |
+| `colors.dark.bg`         | `#000000`  |
+| `colors.dark.bgMuted`    | `#000000`  |
+| `colors.dark.surface`    | `#000000`  |
+| `colors.dark.border`     | `#ffffff`  |
+| `colors.dark.text`       | `#ffffff`  |
+| `colors.dark.textMuted`  | `#cccccc`  |
+| `colors.dark.primary`    | `#ffffff`  |
+| `colors.dark.primaryFg`  | `#000000`  |
+| `colors.dark.accent`     | `#ffffff`  |
+
+<!-- generated:end -->
+
+## 2. Pages
+
+One `page=<route>` region per roster row, generated from the seed file the composed layer stack lands for that route.
+
+`/`:
+
+<!-- generated:begin page=/ -->
+
+| #   | Section                                                    | Component | Copy (first line)                                               |
+| --- | ---------------------------------------------------------- | --------- | --------------------------------------------------------------- |
+| 1   | `hero` (centered · eyebrow "{Your service area}" · 2 CTAs) | `Hero`    | {One line on the job you do and the trust it takes to hire you} |
+| 2   | `items` (columns=3 · items ×3)                             | `Items`   | What we do                                                      |
+| 3   | `cta` (minimal · 2 CTAs)                                   | `CTA`     | Ready to get started?                                           |
+
+<!-- generated:end -->
+
+`/services`:
+
+<!-- generated:begin page=/services -->
+
+| #   | Section                                | Component | Copy (first line)    |
+| --- | -------------------------------------- | --------- | -------------------- |
+| 1   | `hero` (centered · eyebrow "Services") | `Hero`    | Three jobs, one crew |
+| 2   | `items` (columns=3 · items ×3)         | `Items`   | What we do           |
+| 3   | `cta` (minimal · 1 CTA)                | `CTA`     | Not sure which one?  |
+
+<!-- generated:end -->
+
+`/services/[slug]`:
+
+<!-- generated:begin page=/services/[slug] -->
+
+_Detail route over `content/en/Service/` — 3 seed pages: `first-job.mdx`, `second-job.mdx`, `third-job.mdx`._
+<!-- generated:end -->
+
+`/for` (the persona hub — every shape carries the family now, #6878 D7):
+
+<!-- generated:begin page=/for -->
+
+| #   | Section                                                  | Component      | Copy (first line)                                                 |
+| --- | -------------------------------------------------------- | -------------- | ----------------------------------------------------------------- |
+| 1   | `hero` (eyebrow "Customers" · 2 CTAs)                    | `Hero`         | {Customers: who your product or service is for}                   |
+| 2   | `items` (columns=3 · items ×3)                           | `Items`        | {The jobs customers hire your product or service to do}           |
+| 3   | `logoCloud` (layout=inline · logos ×6)                   | `LogoCloud`    | Don’t just take our word for it                                   |
+| 4   | `testimonials` (quote · items ×1)                        | `Testimonials` | {A customer quote, in their own words, about the result they got} |
+| 5   | `cta` (box · checklist ×3 · 2 CTAs · closingLine)        | `CTA`          | {Switch to your product or service in time amount or less}        |
+| 6   | `faq` (accordion · items ×5 · 1 CTA · initialOpen first) | `FAQ`          | FAQs                                                              |
+
+<!-- generated:end -->
+
+`/for/[slug]`:
+
+<!-- generated:begin page=/for/[slug] -->
+
+_Detail route over `content/en/UseCase/` — 3 seed pages: `persona-1.mdx`, `persona-2.mdx`, `persona-3.mdx`._
+<!-- generated:end -->
+
+`/about`:
+
+<!-- generated:begin page=/about -->
+
+| #   | Section                                    | Component      | Copy (first line)                                  |
+| --- | ------------------------------------------ | -------------- | -------------------------------------------------- |
+| 1   | `content-block` (narrow · eyebrow "About") | `ContentBlock` | {A small crew, the same neighborhoods, every week} |
+| 2   | `cta` (minimal · 2 CTAs)                   | `CTA`          | Want us to take a look?                            |
+
+<!-- generated:end -->
+
+`/contact` (always-copied overlay seed):
+
+<!-- generated:begin page=/contact -->
+
+| #   | Section                                                   | Component | Copy (first line)                         |
+| --- | --------------------------------------------------------- | --------- | ----------------------------------------- |
+| 1   | `hero` (split · eyebrow "Contact" · checklist ×3 · 1 CTA) | `Hero`    | Get every message in your email, free     |
+| 2   | `items` (tiles · columns=2 · items ×4)                    | `Items`   | {Add appointment scheduling to your site} |
+
+<!-- generated:end -->
+
+`/faq` (always-copied overlay seed):
+
+<!-- generated:begin page=/faq -->
+
+| #   | Section                                                 | Component | Copy (first line)                        |
+| --- | ------------------------------------------------------- | --------- | ---------------------------------------- |
+| 1   | `hero` (gapBelow=tight · eyebrow "FAQ")                 | `Hero`    | FAQs                                     |
+| 2   | `faq` (accordion · items ×5 · 1 CTA · initialOpen none) | `FAQ`     | {A question your customers actually ask} |
+| 3   | `faq` (accordion · items ×5 · 1 CTA · initialOpen none) | `FAQ`     | {A second group of questions}            |
+
+<!-- generated:end -->
+
+`/glossary`, `/newsletter` (base-layer seeds every starter carries, #6658 D5 — `/newsletter` is this tree's own byte copy of the Free newsletter, D4/D9), plus the always-copied overlay's `/meet` hub and `/meet/[slug]` BookCall detail seeds (#6897 D3-D5):
+
+<!-- generated:begin page=/glossary -->
+
+| #   | Section                             | Component       | Copy (first line)                            |
+| --- | ----------------------------------- | --------------- | -------------------------------------------- |
+| 1   | `hero` (eyebrow "Glossary" · 1 CTA) | `Hero`          | {Glossary: the terms your customers look up} |
+| 2   | `glossary-index` (columns)          | `GlossaryIndex` | {Terms, A to Z}                              |
+
+<!-- generated:end -->
+
+<!-- generated:begin page=/newsletter -->
+
+| #   | Section                                | Component | Copy (first line)                       |
+| --- | -------------------------------------- | --------- | --------------------------------------- |
+| 1   | `hero` (eyebrow "Newsletter" · 2 CTAs) | `Hero`    | {Start a free newsletter with Substack} |
+| 2   | `faq` (expanded · items ×3)            | `FAQ`     | FAQs                                    |
+
+<!-- generated:end -->
+
+<!-- generated:begin page=/meet -->
+
+| #   | Section                                | Component | Copy (first line)     |
+| --- | -------------------------------------- | --------- | --------------------- |
+| 1   | `hero` (eyebrow "Meet")                | `Hero`    | {Book a time with us} |
+| 2   | `items` (tiles · columns=2 · items ×4) | `Items`   |                       |
+
+<!-- generated:end -->
+
+<!-- generated:begin page=/meet/[slug] -->
+
+| #   | Section                                | Component      | Copy (first line)                                |
+| --- | -------------------------------------- | -------------- | ------------------------------------------------ |
+| 1   | `hero` (eyebrow "Book a Call" · 1 CTA) | `Hero`         | Book a Call                                      |
+| 2   | `cta` (box · 1 CTA)                    | `CTA`          | {What booking a call would do for your visitors} |
+| 3   | `items` (columns=3 · items ×3)         | `Items`        | What happens on the call?                        |
+| 4   | `content-block` (1 CTA)                | `ContentBlock` |                                                  |
+
+<!-- generated:end -->
+
+`/sign-in`, `/sign-up` (code routes — the `SignInCard` island and the sign-up form inside the locale layout, whose header links both; listed so the manifest is a complete install record, #6797):
+
+<!-- generated:begin page=/sign-in -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+<!-- generated:begin page=/sign-up -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/purchase-policy` (this tree's own service-shape override — cancellation and refunds, D4):
+
+<!-- generated:begin page=/purchase-policy -->
+
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Purchase Policy   |
+
+<!-- generated:end -->
+
+`/privacy`, `/terms` (base-layer seeds):
+
+<!-- generated:begin page=/privacy -->
+
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Privacy Policy    |
+
+<!-- generated:end -->
+
+<!-- generated:begin page=/terms -->
+
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Terms of Service  |
+
+<!-- generated:end -->
+
+`/blog` (the Free teaser row, § 1.8 — served by the generic `[slug]` route over the always-copied overlay's `BlogList/blog.mdx`):
+
+<!-- generated:begin page=/blog -->
+
+| #   | Section                                                      | Component      | Copy (first line)                                                 |
+| --- | ------------------------------------------------------------ | -------------- | ----------------------------------------------------------------- |
+| 1   | `hero` (centered · gapBelow=tight · eyebrow "Blog" · 2 CTAs) | `Hero`         | Get free blog/docs from Fumadocs                                  |
+| 2   | `blog-list` (grid)                                           | `BlogList`     |                                                                   |
+| 3   | `logoCloud` (layout=inline · logos ×6)                       | `LogoCloud`    | Don’t just take our word for it                                   |
+| 4   | `testimonials` (quote · items ×1)                            | `Testimonials` | {A customer quote, in their own words, about the result they got} |
+
+<!-- generated:end -->
+
+`/portfolio` (this tree's own override of the `_base` seed — both primary CTAs point at `/contact`, D4):
+
+<!-- generated:begin page=/portfolio -->
+
+| #   | Section                                                                                                    | Component | Copy (first line)                           |
+| --- | ---------------------------------------------------------------------------------------------------------- | --------- | ------------------------------------------- |
+| 1   | `hero` (default · gapBelow=tight · size=display · surface=wash-secondary · eyebrow "{Portfolio}" · 2 CTAs) | `Hero`    | {The work, before and after.}               |
+| 2   | `items` (tile · surface=none · columns=2 · items ×4)                                                       | `Items`   |                                             |
+| 3   | `cta` (beam · chips ×3 · 2 CTAs)                                                                           | `CTA`     | {Is your property the before or the after?} |
+| 4   | `faq` (centered · surface=gray-100 · accordion · items ×3 · initialOpen first)                             | `FAQ`     | Frequently Asked Questions                  |
+
+<!-- generated:end -->
+
+`/portfolio/[slug]`:
+
+<!-- generated:begin page=/portfolio/[slug] -->
+
+_Detail route over `content/en/PortfolioItem/` — 4 seed pages: `sample-four.mdx`, `sample-one.mdx`, `sample-three.mdx`, `sample-two.mdx`._
+<!-- generated:end -->
+
+### 3a. Differences from the standard `local-business-service` derivation
+
+The standard page set for this shape (`derive-roster.py --shape local-business-service --primary-goal generate-leads --registry packages/schema/src/registry/entries.ts`, harness commit `7bdaf148e1b0e639cd90a80008955e55cc4aa2b5`) is 36 rows, `mainEntity: LocalBusiness`. This starter's roster is that set minus the standard rows the table below drops, plus the rows the table after it adds, each with a reason.
+
+**Standard rows dropped:**
+
+| Standard row                                                         | Reason                                                                                                           |
+| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `TeamList` · `TeamMember`                                            | a placeholder starter has no team to list; `/about` carries the people                                           |
+| `CareersList` · `JobPosting`                                         | a placeholder starter has no open roles                                                                          |
+| `PartnersList` · `Partner`                                           | a placeholder starter has no partners to list                                                                    |
+| `ProjectsList` · `Project`                                           | the portfolio pair (`/portfolio`) is the proof of past work; `/projects` is the signal-collectors sample listing |
+| `Pricing`                                                            | a service is priced on its own `Service` page (or quoted), not on a pricing table                                |
+| `CaseStudiesList` · `CaseStudy` · `TestimonialsList` · `ClientsList` | proof pages need real customers (the #6658 reason)                                                               |
+| `EventsList` · `Event` · `DownloadsList`                             | a placeholder starter has no events or downloads                                                                 |
+| `ResourcesHub` · `ResourceDetail` · `HowTo` · `Whitepaper`           | the Resources content system is the goal-driven default a site grows into, not a starter page                    |
+| `LocationsList` · `Location` · `ServiceAreaPage`                     | a placeholder starter is one location; `/contact` carries the address and the area served                        |
+
+**Rows added:**
+
+| Row added                         | Reason                                                                                                                                                                                                                        |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `PurchasePolicyPage`              | every shape carries one purchase policy with its shape's sections — service: cancellation and refunds (#6646 D3)                                                                                                              |
+| `PortfolioList` · `PortfolioItem` | the portfolio pair belongs to every shape's standard roster (operator, 2026-09-25; roadmap § 4)                                                                                                                               |
+| `BlogList`                        | every Free scaffold's nav links `/blog` unconditionally (`renderNavConfig`, operator ruling 2026-09-23); the Free teaser serves it, as on organization-product (§ 1.8)                                                        |
+| `LandingPage`                     | the Free `/meet` meeting-types hub is a LandingPage seed, the same generic `[slug]` route serves it through (#6897 D3); the four `/meet/[slug]` BookCall detail seeds ride the `BookCall` type already in the standard roster |
+
+`|S − D| = 13` and `|R| = 18`.
+
+`/sign-in` and `/sign-up` are also rostered (#6797) — code routes (`kind: route`) with no page type, so they sit outside this set equation: the locale layout's header links both, and the roster of record lists every page the scaffold serves.
+
+## 4. Roster, as the registry declares it
+
+`local-business-service` is a `SHAPE_STARTERS` entry, not a declared `--template` alias: `TEMPLATE_MANIFESTS` and `RECOGNIZED_TEMPLATES` never carry its name (NFR-3). The merged roster, as the registry composes it:
+
+<!-- generated:begin roster -->
+
+```
+local-business-service:
+  requires: [marketing]
+  categories: [hvac, roofing, plumbing, electrical, landscaping, auto-repair]
+  shape: local-business-service
+  design: standard
+  roster:
+    - { route: "/",                 kind: page, content: ["content/en/HomePage/home.mdx"] }
+    - { route: "/services",         kind: page, content: ["content/en/ServicesList/services.mdx"] }
+    - { route: "/services/[slug]",  kind: page, contentDir: "content/en/Service" }
+    - { route: "/for",              kind: page, content: ["content/en/UseCasesList/for.mdx"] }
+    - { route: "/for/[slug]",       kind: page, contentDir: "content/en/UseCase" }
+    - { route: "/about",            kind: page, content: ["content/en/AboutPage/about.mdx"] }
+    - { route: "/contact",          kind: page, content: ["content/en/ContactPage/contact.mdx"] }
+    - { route: "/faq",              kind: page, content: ["content/en/FAQPage/faq.mdx"] }
+    - { route: "/glossary",         kind: page, content: ["content/en/GlossaryList/glossary.mdx"] }
+    - { route: "/newsletter",       kind: page, content: ["content/en/NewsletterSignup/newsletter.mdx"] }
+    - { route: "/sign-in",          kind: route }
+    - { route: "/sign-up",          kind: route }
+    - { route: "/purchase-policy",  kind: page, content: ["content/en/PurchasePolicyPage/purchase-policy.mdx"] }
+    - { route: "/privacy",          kind: page, content: ["content/en/PrivacyPage/privacy.mdx"] }
+    - { route: "/terms",            kind: page, content: ["content/en/TermsPage/terms.mdx"] }
+    - { route: "/blog",             kind: page, content: ["content/en/BlogList/blog.mdx"] }
+    - { route: "/meet",             kind: page, content: ["content/en/LandingPage/meet.mdx"] }
+    - { route: "/meet/[slug]",      kind: page, content: ["content/en/BookCall/book-a-call.mdx", "content/en/BookCall/onsite-estimate.mdx", "content/en/BookCall/start-project.mdx", "content/en/BookCall/onsite-service.mdx"] }
+    - { route: "/portfolio",        kind: page, content: ["content/en/PortfolioList/portfolio.mdx"] }
+    - { route: "/portfolio/[slug]", kind: page, contentDir: "content/en/PortfolioItem" }
+```
+
+<!-- generated:end -->
+
+By source:
+
+```
+starter:  / · /services · /services/<slug> · /about · /contact · /faq
+          /glossary · /newsletter · /sign-in · /sign-up
+          /purchase-policy · /privacy · /terms · /blog · /meet · /meet/<slug>
+          /portfolio · /portfolio/<slug>
+```
+
+Every row is module-less: `requires` is `[marketing]` alone, so `mergeRoster` contributes nothing beyond this tree's own seventeen rows.
+
+## 5. Component inventory
+
+<!-- generated:begin inventory -->
+
+| Tier     | Used by this template                                                                                                      |
+| -------- | -------------------------------------------------------------------------------------------------------------------------- |
+| Shell    | `MarketingShell`                                                                                                           |
+| Chrome   | `Nav`, `Footer`, `Banner` (+ `BannerConsentIsland`, `BannerDismissIsland`)                                                 |
+| Sections | `BlogList`, `ContentBlock`, `CTA`, `DocumentChassis`, `FAQ`, `GlossaryIndex`, `Hero`, `Items`, `LogoCloud`, `Testimonials` |
+
+<!-- generated:end -->

package/site-templates/shapes/local-business-service/ailk-template.json

@@ -0,0 +1,10 @@
+{
+  "name": "local-business-service",
+  "requires": ["marketing"],
+  "extends": "_base",
+  "installMap": {
+    "provenance.json": ".ailk-template.json",
+    "TEMPLATE-MANIFEST.json": ".ailk-site-manifest.json"
+  },
+  "postInstall": "Starter local-business-service installed. Its /faq, /contact, /blog, /meet and its four /meet/<slug> seed pages came with the always-copied overlay; /glossary, /newsletter, /privacy and /terms with the base layer it extends (content/en/). This tree's own /, /about, /services (+ three jobs), /purchase-policy and /portfolio pages are its own compositions. Every line of copy is a placeholder \u2014 replace it before you launch."
+}

package/site-templates/{simple-service → shapes/local-business-service}/content/en/AboutPage/about.mdx

@@ -12,7 +12,7 @@ sections:
         {
           "variant": "narrow",
           "eyebrow": "About",
-          "headline": "{A small crew, the same yards, every week}",
+          "headline": "{A small crew, the same neighborhoods, every week}",
           "body": "{Two or three sentences on how the business started, how far you travel, and what you will not take on. Keep it short — this page is read on a phone in a driveway.}",
         },
     },
@@ -23,11 +23,11 @@ sections:
         {
           "variant": "minimal",
           "headline": "Want us to take a look?",
-          "primaryCta": { "label": "Book a visit →", "href": "/meet" },
+          "primaryCta": { "label": "Get in touch", "href": "/contact" },
           "secondaryCta":
             {
-              "label": "Ask a question",
-              "href": "/contact",
+              "label": "See services",
+              "href": "/services",
               "variant": "outline",
             },
         },

package/site-templates/shapes/local-business-service/content/en/HomePage/home.mdx

@@ -0,0 +1,70 @@
+---
+type: "HomePage"
+slug: "home"
+title: "Your Company"
+description: "Placeholder home for the local-business-service starter — a local business selling a service in {Your service area}. Replace every line before you launch."
+sections:
+  [
+    {
+      "id": "hero",
+      "type": "hero",
+      "data":
+        {
+          "variant": "centered",
+          "eyebrow": "{Your service area}",
+          "headline": "{One line on the job you do and the trust it takes to hire you}",
+          "subheadline": "{One line on who you serve and what they get. Name the street, the town or the county — a local reader is looking for their own.}",
+          "primaryCta": { "label": "Get in touch", "href": "/contact" },
+          "secondaryCta":
+            {
+              "label": "See services",
+              "href": "/services",
+              "variant": "outline",
+            },
+        },
+    },
+    {
+      "id": "services",
+      "type": "items",
+      "data":
+        {
+          "headline": "What we do",
+          "columns": 3,
+          "items":
+            [
+              {
+                "title": "{First job}",
+                "description": "{One line on what this job is and who it suits.}",
+                "link": { "label": "Read more", "href": "/services/first-job" },
+              },
+              {
+                "title": "{Second job}",
+                "description": "{One line on what this job is and who it suits.}",
+                "link":
+                  { "label": "Read more", "href": "/services/second-job" },
+              },
+              {
+                "title": "{Third job}",
+                "description": "{One line on what this job is and who it suits.}",
+                "link": { "label": "Read more", "href": "/services/third-job" },
+              },
+            ],
+        },
+    },
+    {
+      "id": "closing",
+      "type": "cta",
+      "data":
+        {
+          "variant": "minimal",
+          "headline": "Ready to get started?",
+          "description": "{One line inviting the reader to reach out.}",
+          "primaryCta": { "label": "Get in touch", "href": "/contact" },
+          "secondaryCta":
+            { "label": "Ask a question", "href": "/faq", "variant": "outline" },
+        },
+    },
+  ]
+---
+
+Placeholder copy. Every headline, every line of body copy on this site is a placeholder — replace them before you launch.

package/site-templates/shapes/local-business-service/content/en/NewsletterSignup/newsletter.mdx

@@ -0,0 +1,59 @@
+---
+type: "NewsletterSignup"
+slug: "newsletter"
+title: "{Start a free newsletter with Substack}"
+description: "{Or upgrade to Pro to capture every subscriber and build your own marketing database.}"
+schema:
+  mainEntity:
+    "@type": "Offer"
+    name: "{Your newsletter name}"
+    price: 0
+    priceCurrency: "USD"
+sections:
+  [
+    {
+      "id": "hero",
+      "type": "hero",
+      "data":
+        {
+          "eyebrow": "Newsletter",
+          "headline": "{Start a free newsletter with Substack}",
+          "subheadline": "{Or upgrade to Pro to capture every subscriber and build your own marketing database.}",
+          "primaryCta":
+            { "label": "{Connect Substack}", "href": "https://substack.com" },
+          "secondaryCta":
+            {
+              "label": "{Upgrade to Pro}",
+              "href": "https://ailaunchkit.ai/pricing",
+              "variant": "outline",
+            },
+        },
+    },
+    {
+      "id": "faq",
+      "type": "faq",
+      "data":
+        {
+          "headline": "FAQs",
+          "presentation": "expanded",
+          "items":
+            [
+              {
+                "question": "{How often will I hear from you?}",
+                "answer": "{Answer in one or two plain sentences}",
+              },
+              {
+                "question": "{What will I get?}",
+                "answer": "{Answer in one or two plain sentences}",
+              },
+              {
+                "question": "{Can I unsubscribe?}",
+                "answer": "{Answer in one or two plain sentences}",
+              },
+            ],
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]` by the /newsletter route. The Free template has no signup form: the hero points the owner to Substack, or to Pro for subscriber capture. The `schema:` Offer is the page's JSON-LD main entity — a free subscription. Placeholder copy — replace every {brace} with your own words before you launch. */}