Migrate website from 11ty to Nuxt 4

.claude/CLAUDE.md

@@ -2,32 +2,36 @@
 
 ## Stack
 
-- **SSG**: Eleventy (11ty) v3, source in `src/`, output to `_site/`
-- **CSS**: Tailwind v3 via PostCSS → `_site/css/style.css`
-- **Templates**: Nunjucks (`.njk`) + Markdown
+- **SSG**: Nuxt 4 static generation (`nuxt/`, output `nuxt/.output/public`).
+  Eleventy has been fully removed; `src/` is retained only as a data source the
+  `scripts/copy_*.js` build steps read (see `migration/STATUS.md`).
+- **CSS**: Tailwind v3 via PostCSS → `nuxt/public/css/style.css`
+- **Pages**: Nuxt `.vue` pages + `@nuxt/content` v3 (markdown under `nuxt/content/`,
+  generated from `src/` by the copy scripts)
 - **Search**: Algolia (`scripts/index-algolia.js`)
-- **Hosting**: Netlify; publish dir = `_site`
-- **Nuxt migration**: parallel Nuxt 3 project lives in `nuxt/` (see [nuxt/CLAUDE.md](nuxt/CLAUDE.md))
+- **Hosting**: Netlify; publish dir = `nuxt/.output/public`
+- **Nuxt app**: see [nuxt/CLAUDE.md](nuxt/CLAUDE.md)
 
 ## Dev commands
 
 ```bash
-npm start              # all watchers in parallel (11ty + nuxt + postcss + docs + blueprints)
-npm run dev            # eleventy + postcss + nuxt only
-npm run dev:eleventy   # 11ty only, port 8080
-npm run dev:nuxt       # Nuxt only, port 3000/3001
+npm run dev            # postcss(nuxt) + docs + blueprints watchers + nuxt dev (port 3000)
+npm start              # alias for npm run dev
 npm run docs           # sync docs from external source once
-npm run build          # production build
+npm run build          # production build (build:nuxt → nuxt generate)
 ```
 
+> The `src/` content-type docs below describe the markdown/frontmatter the copy
+> scripts read; the formats are unchanged from the 11ty era. Rendering is now
+> done by Nuxt pages/components, not Nunjucks layouts.
+
 ## Directory layout
 
 ```
 src/
 ├── _data/             # Global data files (authors, tags, site config, etc.)
-├── _includes/
-│   ├── layouts/       # Nunjucks layout templates
-│   └── components/    # Reusable partials
+├── _includes/         # Retained build inputs only: components/icons (SVGs),
+│   │                  #   core-nodes/ + hardware/ (node-red markdown includes)
 ├── blog/              # Blog posts  →  /blog/YYYY/MM/slug/
 ├── changelog/         # Changelog entries  →  /changelog/YYYY/MM/slug/
 ├── customer-stories/  # Case studies  →  /customer-stories/slug/
@@ -37,8 +41,7 @@ src/
 ├── images/            # Static images
 └── public/            # Pass-through static files
 scripts/               # Build-time scripts (copy_docs.js, copy_blueprints.js, etc.)
-lib/                   # Shared helpers used by .eleventy.js and scripts
-.eleventy.js           # Main Eleventy config (1100+ lines)
+nuxt/                  # Nuxt 4 app: pages/, components/, content/, server/, nuxt.config.ts
 ```
 
 ---
@@ -49,7 +52,7 @@ lib/                   # Shared helpers used by .eleventy.js and scripts
 
 **Source:** `src/blog/YYYY/MM/{slug}.md`  
 **URL:** `/blog/YYYY/MM/{slug}/`  
-**Layout:** `layouts/post.njk`
+**Rendered by:** `nuxt/pages/blog/[...slug].vue` (content generated by `scripts/copy_blog.js`)
 
 ```yaml
 ---
@@ -83,7 +86,7 @@ Tag options are defined in `src/_data/blogTags.json`. Future-dated posts are exc
 
 **Source:** `src/changelog/YYYY/MM/{slug}.md`  
 **URL:** `/changelog/YYYY/MM/{slug}/`  
-**Layout:** `layouts/post-changelog.njk`
+**Rendered by:** `nuxt/pages/changelog/[...slug].vue` (content generated by `scripts/copy_changelog.js`)
 
 ```yaml
 ---
@@ -106,7 +109,7 @@ Each year has a `src/changelog/YYYY/YYYY.json` that tags the collection.
 
 **Source:** `src/handbook/{department}/{slug}.md`  
 **URL:** `/handbook/{department}/{slug}/`  
-**Layout:** `layouts/documentation.njk` (shared with docs)
+**Rendered by:** `nuxt/pages/handbook/[...slug].vue` + `HandbookNavTree.vue` (content generated by `scripts/copy_handbook.js`)
 
 ```yaml
 ---
@@ -124,7 +127,7 @@ Collection config: `src/handbook/handbook.json`
 
 **Source:** `src/docs/{section}/{slug}.md` — **do not edit directly**; synced via `node scripts/copy_docs.js` from the external `flowfuse/flowfuse` monorepo.  
 **URL:** `/docs/{section}/{slug}/`  
-**Layout:** `layouts/documentation.njk`
+**Rendered by:** `nuxt/pages/docs/[...slug].vue` (content generated by `scripts/copy_docs_nuxt.js` from `src/docs`, which `scripts/copy_docs.js` syncs from the external repo)
 
 ```yaml
 ---
@@ -148,7 +151,7 @@ Collection config: `src/docs/docs.json`
 
 **Source:** `src/customer-stories/{slug}.md`  
 **URL:** `/customer-stories/{slug}/`  
-**Layout:** `layouts/story.njk`
+**Rendered by:** `nuxt/pages/customer-stories/[...slug].vue` (content generated by `scripts/copy_customer_stories.js`)
 
 ```yaml
 ---
@@ -191,18 +194,21 @@ Collection config: `src/customer-stories/customer-stories.json`
 | `events.yaml` | Event calendar |
 | `features.json` | Product feature catalog |
 | `integrations.js` | Integration listings |
-| `eleventyComputed.js` | Dynamic computed properties |
-
-## Layouts
-
-| Layout | Used by |
-|--------|---------|
-| `layouts/base.njk` | HTML shell |
-| `layouts/post.njk` | Blog posts |
-| `layouts/post-changelog.njk` | Changelog entries |
-| `layouts/documentation.njk` | Docs + handbook (with sidebar nav) |
-| `layouts/story.njk` | Customer stories |
-| `layouts/nohero.njk` | General pages without hero |
+
+## Rendering & layouts
+
+Pages are rendered by Nuxt, not Nunjucks. The legacy `layouts/*.njk` templates are gone; their roles map onto the Nuxt app as follows:
+
+| Section | Rendered by |
+|---------|-------------|
+| HTML shell / chrome | `nuxt/app.vue` + `nuxt/layouts/*.vue` (header/footer components) |
+| Blog posts & index | `nuxt/pages/blog/[...slug].vue` |
+| Changelog | `nuxt/pages/changelog/[...slug].vue` |
+| Docs & handbook (sidebar nav) | `nuxt/pages/docs/[...slug].vue`, `nuxt/pages/handbook/[...slug].vue` + `HandbookNavTree.vue` |
+| Customer stories | `nuxt/pages/customer-stories/[...slug].vue` |
+| Marketing pages | bespoke `nuxt/pages/**/*.vue` |
+
+Markdown-driven sections use `@nuxt/content` v3 collections (configured in `nuxt/content.config.ts`), populated from `src/` by the `scripts/copy_*.js` build steps.
 
 ## Naming conventions