@xenterprises/nuxt-x-marketing 1.2.2 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+All notable changes to `@xenterprises/nuxt-x-marketing` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.4.0] - 2026-08-02
+
+### Removed
+
+> **Released as a minor despite removing public components.** Semver would call
+> this a major. Sites on `^1.3.0` will therefore pick this up automatically —
+> if you import any `XMarkAffiliate*` component, pin to `1.3.0` or migrate to
+> the `XAF*` equivalents below before upgrading.
+
+- **Removed the `XMarkAffiliate*` component family** — `XMarkAffiliateDisclosure`,
+  `XMarkAffiliateProductCard`, `XMarkAffiliateProductGrid`, `XMarkAffiliateProductDetail`,
+  and `XMarkAffiliateComparisonTable` (1,462 lines).
+
+  They duplicated components `@xenterprises/nuxt-x-affiliate` already ships, without its
+  per-merchant tagging (`xAffiliateContent.merchants`), impression tracking, or
+  Product/Offer structured data — so a site using them shipped untagged outbound links
+  and no product schema.
+
+  Migrate to `<XAFDisclosure>`, `<XAFProductCard>`, `<XAFRelatedProducts>`,
+  `<XAFComparisonTable>`, and (for the detail page) `<XAFHero>` + `<XAFProsCons>` +
+  `<XAFVerdict>` + `<XAFSpecsTable>`. Affiliate sites should extend `nuxt-x-affiliate`
+  directly — it is now self-contained and ships the site chrome (header, hero, sections,
+  cards, footer) that previously required this layer alongside it.
+
+### Changed
+
+- **`app/pages/index.vue`** no longer showcases the removed affiliate components; the
+  section and its sample product data were dropped with them. Every other section of the
+  demo page is unchanged.
+
+## [1.3.0] - 2026-07-24
+
+### BREAKING
+
+- **Blog migrated from Builder.io to Nuxt Content.** Consumers that relied on `NUXT_PUBLIC_BUILDERIO_KEY` and Builder models must migrate posts to `content/blog/*.md` and install the Content peer dependencies.
+- **Default app shell rewritten to a config-driven shell.** The layer's `app/app.vue` (previously a hardcoded demo referencing non-existent `XMarkNavbar`/`XMarkFooter`, rendering no navbar/footer) now renders `XHeaderNav` + `XFooter` from `xMarketing.header`/`footer` config plus the consent banner. Consumers without their own `app/app.vue` will see the rendered shell change; the hardcoded newsletter section, dead demo links, and `/logo-white.svg`/`/logo-dark.svg` fallbacks are gone.
+- **`xMarketing.name`/`url` defaults changed from placeholders to `undefined`** and both keys are now live: `name` drives the shell title template and `og:site_name` (page titles gain a `| <name>` suffix when set), `url` drives the home page `og:url`. Consumers reading the old placeholder defaults from `appConfig` now get `undefined`.
+
+### Added
+
+- Config-driven default shell with `xMarketing` opt-out switches for header, footer, and consent banner.
+- `xMarketing.blog.active` opt-out on the shipped blog pages.
+- `xMarketing.name`/`url` wired into shell SEO defaults (title template, `og:site_name`, `og:url`).
+- Playground e2e smoke suite (`test:e2e`, plan 17) and lint quality gate.
+- Consumer-minimal quickstart docs and plan-18 batteries-included audit.
+
+### Changed
+
+- Exported named `XMarketingConfig` interface for typed `app.config.ts` (plan-21 config-typing convention).
+- Peer dependency ranges tightened to caret bounds.
+
+### Fixed
+
+- Widened `better-sqlite3` peer range to `^11.0.0 || ^12.0.0`.
+- Default home page references real component names; `UToggle` replaced with `USwitch`.
+- Repaired red gates: added `test:run`/`test:coverage` aliases and pinned `vue`.
+- Test suite: fixed stale hero title assertion and scoped `h1` queries to main content.

package/README.md

@@ -31,86 +31,56 @@ export default defineNuxtConfig({
 
 ## Quick Start
 
-### Basic App Layout
+### What the consumer writes
 
-Create your `app.vue` with Navbar, Newsletter, and Footer:
+The layer is batteries-included: it ships a default app shell (navbar + footer + cookie-consent banner) and default pages (`/`, `/blog`, `/blog/[...slug]`). You do **not** write an `app.vue` — configure the shell in `app/app.config.ts` under the `xMarketing` namespace (it must live in `app/`, not the project root):
 
-```vue
-<template>
-  <div class="min-h-screen flex flex-col">
-    <XMarkNavbar
-      :links="navLinks"
-      :logo-light="'/logo-white.svg'"
-      :logo-dark="'/logo-dark.svg'"
-      logo-alt="Company"
-    >
-      <template #actions>
-        <UButton variant="ghost" color="neutral">Sign In</UButton>
-        <UButton color="primary">Get Started</UButton>
-      </template>
-    </XMarkNavbar>
-
-    <main class="flex-grow">
-      <NuxtPage />
-    </main>
-
-    <XMarkSection bg="subtle" padding="lg">
-      <XMarkNewsletter
-        title="Stay in the loop"
-        description="Get the latest updates delivered to your inbox."
-        @submit="handleNewsletterSubmit"
-      />
-    </XMarkSection>
+```javascript
+// app/app.config.ts
+export default defineAppConfig({
+  xMarketing: {
+    name: "Acme Inc",
+    url: "https://acme.com",
+    header: {
+      logo: { src: "/logo.svg", srcDark: "/logo-dark.svg", alt: "Acme" },
+      nav: {
+        links: [
+          { label: "Pricing", to: "/#pricing" },
+          { label: "Blog", to: "/blog" },
+        ],
+        buttons: [{ label: "Get Started", to: "/signup", color: "primary" }],
+      },
+    },
+    footer: {
+      logo: { src: "/logo.svg", alt: "Acme" },
+      body: "Building the future of modern software.",
+      socials: [
+        { name: "GitHub", url: "https://github.com/acme", icon: "i-lucide-github" },
+      ],
+      columns: [
+        {
+          headerLabel: "Product",
+          links: [{ label: "Blog", to: "/blog" }],
+        },
+      ],
+    },
+    blog: { active: true, title: "Blog" },
+    tracking: { gtmId: "GTM-XXXXXXX" }, // optional; fires only after consent
+  },
+});
+```
 
-    <XMarkFooter
-      :logo="'/logo-dark.svg'"
-      description="Building the future of modern software."
-      :social="socialLinks"
-      :columns="footerColumns"
-      :legal-links="legalLinks"
-    />
-  </div>
-</template>
+Blog posts are markdown in `content/blog/*.md` — re-declare the `blog` collection in your own `content.config.ts` so Nuxt Content binds it to your content dir (the layer's `.playground/content.config.ts` is the reference).
 
-<script setup>
-const navLinks = [
-  { label: "Features", to: "/#features" },
-  { label: "Pricing", to: "/pricing" },
-  { label: "Blog", to: "/blog" },
-];
-
-const socialLinks = [
-  { name: "Twitter", href: "https://twitter.com", icon: "i-lucide-twitter" },
-  { name: "GitHub", href: "https://github.com", icon: "i-lucide-github" },
-];
-
-const footerColumns = [
-  {
-    title: "Product",
-    links: [
-      { label: "Features", to: "/#features" },
-      { label: "Pricing", to: "/pricing" },
-    ],
-  },
-  {
-    title: "Company",
-    links: [
-      { label: "About", to: "/about" },
-      { label: "Blog", to: "/blog" },
-    ],
-  },
-];
+### Opting out of the defaults
 
-const legalLinks = [
-  { label: "Privacy Policy", to: "/privacy" },
-  { label: "Terms of Service", to: "/terms" },
-];
+Every shipped default has a switch or a standard Nuxt override:
 
-const handleNewsletterSubmit = (email) => {
-  console.log("Newsletter signup:", email);
-};
-</script>
-```
+- `xMarketing.header.active: false` — removes the default navbar from the shell
+- `xMarketing.footer.active: false` — removes the default footer
+- `xMarketing.consent.active: false` — removes the cookie-consent banner (tracking scripts then never fire)
+- `xMarketing.blog.active: false` — the shipped `/blog` pages 404
+- Replace the whole shell by shipping your own `app/app.vue`; replace any page by shipping the same path under `app/pages/` (standard Nuxt layer overriding)
 
 ### Example Landing Page
 
@@ -177,32 +147,28 @@ const pricingPlans = [
 
 ### Core Layout
 
-#### XMarkNavbar
+#### XMarkLayoutNavbar
 
-Fixed navigation header with transparent-to-solid scroll transition.
+Fixed navigation header with transparent-to-solid scroll transition. Falls back to `xMarketing.header` (logo, nav links, nav buttons) when props are omitted.
 
 ```vue
-<XMarkNavbar
+<XMarkLayoutNavbar
   :links="[{ label: 'Features', to: '/#features' }]"
-  logo-light="/logo-white.svg"
-  logo-dark="/logo-dark.svg"
-  logo-alt="Company"
+  :logo="{ src: '/logo.svg', srcDark: '/logo-dark.svg', alt: 'Company' }"
+  :buttons="[
+    { label: 'Sign In', to: '/login', variant: 'ghost' },
+    { label: 'Get Started', to: '/signup', color: 'primary' },
+  ]"
   :transparent="true"
   :scroll-threshold="100"
->
-  <template #actions>
-    <UButton variant="ghost">Sign In</UButton>
-    <UButton color="primary">Get Started</UButton>
-  </template>
-</XMarkNavbar>
+/>
 ```
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `links` | `Array` | `[]` | Navigation links `{ label, to }` |
-| `logoLight` | `String` | `''` | Logo for transparent/dark state |
-| `logoDark` | `String` | `''` | Logo for solid/light state |
-| `logoAlt` | `String` | `'Logo'` | Logo alt text |
+| `links` | `Array` | `xMarketing.header.nav.links` | Navigation links `{ label, to }` |
+| `logo` | `Object` | `xMarketing.header.logo` | Logo `{ src, srcDark?, alt? }` |
+| `buttons` | `Array` | `xMarketing.header.nav.buttons` | Action buttons `{ label, to, color?, variant?, icon? }` |
 | `transparent` | `Boolean` | `true` | Start transparent over hero |
 | `scrollThreshold` | `Number` | `100` | Pixels before transition |
 
@@ -226,40 +192,39 @@ Section wrapper with background variants and optional patterns.
 | `bgImage` | `String` | `''` | Background image URL |
 | `parallax` | `Boolean` | `false` | Enable parallax on bg image |
 
-#### XMarkFooter
+#### XMarkLayoutFooter
 
 Full footer with brand, link columns, social icons, and newsletter.
 
 ```vue
-<XMarkFooter
-  logo="/logo.svg"
-  logo-alt="Company"
+<XMarkLayoutFooter
+  :logo="{ src: '/logo.svg', alt: 'Company' }"
   description="Building the future of modern software."
   :social="[{ name: 'Twitter', href: 'https://twitter.com', icon: 'i-lucide-twitter' }]"
   :columns="[{ title: 'Product', links: [{ label: 'Features', to: '/features' }] }]"
   :legal-links="[{ label: 'Privacy', to: '/privacy' }]"
-  :show-newsletter="true"
+  :has-newsletter="true"
   @newsletter-submit="handleSubmit"
 />
 ```
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `logo` | `String` | `''` | Logo image URL |
+| `logo` | `Object` | `null` | Logo `{ src, alt? }` |
 | `description` | `String` | `''` | Brand description |
 | `social` | `Array` | `[]` | Social links `{ name, href, icon }` |
 | `columns` | `Array` | `[]` | Link columns `{ title, links: [{ label, to }] }` |
 | `legalLinks` | `Array` | `[]` | Legal links `{ label, to }` |
 | `copyright` | `String` | auto | Copyright text |
-| `showNewsletter` | `Boolean` | `false` | Show newsletter section |
+| `hasNewsletter` | `Boolean` | `false` | Show newsletter section |
 
-#### XMarkLegalFooter
+#### XMarkLayoutFooterLegal
 
 Minimal footer with copyright and legal links only.
 
 ```vue
-<XMarkLegalFooter
-  company-name="X Enterprises"
+<XMarkLayoutFooterLegal
+  copyright="© 2026 Acme Inc. All rights reserved."
   :links="[{ label: 'Privacy', to: '/privacy' }]"
 />
 ```
@@ -846,186 +811,14 @@ Chat widget trigger.
 
 ### Affiliate & Review Components
 
-For affiliate marketing, product review sites, and "best X" roundup posts.
-
-#### XMarkAffiliateDisclosure
-
-FTC/Amazon-required affiliate disclosure banner. Three variants for different placements.
-
-```vue
-<!-- Subtle bar (default) -->
-<XMarkAffiliateDisclosure />
-
-<!-- Full-width banner at top of page -->
-<XMarkAffiliateDisclosure variant="banner" :dismissible="true" />
-
-<!-- Inline inside blog post prose -->
-<XMarkAffiliateDisclosure variant="inline" />
-```
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `text` | `String` | Amazon associate disclosure | Disclosure text |
-| `variant` | `String` | `'subtle'` | `subtle`, `banner`, `inline` |
-| `icon` | `String` | `'i-lucide-info'` | Icon name |
-| `dismissible` | `Boolean` | `false` | Show dismiss button |
-| `storageKey` | `String` | `'affiliate-disclosure-dismissed'` | localStorage key |
-
-#### XMarkAffiliateProductCard
-
-Product card with affiliate buy button, star rating, price, pros/cons. Three layout variants.
-
-```vue
-<XMarkAffiliateProductCard
-  :product="{
-    name: 'Sony WH-1000XM5',
-    image: '/products/sony-wh1000xm5.jpg',
-    price: '$279.99',
-    originalPrice: '$349.99',
-    rating: 4.8,
-    reviewCount: 12400,
-    pros: ['Best-in-class ANC', '30hr battery', 'Foldable design'],
-    cons: ['No IP rating', 'Expensive'],
-    affiliateUrl: 'https://amazon.com/dp/B09XS7JWHH',
-    affiliateTag: 'mysite-20',
-    badge: '#1 Pick',
-  }"
-  layout="card"
-  button-label="Check Price on Amazon"
-/>
-```
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `product` | `Object` | sample product | Product data `{ name, image?, price?, originalPrice?, rating?, reviewCount?, pros?, cons?, affiliateUrl?, affiliateTag?, badge? }` |
-| `layout` | `String` | `'card'` | `card` (vertical), `row` (horizontal), `compact` (one-line) |
-| `showPros` | `Boolean` | `true` | Show pros list |
-| `showCons` | `Boolean` | `false` | Show cons list |
-| `showRating` | `Boolean` | `true` | Show star rating |
-| `showPrice` | `Boolean` | `true` | Show price |
-| `buttonLabel` | `String` | `'Check Price on Amazon'` | CTA button text |
-| `buttonIcon` | `String` | `'i-lucide-external-link'` | CTA button icon |
-| `disclosure` | `String` | `''` | Small disclosure text below button |
-
-#### XMarkAffiliateProductGrid
+Removed in favour of [`@xenterprises/nuxt-x-affiliate`](../nuxt-x-affiliate).
 
-Grid of product cards for "best X" roundup posts. Automatically injects rank badges.
-
-```vue
-<XMarkAffiliateProductGrid
-  :products="topHeadphones"
-  layout="grid"
-  :columns="3"
-  :show-ranking="true"
-  disclosure="This page contains affiliate links."
-  button-label="Check Price on Amazon"
-/>
-```
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `products` | `Array` | `[]` | Array of product objects |
-| `layout` | `String` | `'grid'` | `grid` or `list` |
-| `columns` | `Number` | `3` | Grid columns: `2` or `3` |
-| `showRanking` | `Boolean` | `true` | Inject #1/#2/#3 badges on first 3 products |
-| `disclosure` | `String` | `''` | Disclosure shown once at top |
-| `buttonLabel` | `String` | `'Check Price on Amazon'` | CTA label for all cards |
-| `cardLayout` | `String` | `'card'` | Card layout variant |
-
-#### XMarkAffiliateProductDetail
-
-Full product review page layout — image gallery, editorial score, pros/cons table, specs, sticky buy box.
-
-```vue
-<XMarkAffiliateProductDetail
-  :product="{
-    name: 'Sony WH-1000XM5 Review',
-    images: ['/img/sony-1.jpg', '/img/sony-2.jpg'],
-    price: '$279.99',
-    originalPrice: '$349.99',
-    rating: 4.8,
-    reviewCount: 12400,
-    pros: ['Best-in-class ANC', '30hr battery'],
-    cons: ['No IP rating', 'Expensive'],
-    specs: { 'Driver Size': '30mm', 'Battery': '30 hours', 'Weight': '250g' },
-    description: 'The WH-1000XM5 sets the bar for noise-cancelling headphones.',
-    verdict: 'The best ANC headphones money can buy in 2024.',
-    affiliateUrl: 'https://amazon.com/dp/B09XS7JWHH',
-    affiliateTag: 'mysite-20',
-  }"
-  :score="9.2"
-  :has-buy-box="true"
-  :has-specs="true"
-  :has-pros-cons-table="true"
-  disclosure="This page contains affiliate links."
->
-  <template #after-verdict>
-    <!-- Additional content after verdict -->
-  </template>
-  <template #sidebar>
-    <!-- Additional sidebar widgets -->
-  </template>
-</XMarkAffiliateProductDetail>
-```
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `product` | `Object` | sample product | Full product data including `images[]`, `specs{}`, `verdict` |
-| `score` | `Number` | `null` | Editorial score 0–10 (shown as circular badge) |
-| `hasBuyBox` | `Boolean` | `true` | Show sticky buy box sidebar |
-| `hasSpecs` | `Boolean` | `true` | Show specs table |
-| `hasProsConsTable` | `Boolean` | `true` | Show pros/cons two-column table |
-| `disclosure` | `String` | `''` | Affiliate disclosure text |
-
-**Slots:** `buy-box`, `after-verdict`, `sidebar`
-
-#### XMarkAffiliateComparisonTable
-
-Side-by-side product comparison table for "X vs Y" posts. Highlights best values per row.
-
-```vue
-<XMarkAffiliateComparisonTable
-  :products="[
-    {
-      name: 'Sony WH-1000XM5',
-      image: '/img/sony.jpg',
-      price: '$279.99',
-      affiliateUrl: 'https://amazon.com/dp/B09XS7JWHH',
-      affiliateTag: 'mysite-20',
-      specs: { price: '$279.99', rating: '4.8/5', battery: '30 hours', weight: '250g' },
-    },
-    {
-      name: 'Bose QC45',
-      image: '/img/bose.jpg',
-      price: '$249.99',
-      affiliateUrl: 'https://amazon.com/dp/B098FKXT8L',
-      affiliateTag: 'mysite-20',
-      specs: { price: '$249.99', rating: '4.6/5', battery: '24 hours', weight: '238g' },
-    },
-  ]"
-  :specs="[
-    { label: 'Price', key: 'price' },
-    { label: 'Rating', key: 'rating' },
-    { label: 'Battery Life', key: 'battery' },
-    { label: 'Weight', key: 'weight' },
-  ]"
-  :show-buy-buttons="true"
-  :highlight-best="true"
-  button-label="Buy on Amazon"
-  disclosure="This page contains affiliate links."
-/>
-```
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `products` | `Array` | 2 sample products | 2–4 products with `specs` object |
-| `specs` | `Array` | price/rating/battery | `[{ label, key }]` spec rows |
-| `showBuyButtons` | `Boolean` | `true` | Show buy buttons in last row |
-| `highlightBest` | `Boolean` | `true` | Highlight best value per row (lowest price, highest rating) |
-| `buttonLabel` | `String` | `'Buy on Amazon'` | Buy button label |
-| `disclosure` | `String` | `''` | Disclosure shown above table |
-
----
+`XMarkAffiliateDisclosure`, `XMarkAffiliateProductCard`, `XMarkAffiliateProductGrid`,
+`XMarkAffiliateProductDetail`, and `XMarkAffiliateComparisonTable` duplicated components
+the affiliate layer already ships — without its per-merchant tagging
+(`xAffiliateContent.merchants`), impression tracking, or Product/Offer structured data.
+Use `<XAFDisclosure>`, `<XAFProductCard>`, `<XAFRelatedProducts>`, `<XAFBuyButton>`,
+and `<XAFComparisonTable>` instead.
 
 ## Configuration
 
@@ -1072,7 +865,7 @@ npm run test:e2e
 | `useStaggerReveal(selector, delay?)` | Adds incremental `transition-delay` to `[data-reveal]` children inside a container. |
 | `useParallax(options?)` | Parallax scroll effect for `.xParallax[data-parallax-speed]` elements. Uses `requestAnimationFrame` for performance. |
 | `useElementParallax(speed?)` | Individual element parallax via template ref. Returns `{ elementRef }`. |
-| `useXBlog()` | Blog data fetching composable. Reads `runtimeConfig.public.apiURL`. |
+| `useXBlog()` | Nuxt Content blog helpers (`getPosts`, `getPostByPath`, `getSurround`, `normalizeBlogPost`). Expects a `blog` collection and markdown under `content/blog/`. |
 
 All composables are SSR-safe — they guard lifecycle hooks with `getCurrentInstance()` and `import.meta.client` checks.
 
@@ -1082,11 +875,10 @@ All composables are SSR-safe — they guard lifecycle hooks with `getCurrentInst
 
 | Name | Required | Description |
 |------|----------|-------------|
-| `NUXT_PUBLIC_API_URL` | No | Base API URL for blog composable (used by `useXBlog`) |
 | Marker.io Project ID | No | Set via `appConfig.xMarketing.config.markerProjectId` (not env var) |
 | Newsletter Org ID | No | Set via `appConfig.xMarketing.config.emailMarketingNewsletters.organizationId` |
 
-The layer itself has no required environment variables. All configuration is done via `app.config.ts`.
+The layer itself has no required environment variables. Blog content is **file-based via Nuxt Content** (not Builder.io). All site config is done via `app.config.ts`.
 
 ---
 
@@ -1179,7 +971,8 @@ The layer provides a complete marketing website toolkit built on Nuxt UI v4:
 
 | Path | Purpose |
 |------|---------|
-| `nuxt.config.ts` | Registers `@nuxt/ui`, loads CSS, enables SSR and devtools |
+| `nuxt.config.ts` | Registers `@nuxt/ui` + `@nuxt/content`, loads CSS, enables SSR |
+| `content.config.ts` | Default Nuxt Content `blog` collection schema |
 | `app/app.config.ts` | Default xMarketing config + Nuxt UI theme overrides + type augmentation |
 | `app/app.vue` | Default app shell with navbar, newsletter, footer (override in consumer app) |
 | `app/assets/css/x-marketing.css` | Full design system: colors, typography, animations, effects |
@@ -1190,7 +983,36 @@ The layer provides a complete marketing website toolkit built on Nuxt UI v4:
 | `app/composables/` | Composables: useScrollReveal, useParallax, useXBlog |
 | `app/plugins/marketing.client.ts` | Client plugin: auto-initializes scroll/parallax globally |
 | `app/types/marketing.d.ts` | TypeScript interfaces for all data structures |
-| `app/pages/` | Default blog pages (index + detail with slug routing) |
+| `app/pages/blog/` | Default blog index + slug detail (Nuxt Content, not Builder.io) |
+
+### Blog (Nuxt Content)
+
+**Breaking (Builder.io removed):** default `/blog` pages no longer call the Builder CDN.
+Posts come from markdown in the consumer app.
+
+1. Peer-install `@nuxt/content` and `better-sqlite3` (already required by Content v3).
+2. Ensure the layer is extended so `content.config.ts` defines the `blog` collection (or copy/adapt it).
+3. Add posts under `content/blog/*.md`:
+
+```md
+---
+title: Getting Started
+description: First post on the marketing site.
+date: 2025-01-15
+author: Tim
+image: /blog/cover.jpg
+category: Tutorial
+tags: [nuxt, marketing]
+published: true
+readingTime: 5
+---
+
+## Hello
+
+Markdown body rendered via `ContentRenderer`.
+```
+
+4. `useXBlog().getPosts()` / `getPostByPath()` feed `XMarkBlogList` and `XMarkBlogDetail`.
 
 ### Overriding in Consumer Apps
 
@@ -1198,6 +1020,7 @@ The layer provides a complete marketing website toolkit built on Nuxt UI v4:
 - **app.config.ts**: Deep-merges with layer defaults. Set `xMarketing.header`, `xMarketing.footer`, etc.
 - **app.vue**: Override entirely by creating your own `app.vue` in the consumer app.
 - **Pages**: Consumer pages take precedence. Override `/blog` by creating `pages/blog/index.vue`.
+- **Content**: Own the markdown under `content/blog/`; do not put secrets in frontmatter.
 
 ---