diff --git a/docs/SHOWCASE.md b/docs/SHOWCASE.md
index c0a12903..5e2a30ef 100644
--- a/docs/SHOWCASE.md
+++ b/docs/SHOWCASE.md
@@ -1,51 +1,85 @@
 # GraphCompose GitHub Pages Showcase
 
-This folder contains the lightweight static showcase site for GraphCompose. It is intentionally plain HTML, CSS, JavaScript, and JSON so GitHub Pages can publish it directly from the main repository without a build step.
+This folder is the static showcase site for GraphCompose. It is plain HTML,
+CSS, JavaScript, and a generated JSON manifest, so GitHub Pages publishes it
+directly from the main repository with no build step.
 
 ## Files
 
-- `index.html` is the single-page showcase.
-- `styles.css` contains the visual system and responsive layout.
-- `examples.json` is the gallery data source.
-- `assets/logo/` contains the showcase logo asset.
-- `assets/screenshots/` contains PNG previews for generated PDFs.
-- `assets/pdf/` contains the generated PDF examples linked from the gallery.
-
-## Add A New Showcase Item
-
-1. Generate the PDF from the examples module.
-2. Copy the PDF into `docs/assets/pdf/`.
-3. Add a PNG screenshot into `docs/assets/screenshots/`.
-4. Add a new object to `docs/examples.json`.
-5. Commit and push.
-
-Each `examples.json` object uses this shape:
-
-```json
-{
-  "title": "Cinematic Invoice",
-  "description": "A short description of the generated document.",
-  "tags": ["Template", "Tables", "Theme"],
-  "image": "assets/screenshots/invoice-v2.png",
-  "pdf": "assets/pdf/invoice-v2.pdf",
-  "code": "https://github.com/DemchaAV/GraphCompose/blob/main/examples/src/main/java/com/demcha/examples/InvoiceCinematicFileExample.java"
-}
-```
+- `index.html` — the single-page showcase. Holds the hero, install snippets,
+  feature/architecture sections, and the searchable gallery shell.
+- `styles.css` — the visual system and responsive layout.
+- `examples.js` — client script that fetches the manifest and renders the
+  gallery (search, category filters, highlights strip, lightbox).
+- `examples.json` — **generated** gallery manifest. Do **not** hand-edit it;
+  it is rewritten by `ShowcaseSync` (see below).
+- `assets/logo/` — the showcase logo asset.
+- `showcase/pdf/<category>/<group>/…` — generated PDF examples linked from the
+  gallery.
+- `showcase/screenshots/<category>/<group>/…` — PNG previews auto-rendered from
+  those PDFs.
 
-## Local Preview
+> Older revisions of this doc referenced `docs/assets/screenshots` and
+> `docs/assets/pdf` plus a manual "copy the PDF, add a PNG, edit examples.json"
+> flow. That is no longer accurate — previews and the manifest are generated
+> under `docs/showcase/**` by `ShowcaseSync`.
 
-Open `docs/index.html` directly in a browser for a quick visual check. If your browser blocks `fetch("examples.json")` for local `file://` pages, run any tiny static server from the repository root and open the `/docs/` path. No build step is required.
+## Add a new showcase item
 
-## GitHub Pages
+The gallery is driven by code, not by hand-editing JSON. Source of truth:
+`examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java`.
+
+1. Add the example `.java` under the right category sub-package in
+   `examples/src/main/java/com/demcha/examples/`.
+2. Make it write its PDF via `ExampleOutputPaths.prepare(category, fileName)`
+   so the output lands under the matching `examples/target/generated-pdfs/`
+   subfolder.
+3. Wire it into `GenerateAllExamples.main`.
+4. Register a metadata entry in `ShowcaseMetadata.java` (title, one-line
+   description, search tags, source link) keyed by the generated PDF basename.
+5. Regenerate, then sync:
+
+   ```bash
+   ./mvnw -f examples/pom.xml exec:java -Dexec.mainClass=com.demcha.examples.GenerateAllExamples
+   ./mvnw -f examples/pom.xml exec:java -Dexec.mainClass=com.demcha.examples.support.ShowcaseSync
+   ```
+
+   `ShowcaseSync` copies each PDF into `docs/showcase/pdf/…`, rasterises a PNG
+   into `docs/showcase/screenshots/…`, and rewrites `docs/examples.json`.
+6. Commit the regenerated `docs/showcase/**` assets and `docs/examples.json`.
+
+## Version and source links
 
-To publish this site with GitHub Pages:
+- The displayed version lives **only** in `index.html` (JSON-LD
+  `softwareVersion`, the JitPack download URL, the hero badge, and the Maven +
+  Gradle install snippets). It does not inherit from the pom.
+- `scripts/cut-release.ps1` flips all of those — plus the README and poms — to
+  the release tag in the release commit, and `VersionConsistencyGuardTest`
+  fails the `verify` gate if any of them drift out of sync with the library
+  `pom.xml`. Do not hand-bump the site version ahead of a release.
+- "View source" links resolve through `ShowcaseMetadata.GH_BASE`, which
+  `cut-release.ps1` flips between `/blob/develop` (while developing) and
+  `/blob/v<tag>` (at release) so the deployed site points at the exact source
+  that produced each artefact.
 
-1. Open repository Settings.
-2. Go to Pages.
-3. Set Source to "Deploy from a branch".
-4. Select the main branch and `/docs` folder.
-5. Save.
+## Local preview
+
+The gallery uses `fetch("examples.json")`, which browsers block for local
+`file://` pages. Run any tiny static server from the repository root and open
+the `/docs/` path:
+
+```bash
+python -m http.server 8000
+# then open http://localhost:8000/docs/
+```
+
+Opening `docs/index.html` directly still renders everything except the
+JS-driven gallery (the `<noscript>` static index lists every PDF as a
+fallback). No build step is required.
+
+## GitHub Pages
 
-The site should become available at:
+Published from the `main` branch `/docs` folder (Settings → Pages → Deploy from
+a branch → `main` / `/docs`). Live at:
 
 https://demchaav.github.io/GraphCompose/
diff --git a/docs/examples.json b/docs/examples.json
index e5cfb017..41e8466b 100644
--- a/docs/examples.json
+++ b/docs/examples.json
@@ -9,130 +9,148 @@
           "label": "CV / Resume",
           "examples": [
             {
-              "id": "cv-blue-banner",
+              "id": "cv-blue-banner-v2",
               "title": "Blue Banner",
               "description": "Light-blue full-width section bands with high-contrast headings.",
               "tags": ["cv", "banner", "blue"],
-              "pdf": "showcase/pdf/templates/cv/cv-blue-banner.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-blue-banner.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-blue-banner-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-blue-banner-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvBlueBannerExample.java"
             },
             {
-              "id": "cv-boxed-sections",
+              "id": "cv-boxed-sections-v2",
               "title": "Boxed Sections",
               "description": "Each section wrapped in a grey banner header — bold, structured feel.",
               "tags": ["cv", "structured"],
-              "pdf": "showcase/pdf/templates/cv/cv-boxed-sections.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-boxed-sections.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-boxed-sections-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-boxed-sections-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvBoxedV2Example.java"
             },
             {
-              "id": "cv-centered-headline",
+              "id": "cv-centered-headline-v2",
               "title": "Centered Headline",
               "description": "Centered name + role with full-width accent rules between sections.",
               "tags": ["cv", "centered"],
-              "pdf": "showcase/pdf/templates/cv/cv-centered-headline.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-centered-headline.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-centered-headline-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-centered-headline-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCenteredHeadlineExample.java"
             },
             {
-              "id": "cv-classic-serif",
+              "id": "cv-classic-serif-v2",
               "title": "Classic Serif",
               "description": "Two-page editorial CV with Times-style serif headings and conservative grey rules.",
               "tags": ["cv", "serif", "two-page"],
-              "pdf": "showcase/pdf/templates/cv/cv-classic-serif.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-classic-serif.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-classic-serif-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-classic-serif-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvClassicSerifExample.java"
             },
             {
-              "id": "cv-compact-mono",
+              "id": "cv-compact-mono-v2",
               "title": "Compact Mono",
               "description": "Single-column dense layout with monospace contact line — favourite for engineering roles.",
               "tags": ["cv", "compact", "mono"],
-              "pdf": "showcase/pdf/templates/cv/cv-compact-mono.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-compact-mono.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-compact-mono-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-compact-mono-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCompactMonoExample.java"
             },
             {
-              "id": "cv-editorial-blue",
+              "id": "cv-editorial-blue-v2",
               "title": "Editorial Blue",
               "description": "Magazine-style editorial layout with two-column body and tinted skills table.",
               "tags": ["cv", "editorial", "blue"],
-              "pdf": "showcase/pdf/templates/cv/cv-editorial-blue.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-editorial-blue.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-editorial-blue-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-editorial-blue-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvEditorialBlueExample.java"
             },
             {
-              "id": "cv-engineering-resume",
+              "id": "cv-engineering-resume-v2",
               "title": "Engineering Resume",
               "description": "Tech-lead style layout with prominent skill matrix and stack tagging — was TechLead in v1.5.",
               "tags": ["cv", "tech"],
-              "pdf": "showcase/pdf/templates/cv/cv-engineering-resume.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-engineering-resume.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-engineering-resume-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-engineering-resume-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvEngineeringResumeExample.java"
             },
             {
-              "id": "cv-executive",
+              "id": "cv-executive-v2",
               "title": "Executive",
               "description": "Slate palette with prominent name banner, formal tone, and weighted section dividers.",
               "tags": ["cv", "executive"],
-              "pdf": "showcase/pdf/templates/cv/cv-executive.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-executive.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-executive-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-executive-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvExecutiveExample.java"
             },
             {
-              "id": "cv-modern-professional",
-              "title": "Modern Professional CV",
-              "description": "Same data, ModernProfessional preset — single-file CvFileExample for canonical authoring.",
+              "id": "cv-minimal-underlined-v2",
+              "title": "Minimal Underlined",
+              "description": "Single-column layout with underlined section titles and tight whitespace — minimalist reference shape.",
               "tags": ["cv", "minimal"],
-              "pdf": "showcase/pdf/templates/cv/cv-modern-professional.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-modern-professional.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-minimal-underlined-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-minimal-underlined-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMinimalUnderlinedExample.java"
             },
             {
-              "id": "cv-monogram-sidebar",
+              "id": "cv-mint-editorial-v2",
+              "title": "Mint Editorial",
+              "description": "Magazine-style editorial CV with mint accent palette and two-column body.",
+              "tags": ["cv", "editorial", "mint"],
+              "pdf": "showcase/pdf/templates/cv/cv-mint-editorial-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-mint-editorial-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMintEditorialExample.java"
+            },
+            {
+              "id": "cv-modern-professional-v2",
+              "title": "Modern Professional",
+              "description": "Clean two-column resume with right-aligned header, tinted profile panel, and uppercase section headings.",
+              "tags": ["cv", "minimal"],
+              "pdf": "showcase/pdf/templates/cv/cv-modern-professional-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-modern-professional-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvModernV2Example.java"
+            },
+            {
+              "id": "cv-monogram-sidebar-v2",
               "title": "Monogram Sidebar",
               "description": "Sidebar with monogram badge, accent rule, and structured contact + skills column.",
               "tags": ["cv", "sidebar", "monogram"],
-              "pdf": "showcase/pdf/templates/cv/cv-monogram-sidebar.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-monogram-sidebar.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-monogram-sidebar-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-monogram-sidebar-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMonogramSidebarExample.java"
             },
             {
-              "id": "cv-nordic-clean",
+              "id": "cv-nordic-clean-v2",
               "title": "Nordic Clean",
               "description": "Sidebar layout with soft-tinted PROFILE panel, Nordic palette, and bullet skill list.",
               "tags": ["cv", "sidebar"],
-              "pdf": "showcase/pdf/templates/cv/cv-nordic-clean.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-nordic-clean.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-nordic-clean-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-nordic-clean-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvNordicCleanExample.java"
             },
             {
-              "id": "cv-panel",
+              "id": "cv-panel-v2",
               "title": "Panel",
               "description": "Soft-tinted panels per section, Product-Leader feel — was ProductLeader in v1.5.",
               "tags": ["cv", "panel"],
-              "pdf": "showcase/pdf/templates/cv/cv-panel.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-panel.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-panel-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-panel-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvPanelExample.java"
             },
             {
-              "id": "cv-sidebar-portrait",
+              "id": "cv-sidebar-portrait-v2",
               "title": "Sidebar Portrait",
               "description": "Edge-to-edge grey sidebar with portrait photo, contact stack, and skills.",
               "tags": ["cv", "sidebar", "portrait"],
-              "pdf": "showcase/pdf/templates/cv/cv-sidebar-portrait.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-sidebar-portrait.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-sidebar-portrait-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-sidebar-portrait-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvSidebarPortraitExample.java"
             },
             {
-              "id": "cv-timeline-minimal",
+              "id": "cv-timeline-minimal-v2",
               "title": "Timeline Minimal",
               "description": "Vertical timeline of roles with bullet markers and tight whitespace.",
               "tags": ["cv", "timeline"],
-              "pdf": "showcase/pdf/templates/cv/cv-timeline-minimal.pdf",
-              "screenshot": "showcase/screenshots/templates/cv/cv-timeline-minimal.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/cv/cv-timeline-minimal-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/cv/cv-timeline-minimal-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvTimelineMinimalExample.java"
             }
           ]
         },
@@ -213,139 +231,139 @@
           "label": "Cover Letter",
           "examples": [
             {
-              "id": "cover-letter",
-              "title": "Cover Letter (canonical)",
-              "description": "Single-file canonical cover letter authored via CoverLetterFileExample.",
-              "tags": ["letter", "letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
-            },
-            {
-              "id": "cover-letter-blue-banner",
+              "id": "cover-letter-blue-banner-v2",
               "title": "Blue Banner letter",
               "description": "Letter paired with Blue Banner CV.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-blue-banner.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-blue-banner.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-blue-banner-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-blue-banner-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvBlueBannerLetterV2Example.java"
             },
             {
-              "id": "cover-letter-boxed-sections",
+              "id": "cover-letter-boxed-sections-v2",
               "title": "Boxed Sections letter",
               "description": "Letter with grey-banner section headings.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-boxed-sections.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-boxed-sections.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-boxed-sections-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-boxed-sections-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvBoxedSectionsLetterV2Example.java"
             },
             {
-              "id": "cover-letter-centered-headline",
+              "id": "cover-letter-centered-headline-v2",
               "title": "Centered Headline letter",
               "description": "Letter with centered name + accent rules.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-centered-headline.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-centered-headline.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-centered-headline-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-centered-headline-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvCenteredHeadlineLetterV2Example.java"
             },
             {
-              "id": "cover-letter-classic-serif",
+              "id": "cover-letter-classic-serif-v2",
               "title": "Classic Serif letter",
               "description": "Letter with Times-style serif typography.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-classic-serif.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-classic-serif.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-classic-serif-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-classic-serif-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvClassicSerifLetterV2Example.java"
             },
             {
-              "id": "cover-letter-compact-mono",
+              "id": "cover-letter-compact-mono-v2",
               "title": "Compact Mono letter",
               "description": "Letter with mono accent and compact spacing.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-compact-mono.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-compact-mono.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-compact-mono-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-compact-mono-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvCompactMonoLetterV2Example.java"
             },
             {
-              "id": "cover-letter-editorial-blue",
+              "id": "cover-letter-editorial-blue-v2",
               "title": "Editorial Blue letter",
               "description": "Editorial-magazine letter paired with Editorial Blue CV.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-editorial-blue.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-editorial-blue.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-editorial-blue-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-editorial-blue-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvEditorialBlueLetterV2Example.java"
             },
             {
-              "id": "cover-letter-engineering-resume",
+              "id": "cover-letter-engineering-resume-v2",
               "title": "Engineering letter",
               "description": "Letter paired with EngineeringResume palette.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-engineering-resume.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-engineering-resume.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-engineering-resume-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-engineering-resume-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvEngineeringResumeLetterV2Example.java"
             },
             {
-              "id": "cover-letter-executive",
+              "id": "cover-letter-executive-v2",
               "title": "Executive letter",
               "description": "Slate-palette executive letter.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-executive.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-executive.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-executive-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-executive-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvExecutiveLetterV2Example.java"
+            },
+            {
+              "id": "cover-letter-mint-editorial-v2",
+              "title": "Mint Editorial letter",
+              "description": "Letter paired with Mint Editorial CV — magazine-style mint accent.",
+              "tags": ["letter"],
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-mint-editorial-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-mint-editorial-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvMintEditorialLetterV2Example.java"
             },
             {
-              "id": "cover-letter-modern-professional",
+              "id": "cover-letter-modern-professional-v2",
               "title": "Modern Professional letter",
               "description": "Letter paired with the Modern Professional CV palette.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-modern-professional.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-modern-professional.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-modern-professional-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-modern-professional-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvModernProfessionalLetterV2Example.java"
             },
             {
-              "id": "cover-letter-monogram-sidebar",
+              "id": "cover-letter-monogram-sidebar-v2",
               "title": "Monogram Sidebar letter",
               "description": "Letter paired with Monogram Sidebar CV.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvMonogramSidebarLetterV2Example.java"
             },
             {
-              "id": "cover-letter-nordic-clean",
+              "id": "cover-letter-nordic-clean-v2",
               "title": "Nordic Clean letter",
               "description": "Letter paired with the Nordic Clean CV palette.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-nordic-clean.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-nordic-clean.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-nordic-clean-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-nordic-clean-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvNordicCleanLetterV2Example.java"
             },
             {
-              "id": "cover-letter-panel",
+              "id": "cover-letter-panel-v2",
               "title": "Panel letter",
               "description": "Letter paired with Panel CV soft-tinted panels.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-panel.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-panel.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-panel-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-panel-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvPanelLetterV2Example.java"
             },
             {
-              "id": "cover-letter-sidebar-portrait",
+              "id": "cover-letter-sidebar-portrait-v2",
               "title": "Sidebar Portrait letter",
               "description": "Letter paired with Sidebar Portrait CV.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvSidebarPortraitLetterV2Example.java"
             },
             {
-              "id": "cover-letter-timeline-minimal",
+              "id": "cover-letter-timeline-minimal-v2",
               "title": "Timeline Minimal letter",
               "description": "Letter with timeline-style minimal accents.",
               "tags": ["letter"],
-              "pdf": "showcase/pdf/templates/coverletter/cover-letter-timeline-minimal.pdf",
-              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal.png",
-              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"
+              "pdf": "showcase/pdf/templates/coverletter/cover-letter-timeline-minimal-v2.pdf",
+              "screenshot": "showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal-v2.png",
+              "code": "https://github.com/DemchaAV/GraphCompose/blob/develop/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvTimelineMinimalLetterV2Example.java"
             }
           ]
         }
diff --git a/docs/index.html b/docs/index.html
index f91ed30e..64ad58c6 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -11,6 +11,19 @@
   <link rel="icon" href="assets/logo/graphcompose-logo.png">
   <link rel="stylesheet" href="styles.css">
   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/themes/prism-tomorrow.min.css">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=Space+Grotesk:wght@500;600;700&display=swap">
+  <!-- Apply the saved theme before first paint to avoid a flash. Dark is the default. -->
+  <script>
+    (function () {
+      try {
+        if (localStorage.getItem('gc-theme') === 'light') {
+          document.documentElement.setAttribute('data-theme', 'light');
+        }
+      } catch (e) {}
+    })();
+  </script>
 
   <!-- Open Graph / Facebook -->
   <meta property="og:type" content="website">
@@ -44,9 +57,9 @@
         "applicationSubCategory": "Library",
         "operatingSystem": "Cross-platform (JVM 21+)",
         "programmingLanguage": "Java",
-        "softwareVersion": "1.6.1",
+        "softwareVersion": "1.6.4",
         "url": "https://demchaav.github.io/GraphCompose/",
-        "downloadUrl": "https://jitpack.io/#DemchaAV/GraphCompose/v1.6.1",
+        "downloadUrl": "https://jitpack.io/#DemchaAV/GraphCompose/v1.6.4",
         "image": "https://demchaav.github.io/GraphCompose/assets/logo/graphcompose-logo.png",
         "license": "https://github.com/DemchaAV/GraphCompose/blob/main/LICENSE",
         "author": {
@@ -145,13 +158,17 @@
       <a href="#flagships-section">Flagships</a>
       <a href="#install">Install</a>
       <a href="https://github.com/DemchaAV/GraphCompose">GitHub</a>
+      <button id="theme-toggle" class="theme-toggle" type="button" aria-label="Switch between light and dark theme" title="Toggle theme">
+        <svg class="icon-moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"></path></svg>
+        <svg class="icon-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="5"></circle><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"></path></svg>
+      </button>
     </nav>
   </header>
 
   <main id="top">
     <section class="hero section-shell" aria-labelledby="hero-title">
       <div class="hero-copy">
-        <p class="eyebrow">Java &middot; v1.6.1 &middot; MIT</p>
+        <p class="eyebrow">Java &middot; v1.6.4 &middot; MIT</p>
         <h1 id="hero-title">Java PDF layout engine for structured business documents.</h1>
         <p class="hero-lead">Describe documents. Render polished PDFs. A semantic layout engine for Java services that need <b>structured, paginated, theme-driven</b> output &mdash; CVs, invoices, proposals, reports.</p>
         <p class="hero-text">No drawing API. No pixel arithmetic. You compose <code>ParagraphNode</code>, <code>TableNode</code>, <code>SectionNode</code>; GraphCompose handles measurement, pagination, fonts, and PDFBox rendering.</p>
@@ -221,7 +238,7 @@ <h4>Maven</h4>
 &lt;dependency&gt;
   &lt;groupId&gt;com.github.DemchaAV&lt;/groupId&gt;
   &lt;artifactId&gt;GraphCompose&lt;/artifactId&gt;
-  &lt;version&gt;v1.6.1&lt;/version&gt;
+  &lt;version&gt;v1.6.4&lt;/version&gt;
 &lt;/dependency&gt;</code></pre>
         </div>
         <div class="install-block">
@@ -232,7 +249,7 @@ <h4>Gradle</h4>
 
 dependencies {
   implementation(
-    'com.github.DemchaAV:GraphCompose:v1.6.1'
+    'com.github.DemchaAV:GraphCompose:v1.6.4'
   )
 }</code></pre>
         </div>
@@ -386,7 +403,7 @@ <h3>Markdown-aware bodies</h3>
     <p>
       <a href="https://github.com/DemchaAV/GraphCompose">GitHub</a> &middot;
       <a href="https://github.com/DemchaAV/GraphCompose/blob/main/CHANGELOG.md">Changelog</a> &middot;
-      <a href="https://github.com/DemchaAV/GraphCompose/blob/main/docs/migration-v1-5-to-v1-6.md">v1.5 &rarr; v1.6 migration</a>
+      <a href="https://github.com/DemchaAV/GraphCompose/blob/main/docs/roadmaps/migration-v1-5-to-v1-6.md">v1.5 &rarr; v1.6 migration</a>
     </p>
   </footer>
 
@@ -395,6 +412,22 @@ <h3>Markdown-aware bodies</h3>
   <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-clike.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-java.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-groovy.min.js"></script>
+  <script>
+    (function () {
+      var btn = document.getElementById('theme-toggle');
+      if (!btn) return;
+      btn.addEventListener('click', function () {
+        var light = document.documentElement.getAttribute('data-theme') === 'light';
+        if (light) {
+          document.documentElement.removeAttribute('data-theme');
+          try { localStorage.setItem('gc-theme', 'dark'); } catch (e) {}
+        } else {
+          document.documentElement.setAttribute('data-theme', 'light');
+          try { localStorage.setItem('gc-theme', 'light'); } catch (e) {}
+        }
+      });
+    })();
+  </script>
   <script src="examples.js"></script>
 </body>
 </html>
diff --git a/docs/showcase/pdf/features/barcodes/barcode-showcase.pdf b/docs/showcase/pdf/features/barcodes/barcode-showcase.pdf
index ecdfbbaa..e9737a95 100644
Binary files a/docs/showcase/pdf/features/barcodes/barcode-showcase.pdf and b/docs/showcase/pdf/features/barcodes/barcode-showcase.pdf differ
diff --git a/docs/showcase/pdf/features/canvas/canvas-layer-showcase.pdf b/docs/showcase/pdf/features/canvas/canvas-layer-showcase.pdf
index 8e4bdbe8..eb3b091f 100644
Binary files a/docs/showcase/pdf/features/canvas/canvas-layer-showcase.pdf and b/docs/showcase/pdf/features/canvas/canvas-layer-showcase.pdf differ
diff --git a/docs/showcase/pdf/features/chrome/pdf-chrome.pdf b/docs/showcase/pdf/features/chrome/pdf-chrome.pdf
index be0c4672..94a34ec7 100644
Binary files a/docs/showcase/pdf/features/chrome/pdf-chrome.pdf and b/docs/showcase/pdf/features/chrome/pdf-chrome.pdf differ
diff --git a/docs/showcase/pdf/features/lists/nested-list-showcase.pdf b/docs/showcase/pdf/features/lists/nested-list-showcase.pdf
index da7eb5ff..e000d6b8 100644
Binary files a/docs/showcase/pdf/features/lists/nested-list-showcase.pdf and b/docs/showcase/pdf/features/lists/nested-list-showcase.pdf differ
diff --git a/docs/showcase/pdf/features/shapes/shape-container.pdf b/docs/showcase/pdf/features/shapes/shape-container.pdf
index d7914110..aff982bc 100644
Binary files a/docs/showcase/pdf/features/shapes/shape-container.pdf and b/docs/showcase/pdf/features/shapes/shape-container.pdf differ
diff --git a/docs/showcase/pdf/features/snapshots/invoice-snapshot-regression.pdf b/docs/showcase/pdf/features/snapshots/invoice-snapshot-regression.pdf
index 8c12d30d..7928351f 100644
Binary files a/docs/showcase/pdf/features/snapshots/invoice-snapshot-regression.pdf and b/docs/showcase/pdf/features/snapshots/invoice-snapshot-regression.pdf differ
diff --git a/docs/showcase/pdf/features/streaming/invoice-http-stream.pdf b/docs/showcase/pdf/features/streaming/invoice-http-stream.pdf
index 3674e0eb..34f54fa5 100644
Binary files a/docs/showcase/pdf/features/streaming/invoice-http-stream.pdf and b/docs/showcase/pdf/features/streaming/invoice-http-stream.pdf differ
diff --git a/docs/showcase/pdf/features/tables/composed-table-cell-showcase.pdf b/docs/showcase/pdf/features/tables/composed-table-cell-showcase.pdf
index 622b9863..ea0b4691 100644
Binary files a/docs/showcase/pdf/features/tables/composed-table-cell-showcase.pdf and b/docs/showcase/pdf/features/tables/composed-table-cell-showcase.pdf differ
diff --git a/docs/showcase/pdf/features/tables/table-advanced.pdf b/docs/showcase/pdf/features/tables/table-advanced.pdf
index a271abe1..928313c1 100644
Binary files a/docs/showcase/pdf/features/tables/table-advanced.pdf and b/docs/showcase/pdf/features/tables/table-advanced.pdf differ
diff --git a/docs/showcase/pdf/features/text/rich-text-showcase.pdf b/docs/showcase/pdf/features/text/rich-text-showcase.pdf
index 730cbaf7..e8061d3d 100644
Binary files a/docs/showcase/pdf/features/text/rich-text-showcase.pdf and b/docs/showcase/pdf/features/text/rich-text-showcase.pdf differ
diff --git a/docs/showcase/pdf/features/text/section-presets.pdf b/docs/showcase/pdf/features/text/section-presets.pdf
index 53163edc..91410792 100644
Binary files a/docs/showcase/pdf/features/text/section-presets.pdf and b/docs/showcase/pdf/features/text/section-presets.pdf differ
diff --git a/docs/showcase/pdf/features/themes/invoice-custom-theme.pdf b/docs/showcase/pdf/features/themes/invoice-custom-theme.pdf
index 39ac7539..2a40dfbc 100644
Binary files a/docs/showcase/pdf/features/themes/invoice-custom-theme.pdf and b/docs/showcase/pdf/features/themes/invoice-custom-theme.pdf differ
diff --git a/docs/showcase/pdf/features/transforms/transforms.pdf b/docs/showcase/pdf/features/transforms/transforms.pdf
index bcf5a03e..83c734a0 100644
Binary files a/docs/showcase/pdf/features/transforms/transforms.pdf and b/docs/showcase/pdf/features/transforms/transforms.pdf differ
diff --git a/docs/showcase/pdf/flagships/default/business-report.pdf b/docs/showcase/pdf/flagships/default/business-report.pdf
index b49ae3ff..9a83b750 100644
Binary files a/docs/showcase/pdf/flagships/default/business-report.pdf and b/docs/showcase/pdf/flagships/default/business-report.pdf differ
diff --git a/docs/showcase/pdf/flagships/default/master-showcase.pdf b/docs/showcase/pdf/flagships/default/master-showcase.pdf
index ba798f38..33f1cb8f 100644
Binary files a/docs/showcase/pdf/flagships/default/master-showcase.pdf and b/docs/showcase/pdf/flagships/default/master-showcase.pdf differ
diff --git a/docs/showcase/pdf/flagships/default/module-first-profile.pdf b/docs/showcase/pdf/flagships/default/module-first-profile.pdf
index af493932..cbaf3763 100644
Binary files a/docs/showcase/pdf/flagships/default/module-first-profile.pdf and b/docs/showcase/pdf/flagships/default/module-first-profile.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-compact-mono.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-blue-banner-v2.pdf
similarity index 60%
rename from docs/showcase/pdf/templates/coverletter/cover-letter-compact-mono.pdf
rename to docs/showcase/pdf/templates/coverletter/cover-letter-blue-banner-v2.pdf
index 9e06d442..b015977e 100644
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-compact-mono.pdf and b/docs/showcase/pdf/templates/coverletter/cover-letter-blue-banner-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-blue-banner.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-blue-banner.pdf
deleted file mode 100644
index 31c63839..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-blue-banner.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-boxed-sections-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-boxed-sections-v2.pdf
new file mode 100644
index 00000000..8415b128
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-boxed-sections-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-boxed-sections.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-boxed-sections.pdf
deleted file mode 100644
index 7fbcb877..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-boxed-sections.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-executive.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-centered-headline-v2.pdf
similarity index 66%
rename from docs/showcase/pdf/templates/coverletter/cover-letter-executive.pdf
rename to docs/showcase/pdf/templates/coverletter/cover-letter-centered-headline-v2.pdf
index 073258e1..9ece243f 100644
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-executive.pdf and b/docs/showcase/pdf/templates/coverletter/cover-letter-centered-headline-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-classic-serif-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-classic-serif-v2.pdf
new file mode 100644
index 00000000..589801df
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-classic-serif-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-classic-serif.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-classic-serif.pdf
deleted file mode 100644
index d8e40fda..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-classic-serif.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-compact-mono-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-compact-mono-v2.pdf
new file mode 100644
index 00000000..e146df9b
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-compact-mono-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-editorial-blue-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-editorial-blue-v2.pdf
new file mode 100644
index 00000000..abd42549
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-editorial-blue-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-editorial-blue.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-editorial-blue.pdf
deleted file mode 100644
index 34602b23..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-editorial-blue.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-engineering-resume-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-engineering-resume-v2.pdf
new file mode 100644
index 00000000..368f0f8f
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-engineering-resume-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-engineering-resume.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-engineering-resume.pdf
deleted file mode 100644
index 0e6973b8..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-engineering-resume.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-panel.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-executive-v2.pdf
similarity index 66%
rename from docs/showcase/pdf/templates/coverletter/cover-letter-panel.pdf
rename to docs/showcase/pdf/templates/coverletter/cover-letter-executive-v2.pdf
index 65c65159..f856c611 100644
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-panel.pdf and b/docs/showcase/pdf/templates/coverletter/cover-letter-executive-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-mint-editorial-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-mint-editorial-v2.pdf
new file mode 100644
index 00000000..c87798cc
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-mint-editorial-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-modern-professional-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-modern-professional-v2.pdf
new file mode 100644
index 00000000..8ebec75f
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-modern-professional-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-modern-professional.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-modern-professional.pdf
deleted file mode 100644
index 30fbb23a..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-modern-professional.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar-v2.pdf
new file mode 100644
index 00000000..e03e6d78
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar.pdf
deleted file mode 100644
index 50d53bb9..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-monogram-sidebar.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-nordic-clean-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-nordic-clean-v2.pdf
new file mode 100644
index 00000000..ba16ba43
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-nordic-clean-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-nordic-clean.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-nordic-clean.pdf
deleted file mode 100644
index 7b3905b4..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-nordic-clean.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-centered-headline.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-panel-v2.pdf
similarity index 66%
rename from docs/showcase/pdf/templates/coverletter/cover-letter-centered-headline.pdf
rename to docs/showcase/pdf/templates/coverletter/cover-letter-panel-v2.pdf
index 602fb272..b3403290 100644
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-centered-headline.pdf and b/docs/showcase/pdf/templates/coverletter/cover-letter-panel-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait-v2.pdf
new file mode 100644
index 00000000..e5fe829e
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait.pdf
deleted file mode 100644
index dc5a2c4d..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-sidebar-portrait.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-timeline-minimal-v2.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-timeline-minimal-v2.pdf
new file mode 100644
index 00000000..b6911e6a
Binary files /dev/null and b/docs/showcase/pdf/templates/coverletter/cover-letter-timeline-minimal-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter-timeline-minimal.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter-timeline-minimal.pdf
deleted file mode 100644
index 73a95b35..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter-timeline-minimal.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/coverletter/cover-letter.pdf b/docs/showcase/pdf/templates/coverletter/cover-letter.pdf
deleted file mode 100644
index c3dd9a90..00000000
Binary files a/docs/showcase/pdf/templates/coverletter/cover-letter.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-blue-banner-v2.pdf b/docs/showcase/pdf/templates/cv/cv-blue-banner-v2.pdf
new file mode 100644
index 00000000..69260433
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-blue-banner-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-blue-banner.pdf b/docs/showcase/pdf/templates/cv/cv-blue-banner.pdf
deleted file mode 100644
index 4aaf0199..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-blue-banner.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-boxed-sections-v2.pdf b/docs/showcase/pdf/templates/cv/cv-boxed-sections-v2.pdf
new file mode 100644
index 00000000..f29781d8
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-boxed-sections-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-centered-headline-v2.pdf b/docs/showcase/pdf/templates/cv/cv-centered-headline-v2.pdf
new file mode 100644
index 00000000..bdd491b6
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-centered-headline-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-centered-headline.pdf b/docs/showcase/pdf/templates/cv/cv-centered-headline.pdf
deleted file mode 100644
index 6cfbebdb..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-centered-headline.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-classic-serif-v2.pdf b/docs/showcase/pdf/templates/cv/cv-classic-serif-v2.pdf
new file mode 100644
index 00000000..6ceb02c8
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-classic-serif-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-classic-serif.pdf b/docs/showcase/pdf/templates/cv/cv-classic-serif.pdf
deleted file mode 100644
index 9c121794..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-classic-serif.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-compact-mono-v2.pdf b/docs/showcase/pdf/templates/cv/cv-compact-mono-v2.pdf
new file mode 100644
index 00000000..1cdb1010
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-compact-mono-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-compact-mono.pdf b/docs/showcase/pdf/templates/cv/cv-compact-mono.pdf
deleted file mode 100644
index 406ca52c..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-compact-mono.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-editorial-blue-v2.pdf b/docs/showcase/pdf/templates/cv/cv-editorial-blue-v2.pdf
new file mode 100644
index 00000000..d8a758a3
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-editorial-blue-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-editorial-blue.pdf b/docs/showcase/pdf/templates/cv/cv-editorial-blue.pdf
deleted file mode 100644
index a7e0b9bb..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-editorial-blue.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-engineering-resume-v2.pdf b/docs/showcase/pdf/templates/cv/cv-engineering-resume-v2.pdf
new file mode 100644
index 00000000..b3a54e9f
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-engineering-resume-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-engineering-resume.pdf b/docs/showcase/pdf/templates/cv/cv-engineering-resume.pdf
deleted file mode 100644
index 0cba0383..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-engineering-resume.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-executive-v2.pdf b/docs/showcase/pdf/templates/cv/cv-executive-v2.pdf
new file mode 100644
index 00000000..96a0a3f0
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-executive-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-executive.pdf b/docs/showcase/pdf/templates/cv/cv-executive.pdf
deleted file mode 100644
index 44fe9573..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-executive.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-boxed-sections.pdf b/docs/showcase/pdf/templates/cv/cv-minimal-underlined-v2.pdf
similarity index 58%
rename from docs/showcase/pdf/templates/cv/cv-boxed-sections.pdf
rename to docs/showcase/pdf/templates/cv/cv-minimal-underlined-v2.pdf
index 5da24952..c280855e 100644
Binary files a/docs/showcase/pdf/templates/cv/cv-boxed-sections.pdf and b/docs/showcase/pdf/templates/cv/cv-minimal-underlined-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-mint-editorial-v2.pdf b/docs/showcase/pdf/templates/cv/cv-mint-editorial-v2.pdf
new file mode 100644
index 00000000..c9544a24
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-mint-editorial-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-modern-professional-v2.pdf b/docs/showcase/pdf/templates/cv/cv-modern-professional-v2.pdf
new file mode 100644
index 00000000..2cee811f
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-modern-professional-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-modern-professional.pdf b/docs/showcase/pdf/templates/cv/cv-modern-professional.pdf
deleted file mode 100644
index 432bb263..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-modern-professional.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-monogram-sidebar-v2.pdf b/docs/showcase/pdf/templates/cv/cv-monogram-sidebar-v2.pdf
new file mode 100644
index 00000000..daeb4af2
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-monogram-sidebar-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-monogram-sidebar.pdf b/docs/showcase/pdf/templates/cv/cv-monogram-sidebar.pdf
deleted file mode 100644
index c6e0d1c0..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-monogram-sidebar.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-nordic-clean-v2.pdf b/docs/showcase/pdf/templates/cv/cv-nordic-clean-v2.pdf
new file mode 100644
index 00000000..61bca3dc
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-nordic-clean-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-nordic-clean.pdf b/docs/showcase/pdf/templates/cv/cv-nordic-clean.pdf
deleted file mode 100644
index 8fc03a43..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-nordic-clean.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-panel-v2.pdf b/docs/showcase/pdf/templates/cv/cv-panel-v2.pdf
new file mode 100644
index 00000000..18bab824
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-panel-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-panel.pdf b/docs/showcase/pdf/templates/cv/cv-panel.pdf
deleted file mode 100644
index 058deaf7..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-panel.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/cv/cv-sidebar-portrait.pdf b/docs/showcase/pdf/templates/cv/cv-sidebar-portrait-v2.pdf
similarity index 92%
rename from docs/showcase/pdf/templates/cv/cv-sidebar-portrait.pdf
rename to docs/showcase/pdf/templates/cv/cv-sidebar-portrait-v2.pdf
index 47fd37e5..c9de20e7 100644
Binary files a/docs/showcase/pdf/templates/cv/cv-sidebar-portrait.pdf and b/docs/showcase/pdf/templates/cv/cv-sidebar-portrait-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-timeline-minimal-v2.pdf b/docs/showcase/pdf/templates/cv/cv-timeline-minimal-v2.pdf
new file mode 100644
index 00000000..e65dc60c
Binary files /dev/null and b/docs/showcase/pdf/templates/cv/cv-timeline-minimal-v2.pdf differ
diff --git a/docs/showcase/pdf/templates/cv/cv-timeline-minimal.pdf b/docs/showcase/pdf/templates/cv/cv-timeline-minimal.pdf
deleted file mode 100644
index ba35acdc..00000000
Binary files a/docs/showcase/pdf/templates/cv/cv-timeline-minimal.pdf and /dev/null differ
diff --git a/docs/showcase/pdf/templates/invoice/invoice-cinematic.pdf b/docs/showcase/pdf/templates/invoice/invoice-cinematic.pdf
index 41d3eaf2..c885e2ad 100644
Binary files a/docs/showcase/pdf/templates/invoice/invoice-cinematic.pdf and b/docs/showcase/pdf/templates/invoice/invoice-cinematic.pdf differ
diff --git a/docs/showcase/pdf/templates/invoice/invoice.pdf b/docs/showcase/pdf/templates/invoice/invoice.pdf
index 56c31534..16109a1a 100644
Binary files a/docs/showcase/pdf/templates/invoice/invoice.pdf and b/docs/showcase/pdf/templates/invoice/invoice.pdf differ
diff --git a/docs/showcase/pdf/templates/proposal/project-proposal-cinematic.pdf b/docs/showcase/pdf/templates/proposal/project-proposal-cinematic.pdf
index 657b6fc2..9d5805fe 100644
Binary files a/docs/showcase/pdf/templates/proposal/project-proposal-cinematic.pdf and b/docs/showcase/pdf/templates/proposal/project-proposal-cinematic.pdf differ
diff --git a/docs/showcase/pdf/templates/proposal/proposal-cinematic.pdf b/docs/showcase/pdf/templates/proposal/proposal-cinematic.pdf
index 7c1ff107..0791b37a 100644
Binary files a/docs/showcase/pdf/templates/proposal/proposal-cinematic.pdf and b/docs/showcase/pdf/templates/proposal/proposal-cinematic.pdf differ
diff --git a/docs/showcase/pdf/templates/proposal/proposal.pdf b/docs/showcase/pdf/templates/proposal/proposal.pdf
index 204572b7..e537cac6 100644
Binary files a/docs/showcase/pdf/templates/proposal/proposal.pdf and b/docs/showcase/pdf/templates/proposal/proposal.pdf differ
diff --git a/docs/showcase/pdf/templates/schedule/weekly-schedule.pdf b/docs/showcase/pdf/templates/schedule/weekly-schedule.pdf
index 460fb1d0..76fc4fc8 100644
Binary files a/docs/showcase/pdf/templates/schedule/weekly-schedule.pdf and b/docs/showcase/pdf/templates/schedule/weekly-schedule.pdf differ
diff --git a/docs/showcase/screenshots/features/chrome/pdf-chrome.png b/docs/showcase/screenshots/features/chrome/pdf-chrome.png
index 6062c316..ee70abdf 100644
Binary files a/docs/showcase/screenshots/features/chrome/pdf-chrome.png and b/docs/showcase/screenshots/features/chrome/pdf-chrome.png differ
diff --git a/docs/showcase/screenshots/flagships/default/master-showcase.png b/docs/showcase/screenshots/flagships/default/master-showcase.png
index 70a08ca2..8987b533 100644
Binary files a/docs/showcase/screenshots/flagships/default/master-showcase.png and b/docs/showcase/screenshots/flagships/default/master-showcase.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-blue-banner-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-blue-banner-v2.png
new file mode 100644
index 00000000..9f44bb98
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-blue-banner-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-blue-banner.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-blue-banner.png
deleted file mode 100644
index fd99e8eb..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-blue-banner.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-boxed-sections-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-boxed-sections-v2.png
new file mode 100644
index 00000000..10d618e2
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-boxed-sections-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-boxed-sections.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-boxed-sections.png
deleted file mode 100644
index 3716bd7d..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-boxed-sections.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-centered-headline-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-centered-headline-v2.png
new file mode 100644
index 00000000..16d4f5f8
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-centered-headline-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-centered-headline.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-centered-headline.png
deleted file mode 100644
index 49476c5f..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-centered-headline.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-classic-serif-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-classic-serif-v2.png
new file mode 100644
index 00000000..6d4ff6e9
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-classic-serif-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-classic-serif.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-classic-serif.png
deleted file mode 100644
index 0b57755e..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-classic-serif.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-compact-mono-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-compact-mono-v2.png
new file mode 100644
index 00000000..9223b2bf
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-compact-mono-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-compact-mono.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-compact-mono.png
deleted file mode 100644
index e8c56e9f..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-compact-mono.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-editorial-blue-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-editorial-blue-v2.png
new file mode 100644
index 00000000..1812f994
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-editorial-blue-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-editorial-blue.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-editorial-blue.png
deleted file mode 100644
index 4da12c0c..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-editorial-blue.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-engineering-resume-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-engineering-resume-v2.png
new file mode 100644
index 00000000..2aa14a81
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-engineering-resume-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-engineering-resume.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-engineering-resume.png
deleted file mode 100644
index 4e720d31..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-engineering-resume.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-executive-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-executive-v2.png
new file mode 100644
index 00000000..40704c83
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-executive-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-executive.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-executive.png
deleted file mode 100644
index ae47d844..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-executive.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-mint-editorial-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-mint-editorial-v2.png
new file mode 100644
index 00000000..fbe0c0b2
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-mint-editorial-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-modern-professional-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-modern-professional-v2.png
new file mode 100644
index 00000000..d84e4654
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-modern-professional-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-modern-professional.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-modern-professional.png
deleted file mode 100644
index 56b8c04d..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-modern-professional.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar-v2.png
new file mode 100644
index 00000000..990d3ca2
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar.png
deleted file mode 100644
index 35d7f592..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-monogram-sidebar.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-nordic-clean-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-nordic-clean-v2.png
new file mode 100644
index 00000000..f2d4c592
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-nordic-clean-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-nordic-clean.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-nordic-clean.png
deleted file mode 100644
index d4aec650..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-nordic-clean.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-panel-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-panel-v2.png
new file mode 100644
index 00000000..29d5a8be
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-panel-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-panel.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-panel.png
deleted file mode 100644
index 98509f7e..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-panel.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait-v2.png
new file mode 100644
index 00000000..44540137
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait.png
deleted file mode 100644
index a563446b..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-sidebar-portrait.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal-v2.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal-v2.png
new file mode 100644
index 00000000..b5eb85c4
Binary files /dev/null and b/docs/showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal-v2.png differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal.png b/docs/showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal.png
deleted file mode 100644
index 6b1a7eb7..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter-timeline-minimal.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/coverletter/cover-letter.png b/docs/showcase/screenshots/templates/coverletter/cover-letter.png
deleted file mode 100644
index 5217d687..00000000
Binary files a/docs/showcase/screenshots/templates/coverletter/cover-letter.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-blue-banner-v2.png b/docs/showcase/screenshots/templates/cv/cv-blue-banner-v2.png
new file mode 100644
index 00000000..d223c22e
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-blue-banner-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-blue-banner.png b/docs/showcase/screenshots/templates/cv/cv-blue-banner.png
deleted file mode 100644
index aa00d6ee..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-blue-banner.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-boxed-sections-v2.png b/docs/showcase/screenshots/templates/cv/cv-boxed-sections-v2.png
new file mode 100644
index 00000000..08c0bf1d
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-boxed-sections-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-boxed-sections.png b/docs/showcase/screenshots/templates/cv/cv-boxed-sections.png
deleted file mode 100644
index fc7a7c21..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-boxed-sections.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-centered-headline-v2.png b/docs/showcase/screenshots/templates/cv/cv-centered-headline-v2.png
new file mode 100644
index 00000000..cda3ff5a
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-centered-headline-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-centered-headline.png b/docs/showcase/screenshots/templates/cv/cv-centered-headline.png
deleted file mode 100644
index 53606721..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-centered-headline.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-classic-serif-v2.png b/docs/showcase/screenshots/templates/cv/cv-classic-serif-v2.png
new file mode 100644
index 00000000..7ef75bdf
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-classic-serif-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-classic-serif.png b/docs/showcase/screenshots/templates/cv/cv-classic-serif.png
deleted file mode 100644
index 8200e3aa..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-classic-serif.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-compact-mono-v2.png b/docs/showcase/screenshots/templates/cv/cv-compact-mono-v2.png
new file mode 100644
index 00000000..69c84ad3
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-compact-mono-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-compact-mono.png b/docs/showcase/screenshots/templates/cv/cv-compact-mono.png
deleted file mode 100644
index c78c8a05..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-compact-mono.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-editorial-blue-v2.png b/docs/showcase/screenshots/templates/cv/cv-editorial-blue-v2.png
new file mode 100644
index 00000000..7bf7651a
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-editorial-blue-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-editorial-blue.png b/docs/showcase/screenshots/templates/cv/cv-editorial-blue.png
deleted file mode 100644
index cc270529..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-editorial-blue.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-engineering-resume-v2.png b/docs/showcase/screenshots/templates/cv/cv-engineering-resume-v2.png
new file mode 100644
index 00000000..5835787e
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-engineering-resume-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-engineering-resume.png b/docs/showcase/screenshots/templates/cv/cv-engineering-resume.png
deleted file mode 100644
index fb4874b4..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-engineering-resume.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-executive-v2.png b/docs/showcase/screenshots/templates/cv/cv-executive-v2.png
new file mode 100644
index 00000000..108db297
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-executive-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-executive.png b/docs/showcase/screenshots/templates/cv/cv-executive.png
deleted file mode 100644
index d34e443d..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-executive.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-minimal-underlined-v2.png b/docs/showcase/screenshots/templates/cv/cv-minimal-underlined-v2.png
new file mode 100644
index 00000000..4858e1b9
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-minimal-underlined-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-mint-editorial-v2.png b/docs/showcase/screenshots/templates/cv/cv-mint-editorial-v2.png
new file mode 100644
index 00000000..e3e870fb
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-mint-editorial-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-modern-professional-v2.png b/docs/showcase/screenshots/templates/cv/cv-modern-professional-v2.png
new file mode 100644
index 00000000..ff098526
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-modern-professional-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-modern-professional.png b/docs/showcase/screenshots/templates/cv/cv-modern-professional.png
deleted file mode 100644
index cb0ebd29..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-modern-professional.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-monogram-sidebar-v2.png b/docs/showcase/screenshots/templates/cv/cv-monogram-sidebar-v2.png
new file mode 100644
index 00000000..8a6d58f5
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-monogram-sidebar-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-monogram-sidebar.png b/docs/showcase/screenshots/templates/cv/cv-monogram-sidebar.png
deleted file mode 100644
index 5083720c..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-monogram-sidebar.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-nordic-clean-v2.png b/docs/showcase/screenshots/templates/cv/cv-nordic-clean-v2.png
new file mode 100644
index 00000000..5861d979
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-nordic-clean-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-nordic-clean.png b/docs/showcase/screenshots/templates/cv/cv-nordic-clean.png
deleted file mode 100644
index be948452..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-nordic-clean.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-panel-v2.png b/docs/showcase/screenshots/templates/cv/cv-panel-v2.png
new file mode 100644
index 00000000..677c432f
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-panel-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-panel.png b/docs/showcase/screenshots/templates/cv/cv-panel.png
deleted file mode 100644
index 363b6051..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-panel.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-sidebar-portrait-v2.png b/docs/showcase/screenshots/templates/cv/cv-sidebar-portrait-v2.png
new file mode 100644
index 00000000..c8db5ef1
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-sidebar-portrait-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-sidebar-portrait.png b/docs/showcase/screenshots/templates/cv/cv-sidebar-portrait.png
deleted file mode 100644
index dd55619f..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-sidebar-portrait.png and /dev/null differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-timeline-minimal-v2.png b/docs/showcase/screenshots/templates/cv/cv-timeline-minimal-v2.png
new file mode 100644
index 00000000..f0c2dd99
Binary files /dev/null and b/docs/showcase/screenshots/templates/cv/cv-timeline-minimal-v2.png differ
diff --git a/docs/showcase/screenshots/templates/cv/cv-timeline-minimal.png b/docs/showcase/screenshots/templates/cv/cv-timeline-minimal.png
deleted file mode 100644
index e22a4c1d..00000000
Binary files a/docs/showcase/screenshots/templates/cv/cv-timeline-minimal.png and /dev/null differ
diff --git a/docs/styles.css b/docs/styles.css
index c03e2fa4..e025c7f2 100644
--- a/docs/styles.css
+++ b/docs/styles.css
@@ -1,17 +1,52 @@
 :root {
+  /* Brand — single premium indigo accent (replaces the old cyan+amber pair) */
+  --accent: #6366f1;
+  --accent-2: #818cf8;
+  --accent-rgb: 99, 102, 241;
+  --accent-warm: var(--accent); /* legacy alias — kept so old rules unify onto the primary */
+
+  --font-body: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --font-display: "Space Grotesk", var(--font-body);
+
+  /* Dark theme (default) */
   --bg: #0b1020;
   --panel: #111827;
   --panel-soft: #172033;
+  --surface: rgba(17, 24, 39, 0.92);
+  --surface-2: rgba(15, 23, 42, 0.70);
   --text: #e5e7eb;
+  --text-strong: #f8fafc;
   --muted: #9ca3af;
-  --accent: #38bdf8;
-  --accent-warm: #f59e0b;
   --border: rgba(255, 255, 255, 0.12);
+  --code-bg: #0b1220;
+  --hero-grid: rgba(255, 255, 255, 0.035);
+  --accent-glow: rgba(var(--accent-rgb), 0.16);
+  --header-bg: rgba(11, 16, 32, 0.82);
+  --preview-bg: #0f172a;
   --shadow: 0 24px 80px rgba(0, 0, 0, 0.34);
   --radius: 8px;
   --max-width: 1180px;
 }
 
+/* Light theme — opt-in via the header toggle (data-theme="light" on <html>).
+   Code panels intentionally stay dark in both themes; code reads best dark. */
+html[data-theme="light"] {
+  --bg: #f6f7fb;
+  --panel: #ffffff;
+  --panel-soft: #eef1f8;
+  --surface: #ffffff;
+  --surface-2: #f1f5f9;
+  --text: #334155;
+  --text-strong: #0f172a;
+  --muted: #64748b;
+  --border: rgba(15, 23, 42, 0.12);
+  --hero-grid: rgba(15, 23, 42, 0.045);
+  --accent-glow: rgba(var(--accent-rgb), 0.12);
+  --header-bg: rgba(255, 255, 255, 0.85);
+  --preview-bg: #e9edf6;
+  --shadow: 0 20px 60px rgba(15, 23, 42, 0.12);
+}
+
 * {
   box-sizing: border-box;
 }
@@ -25,10 +60,11 @@ body {
   margin: 0;
   color: var(--text);
   background:
-    radial-gradient(circle at 18% 12%, rgba(56, 189, 248, 0.14), transparent 30rem),
-    radial-gradient(circle at 82% 18%, rgba(245, 158, 11, 0.10), transparent 26rem),
-    linear-gradient(180deg, #0b1020 0%, #101827 48%, #0b1020 100%);
-  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    radial-gradient(circle at 18% 12%, var(--accent-glow), transparent 30rem),
+    radial-gradient(circle at 82% 18%, rgba(var(--accent-rgb), 0.08), transparent 26rem),
+    var(--bg);
+  background-attachment: fixed;
+  font-family: var(--font-body);
   line-height: 1.5;
 }
 
@@ -39,8 +75,8 @@ body::before {
   pointer-events: none;
   content: "";
   background-image:
-    linear-gradient(rgba(255, 255, 255, 0.035) 1px, transparent 1px),
-    linear-gradient(90deg, rgba(255, 255, 255, 0.035) 1px, transparent 1px);
+    linear-gradient(var(--hero-grid) 1px, transparent 1px),
+    linear-gradient(90deg, var(--hero-grid) 1px, transparent 1px);
   background-size: 42px 42px;
   mask-image: linear-gradient(180deg, rgba(0, 0, 0, 0.72), transparent 72%);
 }
@@ -77,7 +113,7 @@ pre {
   gap: 24px;
   padding: 14px max(20px, calc((100vw - var(--max-width)) / 2));
   border-bottom: 1px solid var(--border);
-  background: rgba(11, 16, 32, 0.82);
+  background: var(--header-bg);
   backdrop-filter: blur(16px);
 }
 
@@ -154,7 +190,7 @@ pre {
 .hero-lead {
   max-width: 700px;
   margin: 22px 0 0;
-  color: #f8fafc;
+  color: var(--text-strong);
   font-size: 1.55rem;
   font-weight: 720;
   line-height: 1.18;
@@ -195,8 +231,8 @@ pre {
 
 .button-primary {
   color: #06111f;
-  background: linear-gradient(135deg, var(--accent), #7dd3fc);
-  box-shadow: 0 16px 42px rgba(56, 189, 248, 0.24);
+  background: linear-gradient(135deg, var(--accent), var(--accent-2));
+  box-shadow: 0 16px 42px rgba(var(--accent-rgb), 0.24);
 }
 
 .button-secondary {
@@ -207,14 +243,14 @@ pre {
 
 .button-secondary:hover,
 .button-secondary:focus-visible {
-  border-color: rgba(56, 189, 248, 0.46);
-  background: rgba(56, 189, 248, 0.11);
+  border-color: rgba(var(--accent-rgb), 0.46);
+  background: rgba(var(--accent-rgb), 0.11);
 }
 
 .button-ghost {
-  color: #fef3c7;
-  border-color: rgba(245, 158, 11, 0.42);
-  background: rgba(245, 158, 11, 0.09);
+  color: var(--accent);
+  border-color: rgba(var(--accent-rgb), 0.42);
+  background: rgba(var(--accent-rgb), 0.09);
 }
 
 .button-small {
@@ -239,9 +275,9 @@ pre {
   inset: 9% 10% 6% 4%;
   z-index: -1;
   content: "";
-  border: 1px solid rgba(56, 189, 248, 0.22);
+  border: 1px solid rgba(var(--accent-rgb), 0.22);
   border-radius: 28px;
-  background: linear-gradient(135deg, rgba(17, 24, 39, 0.82), rgba(23, 32, 51, 0.44));
+  background: var(--surface);
   box-shadow: var(--shadow), inset 0 1px 0 rgba(255, 255, 255, 0.08);
 }
 
@@ -334,7 +370,7 @@ h2 {
 .feature-card {
   border: 1px solid var(--border);
   border-radius: var(--radius);
-  background: linear-gradient(180deg, rgba(17, 24, 39, 0.94), rgba(23, 32, 51, 0.82));
+  background: var(--surface);
   box-shadow: 0 18px 44px rgba(0, 0, 0, 0.20);
 }
 
@@ -351,9 +387,8 @@ h2 {
   padding: 18px;
   place-items: center;
   background:
-    linear-gradient(135deg, rgba(56, 189, 248, 0.12), transparent 42%),
-    linear-gradient(315deg, rgba(245, 158, 11, 0.14), transparent 48%),
-    #0f172a;
+    radial-gradient(circle at 30% 20%, var(--accent-glow), transparent 55%),
+    var(--preview-bg);
 }
 
 .example-preview img {
@@ -382,7 +417,7 @@ h2 {
 .example-body h3,
 .feature-card h3 {
   margin: 0;
-  color: #f8fafc;
+  color: var(--text-strong);
   font-size: 1.18rem;
   letter-spacing: 0;
 }
@@ -409,10 +444,10 @@ h2 {
   align-items: center;
   min-height: 26px;
   padding: 0 9px;
-  border: 1px solid rgba(56, 189, 248, 0.28);
+  border: 1px solid rgba(var(--accent-rgb), 0.28);
   border-radius: 999px;
-  color: #bae6fd;
-  background: rgba(56, 189, 248, 0.08);
+  color: var(--accent);
+  background: rgba(var(--accent-rgb), 0.08);
   font-size: 0.75rem;
   font-weight: 760;
 }
@@ -432,7 +467,7 @@ h2 {
   border: 1px solid var(--border);
   border-radius: var(--radius);
   color: var(--muted);
-  background: rgba(17, 24, 39, 0.86);
+  background: var(--surface);
 }
 
 .architecture {
@@ -453,10 +488,10 @@ h2 {
   position: relative;
   min-height: 104px;
   padding: 20px 16px;
-  border: 1px solid rgba(56, 189, 248, 0.22);
+  border: 1px solid rgba(var(--accent-rgb), 0.22);
   border-radius: var(--radius);
-  color: #f8fafc;
-  background: linear-gradient(180deg, rgba(17, 24, 39, 0.96), rgba(15, 23, 42, 0.88));
+  color: var(--text-strong);
+  background: var(--surface);
   font-weight: 800;
 }
 
@@ -507,7 +542,7 @@ h2 {
   overflow: hidden;
   border: 1px solid var(--border);
   border-radius: var(--radius);
-  background: #07111f;
+  background: var(--code-bg);
   box-shadow: var(--shadow);
 }
 
@@ -604,7 +639,7 @@ h2 {
 }
 
 .site-footer a {
-  color: #bfdbfe;
+  color: var(--accent);
 }
 
 .site-footer a:hover,
@@ -613,7 +648,7 @@ h2 {
 }
 
 :focus-visible {
-  outline: 3px solid rgba(56, 189, 248, 0.72);
+  outline: 3px solid rgba(var(--accent-rgb), 0.72);
   outline-offset: 3px;
 }
 
@@ -794,8 +829,8 @@ h2 {
 .hero-copy code {
   padding: 1px 6px;
   border-radius: 4px;
-  background: rgba(56, 189, 248, 0.14);
-  color: #93c5fd;
+  background: rgba(var(--accent-rgb), 0.14);
+  color: var(--accent-2);
   font-size: 0.94em;
 }
 
@@ -809,7 +844,7 @@ h2 {
   position: relative;
   padding: 28px 32px;
   border-radius: 14px;
-  background: linear-gradient(135deg, rgba(56, 189, 248, 0.10), rgba(99, 102, 241, 0.10));
+  background: linear-gradient(135deg, rgba(var(--accent-rgb), 0.10), rgba(99, 102, 241, 0.10));
   border: 1px solid rgba(129, 140, 248, 0.35);
 }
 
@@ -820,7 +855,7 @@ h2 {
   font-weight: 700;
   letter-spacing: 1.5px;
   color: #0f172a;
-  background: linear-gradient(135deg, #38bdf8, #818cf8);
+  background: linear-gradient(135deg, var(--accent), #818cf8);
   border-radius: 4px;
   margin-bottom: 12px;
 }
@@ -828,23 +863,23 @@ h2 {
 .layered-card h2 {
   margin: 0 0 8px 0;
   font-size: 22px;
-  color: #f8fafc;
+  color: var(--text-strong);
 }
 
 .layered-card p {
   margin: 0 0 18px 0;
   max-width: 720px;
-  color: #cbd5e1;
+  color: var(--muted);
   line-height: 1.55;
 }
 
 .layered-card strong {
-  color: #e2e8f0;
+  color: var(--text-strong);
 }
 
 .layered-card code {
   background: rgba(148, 163, 184, 0.18);
-  color: #f1f5f9;
+  color: var(--text-strong);
   padding: 1px 6px;
   border-radius: 3px;
   font-size: 12px;
@@ -860,7 +895,7 @@ h2 {
 .value-prop {
   padding-top: 56px;
   padding-bottom: 56px;
-  background: linear-gradient(180deg, transparent, rgba(56, 189, 248, 0.04));
+  background: linear-gradient(180deg, transparent, rgba(var(--accent-rgb), 0.04));
 }
 
 .value-grid {
@@ -873,12 +908,12 @@ h2 {
   padding: 22px;
   border: 1px solid var(--border);
   border-radius: var(--radius);
-  background: rgba(15, 23, 42, 0.7);
+  background: var(--surface-2);
 }
 
 .value-grid h3 {
   margin: 0 0 8px;
-  color: #f8fafc;
+  color: var(--text-strong);
   font-size: 1.02rem;
 }
 
@@ -899,12 +934,12 @@ h2 {
   padding: 22px;
   border: 1px solid var(--border);
   border-radius: var(--radius);
-  background: rgba(15, 23, 42, 0.85);
+  background: var(--surface);
 }
 
 .install-block h4 {
   margin: 0 0 12px;
-  color: #f8fafc;
+  color: var(--text-strong);
   font-size: 0.94rem;
   letter-spacing: 0.05em;
   text-transform: uppercase;
@@ -915,7 +950,7 @@ h2 {
   margin: 0;
   padding: 16px 18px;
   border-radius: 7px;
-  background: #0b1220;
+  background: var(--code-bg);
   color: #e0f2fe;
   font-size: 0.83rem;
   font-family: ui-monospace, "SFMono-Regular", "JetBrains Mono", monospace;
@@ -943,7 +978,7 @@ pre[class*="language-"].language-java,
 pre[class*="language-"].language-groovy,
 pre[class*="language-"].language-xml,
 pre[class*="language-"].language-markup {
-  background: #0b1220 !important;
+  background: var(--code-bg) !important;
   color: #e0f2fe !important;
 }
 
@@ -1006,16 +1041,16 @@ code[class*="language-"] .token.class-name {
   padding: 0 16px;
   border: 1px solid var(--border);
   border-radius: 999px;
-  background: rgba(15, 23, 42, 0.85);
-  color: #e2e8f0;
+  background: var(--surface-2);
+  color: var(--text);
   font-size: 0.94rem;
   transition: border-color 0.18s ease;
 }
 
 #showcase-search:focus {
   outline: none;
-  border-color: rgba(56, 189, 248, 0.55);
-  box-shadow: 0 0 0 3px rgba(56, 189, 248, 0.15);
+  border-color: rgba(var(--accent-rgb), 0.55);
+  box-shadow: 0 0 0 3px rgba(var(--accent-rgb), 0.15);
 }
 
 .showcase-filters {
@@ -1029,7 +1064,7 @@ code[class*="language-"] .token.class-name {
   padding: 0 16px;
   border: 1px solid var(--border);
   border-radius: 999px;
-  background: rgba(15, 23, 42, 0.6);
+  background: var(--surface-2);
   color: var(--muted);
   font-size: 0.84rem;
   font-weight: 660;
@@ -1039,13 +1074,13 @@ code[class*="language-"] .token.class-name {
 
 .filter-pill:hover {
   color: #e2e8f0;
-  border-color: rgba(56, 189, 248, 0.4);
+  border-color: rgba(var(--accent-rgb), 0.4);
 }
 
 .filter-pill.is-active {
-  color: #f8fafc;
-  background: rgba(56, 189, 248, 0.18);
-  border-color: rgba(56, 189, 248, 0.55);
+  color: var(--text-strong);
+  background: rgba(var(--accent-rgb), 0.18);
+  border-color: rgba(var(--accent-rgb), 0.55);
 }
 
 /* Showcase content layout */
@@ -1069,7 +1104,7 @@ code[class*="language-"] .token.class-name {
 .showcase-error code {
   padding: 1px 6px;
   border-radius: 4px;
-  background: rgba(56, 189, 248, 0.14);
+  background: rgba(var(--accent-rgb), 0.14);
   color: #bae6fd;
 }
 
@@ -1091,7 +1126,7 @@ code[class*="language-"] .token.class-name {
 
 .category-heading h3 {
   margin: 0;
-  color: #f8fafc;
+  color: var(--text-strong);
   font-size: 1.55rem;
   letter-spacing: -0.01em;
 }
@@ -1156,7 +1191,7 @@ code[class*="language-"] .token.class-name {
   font-size: 1.4rem;
   font-weight: 720;
   letter-spacing: 0.05em;
-  background: #0b1220;
+  background: var(--code-bg);
 }
 
 .example-card[data-id] .example-body {
@@ -1166,7 +1201,7 @@ code[class*="language-"] .token.class-name {
 
 .example-title {
   margin: 0;
-  color: #f8fafc;
+  color: var(--text-strong);
   font-size: 1.04rem;
   font-weight: 720;
   letter-spacing: 0;
@@ -1204,10 +1239,10 @@ code[class*="language-"] .token.class-name {
   align-items: center;
   height: 32px;
   padding: 0 14px;
-  border: 1px solid rgba(56, 189, 248, 0.55);
+  border: 1px solid var(--accent);
   border-radius: 6px;
-  background: rgba(56, 189, 248, 0.18);
-  color: #f0f9ff;
+  background: var(--accent);
+  color: #fff;
   font-size: 0.82rem;
   font-weight: 660;
   text-decoration: none;
@@ -1215,8 +1250,8 @@ code[class*="language-"] .token.class-name {
 }
 
 .example-action:hover {
-  background: rgba(56, 189, 248, 0.28);
-  border-color: rgba(56, 189, 248, 0.75);
+  filter: brightness(1.08);
+  box-shadow: 0 6px 16px rgba(var(--accent-rgb), 0.32);
 }
 
 .example-action-ghost {
@@ -1227,8 +1262,8 @@ code[class*="language-"] .token.class-name {
 
 .example-action-ghost:hover {
   color: #e2e8f0;
-  border-color: rgba(56, 189, 248, 0.45);
-  background: rgba(56, 189, 248, 0.06);
+  border-color: rgba(var(--accent-rgb), 0.45);
+  background: rgba(var(--accent-rgb), 0.06);
 }
 
 /* Responsive */
@@ -1271,8 +1306,8 @@ code[class*="language-"] .token.class-name {
 .example-card[data-id] .example-preview {
   position: relative;
   background:
-    radial-gradient(circle at 30% 20%, rgba(56, 189, 248, 0.08), transparent 55%),
-    #0f172a;
+    radial-gradient(circle at 30% 20%, var(--accent-glow), transparent 55%),
+    var(--preview-bg);
   cursor: zoom-in;
   border: 0;
   width: 100%;
@@ -1281,14 +1316,13 @@ code[class*="language-"] .token.class-name {
 
 .example-card[data-id] .example-preview img {
   width: 100%;
-  height: auto;
-  /* Reserve A4 portrait box (595/842 ≈ 1/1.414) before lazy-load
-     resolves so showcase cards do not collapse to a thin strip and
-     trigger Cumulative Layout Shift. object-fit keeps non-A4
-     previews (canvas / wide flagships) from being squished. */
-  aspect-ratio: 595 / 842;
-  max-height: 360px;
-  object-fit: contain;
+  /* Crop to the top band of each document (masthead + first section)
+     at a uniform height so the gallery scans fast and the preview text
+     is legible — the full page is one click away in the lightbox. Fixed
+     height also reserves the box before lazy-load, avoiding layout shift. */
+  height: 248px;
+  object-fit: cover;
+  object-position: top center;
   background: white;
   border: 2px solid rgba(255, 255, 255, 0.06);
   border-radius: 4px;
@@ -1303,7 +1337,7 @@ code[class*="language-"] .token.class-name {
   transform: translateY(-2px);
   box-shadow:
     0 1px 0 rgba(255, 255, 255, 0.06) inset,
-    0 24px 48px rgba(56, 189, 248, 0.18),
+    0 24px 48px rgba(var(--accent-rgb), 0.18),
     0 6px 14px rgba(0, 0, 0, 0.4);
 }
 
@@ -1314,7 +1348,7 @@ code[class*="language-"] .token.class-name {
   padding: 4px 10px;
   border-radius: 999px;
   background: rgba(15, 23, 42, 0.85);
-  border: 1px solid rgba(56, 189, 248, 0.35);
+  border: 1px solid rgba(var(--accent-rgb), 0.35);
   color: #bae6fd;
   font-size: 0.72rem;
   font-weight: 660;
@@ -1332,7 +1366,7 @@ code[class*="language-"] .token.class-name {
 }
 
 .example-card[data-id] .example-preview:focus-visible {
-  outline: 2px solid rgba(56, 189, 248, 0.55);
+  outline: 2px solid rgba(var(--accent-rgb), 0.55);
   outline-offset: 2px;
 }
 
@@ -1382,9 +1416,9 @@ code[class*="language-"] .token.class-name {
   flex-direction: column;
   width: min(92vw, 1080px);
   max-height: 92vh;
-  border: 1px solid rgba(56, 189, 248, 0.35);
+  border: 1px solid rgba(var(--accent-rgb), 0.35);
   border-radius: 12px;
-  background: #0b1220;
+  background: var(--code-bg);
   box-shadow: 0 30px 80px rgba(0, 0, 0, 0.65);
   overflow: hidden;
 }
@@ -1401,7 +1435,7 @@ code[class*="language-"] .token.class-name {
 
 .lightbox-title {
   margin: 0;
-  color: #f8fafc;
+  color: #f8fafc; /* lightbox overlay is always dark in both themes */
   font-size: 1.05rem;
   font-weight: 720;
   letter-spacing: 0;
@@ -1446,8 +1480,8 @@ code[class*="language-"] .token.class-name {
   background:
     repeating-linear-gradient(
       45deg,
-      rgba(56, 189, 248, 0.025) 0,
-      rgba(56, 189, 248, 0.025) 12px,
+      rgba(var(--accent-rgb), 0.025) 0,
+      rgba(var(--accent-rgb), 0.025) 12px,
       transparent 12px,
       transparent 24px
     ),
@@ -1520,7 +1554,7 @@ body.lightbox-open {
   padding: 24px 28px;
   border: 1px solid var(--border);
   border-radius: var(--radius);
-  background: rgba(15, 23, 42, 0.7);
+  background: var(--surface-2);
   color: var(--muted);
 }
 
@@ -1547,7 +1581,7 @@ body.lightbox-open {
 }
 
 .showcase-noscript a {
-  color: #7dd3fc;
+  color: var(--accent-2);
 }
 
 .showcase-noscript a:hover {
@@ -1577,7 +1611,7 @@ body.lightbox-open {
   margin: 0;
   font-size: 1.45rem;
   letter-spacing: 0.02em;
-  color: #f8fafc;
+  color: var(--text-strong);
   text-transform: uppercase;
 }
 
@@ -1606,7 +1640,7 @@ body.lightbox-open {
   height: 8px;
 }
 .highlights-strip::-webkit-scrollbar-thumb {
-  background: rgba(56, 189, 248, 0.35);
+  background: rgba(var(--accent-rgb), 0.35);
   border-radius: 999px;
 }
 
@@ -1617,7 +1651,7 @@ body.lightbox-open {
   flex-direction: column;
   margin: 0;
   padding: 0;
-  background: rgba(15, 23, 42, 0.85);
+  background: var(--surface);
   border: 1px solid var(--border);
   border-radius: var(--radius);
   overflow: hidden;
@@ -1627,10 +1661,10 @@ body.lightbox-open {
 .highlight-tile:hover,
 .highlight-tile:focus-within {
   transform: translateY(-3px);
-  border-color: rgba(56, 189, 248, 0.5);
+  border-color: rgba(var(--accent-rgb), 0.5);
   box-shadow:
     0 22px 46px rgba(0, 0, 0, 0.45),
-    0 6px 16px rgba(56, 189, 248, 0.12);
+    0 6px 16px rgba(var(--accent-rgb), 0.12);
 }
 
 .highlight-preview {
@@ -1640,8 +1674,8 @@ body.lightbox-open {
   padding: 14px 14px 0;
   border: 0;
   background:
-    radial-gradient(circle at 30% 18%, rgba(56, 189, 248, 0.10), transparent 60%),
-    #0f172a;
+    radial-gradient(circle at 30% 18%, var(--accent-glow), transparent 60%),
+    var(--preview-bg);
   cursor: zoom-in;
   appearance: none;
 }
@@ -1668,7 +1702,7 @@ body.lightbox-open {
   right: 22px;
   padding: 3px 9px;
   border-radius: 999px;
-  background: rgba(56, 189, 248, 0.86);
+  background: rgba(var(--accent-rgb), 0.86);
   color: #06111f;
   font-size: 0.7rem;
   font-weight: 760;
@@ -1689,7 +1723,7 @@ body.lightbox-open {
   margin: 0;
   font-size: 1.02rem;
   font-weight: 760;
-  color: #f8fafc;
+  color: var(--text-strong);
 }
 
 .highlight-desc {
@@ -1728,10 +1762,10 @@ body.lightbox-open {
   display: none;
   align-items: center;
   justify-content: center;
-  border: 1px solid rgba(56, 189, 248, 0.4);
+  border: 1px solid rgba(var(--accent-rgb), 0.4);
   border-radius: 999px;
-  background: rgba(15, 23, 42, 0.92);
-  color: #e2e8f0;
+  background: var(--surface);
+  color: var(--text);
   font-size: 1.4rem;
   font-weight: 700;
   cursor: pointer;
@@ -1744,8 +1778,8 @@ body.lightbox-open {
 }
 
 .strip-arrow:hover {
-  border-color: rgba(56, 189, 248, 0.7);
-  background: rgba(56, 189, 248, 0.18);
+  border-color: rgba(var(--accent-rgb), 0.7);
+  background: rgba(var(--accent-rgb), 0.18);
 }
 
 .strip-arrow:disabled {
@@ -1782,10 +1816,10 @@ body.lightbox-open {
   gap: 6px;
   margin-top: 12px;
   padding: 8px 16px;
-  border: 1px dashed rgba(56, 189, 248, 0.5);
+  border: 1px dashed rgba(var(--accent-rgb), 0.5);
   border-radius: 999px;
   background: transparent;
-  color: #bae6fd;
+  color: var(--accent);
   font-size: 0.86rem;
   font-weight: 660;
   cursor: pointer;
@@ -1794,11 +1828,72 @@ body.lightbox-open {
 
 .group-toggle:hover,
 .group-toggle:focus-visible {
-  border-color: rgba(56, 189, 248, 0.85);
-  background: rgba(56, 189, 248, 0.1);
+  border-color: rgba(var(--accent-rgb), 0.85);
+  background: rgba(var(--accent-rgb), 0.1);
   color: #e0f2fe;
 }
 
 .group-toggle-count {
   font-variant-numeric: tabular-nums;
 }
+
+/* ===========================================================
+   v1.6 brand refresh — display headings + light/dark toggle.
+   =========================================================== */
+
+/* Space Grotesk display face on the major headings — distinctive and
+   on-brand for a typography/layout engine. Body copy stays Inter. */
+.hero h1,
+h2,
+.layered-card h2,
+.category-heading h3,
+.group-heading h4,
+.example-title,
+.highlight-title,
+.feature-card h3,
+.value-grid h3 {
+  font-family: var(--font-display);
+  letter-spacing: -0.015em;
+  color: var(--text-strong);
+}
+
+/* Header light/dark toggle */
+.theme-toggle {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 38px;
+  height: 38px;
+  padding: 0;
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  background: var(--surface-2);
+  color: var(--text);
+  cursor: pointer;
+  transition: border-color 0.15s ease, background 0.15s ease, color 0.15s ease;
+}
+
+.theme-toggle:hover,
+.theme-toggle:focus-visible {
+  color: var(--text-strong);
+  border-color: rgba(var(--accent-rgb), 0.5);
+  background: rgba(var(--accent-rgb), 0.1);
+}
+
+.theme-toggle svg {
+  width: 18px;
+  height: 18px;
+}
+
+/* Moon in dark mode, sun in light mode. */
+.theme-toggle .icon-sun {
+  display: none;
+}
+
+html[data-theme="light"] .theme-toggle .icon-moon {
+  display: none;
+}
+
+html[data-theme="light"] .theme-toggle .icon-sun {
+  display: block;
+}
diff --git a/examples/src/main/java/com/demcha/examples/GenerateAllExamples.java b/examples/src/main/java/com/demcha/examples/GenerateAllExamples.java
index 5a0b71c0..b7c6128f 100644
--- a/examples/src/main/java/com/demcha/examples/GenerateAllExamples.java
+++ b/examples/src/main/java/com/demcha/examples/GenerateAllExamples.java
@@ -16,10 +16,37 @@
 import com.demcha.examples.flagships.BusinessReportExample;
 import com.demcha.examples.flagships.MasterShowcaseExample;
 import com.demcha.examples.flagships.ModuleFirstFileExample;
-import com.demcha.examples.templates.coverletter.CoverLetterFileExample;
-import com.demcha.examples.templates.coverletter.CoverLetterTemplateGalleryFileExample;
-import com.demcha.examples.templates.cv.CvFileExample;
-import com.demcha.examples.templates.cv.CvTemplateGalleryFileExample;
+import com.demcha.examples.templates.coverletter.v2.CvBlueBannerLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvBoxedSectionsLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvCenteredHeadlineLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvClassicSerifLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvCompactMonoLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvEditorialBlueLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvEngineeringResumeLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvExecutiveLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvMintEditorialLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvModernProfessionalLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvMonogramSidebarLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvNordicCleanLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvPanelLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvSidebarPortraitLetterV2Example;
+import com.demcha.examples.templates.coverletter.v2.CvTimelineMinimalLetterV2Example;
+import com.demcha.examples.templates.cv.v2.CvBlueBannerExample;
+import com.demcha.examples.templates.cv.v2.CvBoxedV2Example;
+import com.demcha.examples.templates.cv.v2.CvCenteredHeadlineExample;
+import com.demcha.examples.templates.cv.v2.CvClassicSerifExample;
+import com.demcha.examples.templates.cv.v2.CvCompactMonoExample;
+import com.demcha.examples.templates.cv.v2.CvEditorialBlueExample;
+import com.demcha.examples.templates.cv.v2.CvEngineeringResumeExample;
+import com.demcha.examples.templates.cv.v2.CvExecutiveExample;
+import com.demcha.examples.templates.cv.v2.CvMinimalUnderlinedExample;
+import com.demcha.examples.templates.cv.v2.CvMintEditorialExample;
+import com.demcha.examples.templates.cv.v2.CvModernV2Example;
+import com.demcha.examples.templates.cv.v2.CvMonogramSidebarExample;
+import com.demcha.examples.templates.cv.v2.CvNordicCleanExample;
+import com.demcha.examples.templates.cv.v2.CvPanelExample;
+import com.demcha.examples.templates.cv.v2.CvSidebarPortraitExample;
+import com.demcha.examples.templates.cv.v2.CvTimelineMinimalExample;
 import com.demcha.examples.templates.invoice.InvoiceCinematicFileExample;
 import com.demcha.examples.templates.invoice.InvoiceFileExample;
 import com.demcha.examples.templates.proposal.CinematicProposalFileExample;
@@ -41,13 +68,40 @@ private GenerateAllExamples() {
 
     public static void main(String[] args) throws Exception {
         // === Templates ===
-        // CV / Resume
-        System.out.println("Generated: " + CvFileExample.generate());
-        System.out.println("Generated: " + CvTemplateGalleryFileExample.generate());
+        // CV / Resume (v2 layered — 16 presets, one example per preset)
+        System.out.println("Generated: " + CvBlueBannerExample.generate());
+        System.out.println("Generated: " + CvBoxedV2Example.generate());
+        System.out.println("Generated: " + CvCenteredHeadlineExample.generate());
+        System.out.println("Generated: " + CvClassicSerifExample.generate());
+        System.out.println("Generated: " + CvCompactMonoExample.generate());
+        System.out.println("Generated: " + CvEditorialBlueExample.generate());
+        System.out.println("Generated: " + CvEngineeringResumeExample.generate());
+        System.out.println("Generated: " + CvExecutiveExample.generate());
+        System.out.println("Generated: " + CvMinimalUnderlinedExample.generate());
+        System.out.println("Generated: " + CvMintEditorialExample.generate());
+        System.out.println("Generated: " + CvModernV2Example.generate());
+        System.out.println("Generated: " + CvMonogramSidebarExample.generate());
+        System.out.println("Generated: " + CvNordicCleanExample.generate());
+        System.out.println("Generated: " + CvPanelExample.generate());
+        System.out.println("Generated: " + CvSidebarPortraitExample.generate());
+        System.out.println("Generated: " + CvTimelineMinimalExample.generate());
 
-        // Cover letters
-        System.out.println("Generated: " + CoverLetterFileExample.generate());
-        System.out.println("Generated: " + CoverLetterTemplateGalleryFileExample.generate());
+        // Cover letters (v2 layered — 15 paired letters, one per CV preset)
+        System.out.println("Generated: " + CvBlueBannerLetterV2Example.generate());
+        System.out.println("Generated: " + CvBoxedSectionsLetterV2Example.generate());
+        System.out.println("Generated: " + CvCenteredHeadlineLetterV2Example.generate());
+        System.out.println("Generated: " + CvClassicSerifLetterV2Example.generate());
+        System.out.println("Generated: " + CvCompactMonoLetterV2Example.generate());
+        System.out.println("Generated: " + CvEditorialBlueLetterV2Example.generate());
+        System.out.println("Generated: " + CvEngineeringResumeLetterV2Example.generate());
+        System.out.println("Generated: " + CvExecutiveLetterV2Example.generate());
+        System.out.println("Generated: " + CvMintEditorialLetterV2Example.generate());
+        System.out.println("Generated: " + CvModernProfessionalLetterV2Example.generate());
+        System.out.println("Generated: " + CvMonogramSidebarLetterV2Example.generate());
+        System.out.println("Generated: " + CvNordicCleanLetterV2Example.generate());
+        System.out.println("Generated: " + CvPanelLetterV2Example.generate());
+        System.out.println("Generated: " + CvSidebarPortraitLetterV2Example.generate());
+        System.out.println("Generated: " + CvTimelineMinimalLetterV2Example.generate());
 
         // Invoices
         System.out.println("Generated: " + InvoiceFileExample.generate());
diff --git a/examples/src/main/java/com/demcha/examples/support/ExampleDataFactory.java b/examples/src/main/java/com/demcha/examples/support/ExampleDataFactory.java
index f1893ae6..7037eb39 100644
--- a/examples/src/main/java/com/demcha/examples/support/ExampleDataFactory.java
+++ b/examples/src/main/java/com/demcha/examples/support/ExampleDataFactory.java
@@ -15,6 +15,7 @@
 import com.demcha.compose.document.templates.cv.spec.CvSpec;
 import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
 import com.demcha.compose.document.templates.cv.v2.data.CvIdentity;
+import com.demcha.compose.document.templates.cv.v2.data.CvSkill;
 import com.demcha.compose.document.templates.cv.v2.data.EntriesSection;
 import com.demcha.compose.document.templates.cv.v2.data.ParagraphSection;
 import com.demcha.compose.document.templates.cv.v2.data.RowStyle;
@@ -529,25 +530,50 @@ public static CvDocument sampleCvDocumentV2() {
                         + "DSLs, and turning brittle production-ops scripts "
                         + "into typed, snapshot-tested libraries that scale.");
 
+        // Skill names are unchanged from the name-only form; only optional
+        // proficiency levels are added so data-driven presets (e.g. Mint
+        // Editorial's SkillBar) can render meters. Name-only presets read
+        // SkillGroup.skills() and are unaffected by the added levels.
         SkillsSection skills = SkillsSection
                 .builder("Technical Skills")
-                .group("Languages", "Java 21", "Kotlin", "Groovy",
-                        "Python", "SQL")
-                .group("Document & Print", "PDFBox",
-                        "Apache POI (DOCX/XLSX)", "iText", "PostScript",
-                        "ICC colour profiles", "font metrics")
-                .group("Layout engines", "Custom DSL design",
-                        "semantic layout trees", "pagination",
-                        "snapshot testing", "visual regression")
-                .group("Build & infrastructure", "Maven", "Gradle",
-                        "GitHub Actions", "JitPack", "Docker",
-                        "JMH benchmarking")
-                .group("Testing", "JUnit 5", "AssertJ",
-                        "PDFBox-based PNG diff", "layout-graph snapshots",
-                        "mutation testing (Pitest)")
-                .group("Distribution", "Maven Central", "Sonatype OSSRH",
-                        "GPG signing", "JitPack",
-                        "semantic versioning discipline")
+                .leveledGroup("Languages", List.of(
+                        CvSkill.of("Java 21", 0.95),
+                        CvSkill.of("Kotlin", 0.85),
+                        CvSkill.of("Groovy", 0.7),
+                        CvSkill.of("Python", 0.75),
+                        CvSkill.of("SQL", 0.8)))
+                .leveledGroup("Document & Print", List.of(
+                        CvSkill.of("PDFBox", 0.9),
+                        CvSkill.of("Apache POI (DOCX/XLSX)", 0.7),
+                        CvSkill.of("iText", 0.65),
+                        CvSkill.of("PostScript", 0.6),
+                        CvSkill.of("ICC colour profiles", 0.55),
+                        CvSkill.of("font metrics", 0.7)))
+                .leveledGroup("Layout engines", List.of(
+                        CvSkill.of("Custom DSL design", 0.9),
+                        CvSkill.of("semantic layout trees", 0.85),
+                        CvSkill.of("pagination", 0.85),
+                        CvSkill.of("snapshot testing", 0.8),
+                        CvSkill.of("visual regression", 0.8)))
+                .leveledGroup("Build & infrastructure", List.of(
+                        CvSkill.of("Maven", 0.9),
+                        CvSkill.of("Gradle", 0.75),
+                        CvSkill.of("GitHub Actions", 0.85),
+                        CvSkill.of("JitPack", 0.8),
+                        CvSkill.of("Docker", 0.7),
+                        CvSkill.of("JMH benchmarking", 0.65)))
+                .leveledGroup("Testing", List.of(
+                        CvSkill.of("JUnit 5", 0.9),
+                        CvSkill.of("AssertJ", 0.85),
+                        CvSkill.of("PDFBox-based PNG diff", 0.8),
+                        CvSkill.of("layout-graph snapshots", 0.8),
+                        CvSkill.of("mutation testing (Pitest)", 0.6)))
+                .leveledGroup("Distribution", List.of(
+                        CvSkill.of("Maven Central", 0.8),
+                        CvSkill.of("Sonatype OSSRH", 0.75),
+                        CvSkill.of("GPG signing", 0.7),
+                        CvSkill.of("JitPack", 0.8),
+                        CvSkill.of("semantic versioning discipline", 0.85)))
                 .build();
 
         EntriesSection education = EntriesSection
@@ -635,4 +661,124 @@ public static CvDocument sampleCvDocumentV2() {
                 .sections(summary, skills, education, projects, experience, additional)
                 .build();
     }
+
+    /**
+     * Rich "Rose Harris" CV document used <strong>only</strong> by
+     * {@code CvMintEditorialExample} to reproduce the Mint Editorial visual
+     * reference 1:1. Kept separate from {@link #sampleCvDocumentV2()} so the
+     * shared canonical sample — and therefore every other preset's visual
+     * baseline — stays untouched.
+     *
+     * <p>All sections live in {@code Slot.MAIN}; the Mint preset routes each
+     * to its sidebar/main region by title keyword. Section titles are chosen
+     * to match the preset's lookup constants: "Interests" → Interests,
+     * "Education" → Education, "Technical Skills" → both Expertise (group
+     * categories) and Skills (leveled entries), "Profile" → Profile,
+     * "Experience" → Experience, "Awards" → Awards, "References" →
+     * References.</p>
+     *
+     * <p>Expertise and Skills are both derived from the single
+     * {@code Technical Skills} section: the preset reads the group
+     * <em>categories</em> as the Expertise label list and the flattened
+     * leveled <em>entries</em> as the proficiency bars. Each Expertise
+     * category therefore carries one leveled skill so both lists render as in
+     * the reference.</p>
+     *
+     * @return rich Rose Harris CV document for the Mint Editorial showcase
+     */
+    public static CvDocument mintEditorialShowcaseCv() {
+        CvIdentity identity = CvIdentity.builder()
+                .name("Rose", "Harris")
+                .jobTitle("Graphic Designer")
+                .contact("+61 409 298 398", "hello@email.com", "Sydney, AUS")
+                .link("www.website.com", "https://www.website.com")
+                .link("Twitter", "https://twitter.com/roseharris")
+                .link("Facebook", "https://facebook.com/roseharris")
+                .link("Pinterest", "https://pinterest.com/roseharris")
+                .link("LinkedIn", "https://linkedin.com/in/roseharris")
+                .build();
+
+        ParagraphSection profile = new ParagraphSection("Profile",
+                "Lorem ipsum dolor sit amet, consectetur adipiscing elit. "
+                        + "Donec vulputate, lectus a tincidunt molestie, justo "
+                        + "lectus posuere magnum, sed pretium nisi metus a "
+                        + "risus. Vivamus tincidunt ligula in lacus euismod, "
+                        + "ut tincidunt velit vestibulum. Suspendisse potenti. "
+                        + "Praesent placerat lectus vitae ipsum pellentesque "
+                        + "molestie.");
+
+        RowsSection interests = RowsSection
+                .builder("Interests", RowStyle.PLAIN)
+                .row("Politics", "")
+                .row("Travelling", "")
+                .row("Arts & Entertainment", "")
+                .row("Illustration", "")
+                .build();
+
+        EntriesSection education = EntriesSection
+                .builder("Education")
+                .entry("Degree/Bachelor", "University of Sydney", "2010 - 2011", "")
+                .entry("Degree/Bachelor", "University of Sydney", "2010 - 2011", "")
+                .entry("Degree/Bachelor", "University of Sydney", "2010 - 2011", "")
+                .build();
+
+        // Single skills section feeds BOTH Expertise (group categories) and
+        // Skills (flattened leveled entries). Each Expertise category carries
+        // one leveled skill so the two reference lists render independently.
+        SkillsSection skills = SkillsSection
+                .builder("Technical Skills")
+                .leveledGroup("Illustration",
+                        List.of(CvSkill.of("Social Media", 0.45)))
+                .leveledGroup("Print Design",
+                        List.of(CvSkill.of("Adobe Suite", 0.58)))
+                .leveledGroup("Branding",
+                        List.of(CvSkill.of("Microsoft Word", 0.5)))
+                .leveledGroup("Animation",
+                        List.of(CvSkill.of("HTML/CSS", 0.42)))
+                .leveledGroup("Web Design",
+                        List.of(CvSkill.of("Wordpress", 0.6)))
+                .build();
+
+        String experienceBody =
+                "Lorem ipsum dolor sit amet, consectetur adipiscing elit. "
+                        + "Donec vulputate, lectus a tincidunt molestie, justo "
+                        + "lectus posuere magnum, sed pretium nisi metus a risus.\n"
+                        + "- Praesent placerat lectus vitae ipsum pellentesque\n"
+                        + "- Vivamus tincidunt ligula in lacus euismod\n"
+                        + "- Suspendisse potenti nullam ac tortor vitae";
+        // Three entries so the Mint preset's 2-on-page-1 / rest-on-page-2
+        // split renders two jobs under EXPERIENCE on page 1 and one
+        // continued job atop the page-2 main column, matching the reference.
+        EntriesSection experience = EntriesSection
+                .builder("Experience")
+                .entry("Job Title", "Company | Location", "2010 - Present",
+                        experienceBody)
+                .entry("Job Title", "Company | Location", "2010 - Present",
+                        experienceBody)
+                .entry("Job Title", "Company | Location", "2010 - Present",
+                        experienceBody)
+                .build();
+
+        RowsSection awards = RowsSection
+                .builder("Awards", RowStyle.PLAIN)
+                .row("Award Name Here", "Company | 2012")
+                .row("Award Name Here", "Company | 2012")
+                .row("Award Name Here", "Company | 2012")
+                .row("Award Name Here", "Company | 2012")
+                .build();
+
+        RowsSection references = RowsSection
+                .builder("References", RowStyle.PLAIN)
+                .row("John Smith", "Company\nP: +61 402 938 209\nhello@email.com")
+                .row("John Smith", "Company\nP: +61 402 938 209\nhello@email.com")
+                .row("John Smith", "Company\nP: +61 402 938 209\nhello@email.com")
+                .row("John Smith", "Company\nP: +61 402 938 209\nhello@email.com")
+                .build();
+
+        return CvDocument.builder()
+                .identity(identity)
+                .sections(profile, interests, education, skills, experience,
+                        awards, references)
+                .build();
+    }
 }
diff --git a/examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java b/examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java
index f67a619e..3aec5fe1 100644
--- a/examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java
+++ b/examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java
@@ -42,38 +42,40 @@ record Entry(String title, String description, List<String> tags, String codeUrl
     private static final Map<String, Entry> ENTRIES = new LinkedHashMap<>();
 
     static {
-        // ===== Templates / CV =====
-        cv("cv-modern-professional", "Modern Professional", "Clean two-column resume with right-aligned header, tinted profile panel, and uppercase section headings.", "minimal");
-        cv("cv-nordic-clean", "Nordic Clean", "Sidebar layout with soft-tinted PROFILE panel, Nordic palette, and bullet skill list.", "sidebar");
-        cv("cv-classic-serif", "Classic Serif", "Two-page editorial CV with Times-style serif headings and conservative grey rules.", "serif", "two-page");
-        cv("cv-compact-mono", "Compact Mono", "Single-column dense layout with monospace contact line — favourite for engineering roles.", "compact", "mono");
-        cv("cv-executive", "Executive", "Slate palette with prominent name banner, formal tone, and weighted section dividers.", "executive");
-        cv("cv-engineering-resume", "Engineering Resume", "Tech-lead style layout with prominent skill matrix and stack tagging — was TechLead in v1.5.", "tech");
-        cv("cv-timeline-minimal", "Timeline Minimal", "Vertical timeline of roles with bullet markers and tight whitespace.", "timeline");
-        cv("cv-boxed-sections", "Boxed Sections", "Each section wrapped in a grey banner header — bold, structured feel.", "structured");
-        cv("cv-centered-headline", "Centered Headline", "Centered name + role with full-width accent rules between sections.", "centered");
-        cv("cv-blue-banner", "Blue Banner", "Light-blue full-width section bands with high-contrast headings.", "banner", "blue");
-        cv("cv-editorial-blue", "Editorial Blue", "Magazine-style editorial layout with two-column body and tinted skills table.", "editorial", "blue");
-        cv("cv-panel", "Panel", "Soft-tinted panels per section, Product-Leader feel — was ProductLeader in v1.5.", "panel");
-        cv("cv-sidebar-portrait", "Sidebar Portrait", "Edge-to-edge grey sidebar with portrait photo, contact stack, and skills.", "sidebar", "portrait");
-        cv("cv-monogram-sidebar", "Monogram Sidebar", "Sidebar with monogram badge, accent rule, and structured contact + skills column.", "sidebar", "monogram");
-
-        // ===== Templates / Cover Letter =====
-        letter("cover-letter", "Cover Letter (canonical)", "Single-file canonical cover letter authored via CoverLetterFileExample.", "letter");
-        letter("cover-letter-modern-professional", "Modern Professional letter", "Letter paired with the Modern Professional CV palette.");
-        letter("cover-letter-nordic-clean", "Nordic Clean letter", "Letter paired with the Nordic Clean CV palette.");
-        letter("cover-letter-classic-serif", "Classic Serif letter", "Letter with Times-style serif typography.");
-        letter("cover-letter-compact-mono", "Compact Mono letter", "Letter with mono accent and compact spacing.");
-        letter("cover-letter-executive", "Executive letter", "Slate-palette executive letter.");
-        letter("cover-letter-engineering-resume", "Engineering letter", "Letter paired with EngineeringResume palette.");
-        letter("cover-letter-timeline-minimal", "Timeline Minimal letter", "Letter with timeline-style minimal accents.");
-        letter("cover-letter-boxed-sections", "Boxed Sections letter", "Letter with grey-banner section headings.");
-        letter("cover-letter-centered-headline", "Centered Headline letter", "Letter with centered name + accent rules.");
-        letter("cover-letter-blue-banner", "Blue Banner letter", "Letter paired with Blue Banner CV.");
-        letter("cover-letter-editorial-blue", "Editorial Blue letter", "Editorial-magazine letter paired with Editorial Blue CV.");
-        letter("cover-letter-panel", "Panel letter", "Letter paired with Panel CV soft-tinted panels.");
-        letter("cover-letter-sidebar-portrait", "Sidebar Portrait letter", "Letter paired with Sidebar Portrait CV.");
-        letter("cover-letter-monogram-sidebar", "Monogram Sidebar letter", "Letter paired with Monogram Sidebar CV.");
+        // ===== Templates / CV (v2 layered) =====
+        cv("cv-modern-professional-v2", "CvModernV2Example", "Modern Professional", "Clean two-column resume with right-aligned header, tinted profile panel, and uppercase section headings.", "minimal");
+        cv("cv-nordic-clean-v2", "CvNordicCleanExample", "Nordic Clean", "Sidebar layout with soft-tinted PROFILE panel, Nordic palette, and bullet skill list.", "sidebar");
+        cv("cv-classic-serif-v2", "CvClassicSerifExample", "Classic Serif", "Two-page editorial CV with Times-style serif headings and conservative grey rules.", "serif", "two-page");
+        cv("cv-compact-mono-v2", "CvCompactMonoExample", "Compact Mono", "Single-column dense layout with monospace contact line — favourite for engineering roles.", "compact", "mono");
+        cv("cv-executive-v2", "CvExecutiveExample", "Executive", "Slate palette with prominent name banner, formal tone, and weighted section dividers.", "executive");
+        cv("cv-engineering-resume-v2", "CvEngineeringResumeExample", "Engineering Resume", "Tech-lead style layout with prominent skill matrix and stack tagging — was TechLead in v1.5.", "tech");
+        cv("cv-timeline-minimal-v2", "CvTimelineMinimalExample", "Timeline Minimal", "Vertical timeline of roles with bullet markers and tight whitespace.", "timeline");
+        cv("cv-boxed-sections-v2", "CvBoxedV2Example", "Boxed Sections", "Each section wrapped in a grey banner header — bold, structured feel.", "structured");
+        cv("cv-centered-headline-v2", "CvCenteredHeadlineExample", "Centered Headline", "Centered name + role with full-width accent rules between sections.", "centered");
+        cv("cv-blue-banner-v2", "CvBlueBannerExample", "Blue Banner", "Light-blue full-width section bands with high-contrast headings.", "banner", "blue");
+        cv("cv-editorial-blue-v2", "CvEditorialBlueExample", "Editorial Blue", "Magazine-style editorial layout with two-column body and tinted skills table.", "editorial", "blue");
+        cv("cv-panel-v2", "CvPanelExample", "Panel", "Soft-tinted panels per section, Product-Leader feel — was ProductLeader in v1.5.", "panel");
+        cv("cv-sidebar-portrait-v2", "CvSidebarPortraitExample", "Sidebar Portrait", "Edge-to-edge grey sidebar with portrait photo, contact stack, and skills.", "sidebar", "portrait");
+        cv("cv-monogram-sidebar-v2", "CvMonogramSidebarExample", "Monogram Sidebar", "Sidebar with monogram badge, accent rule, and structured contact + skills column.", "sidebar", "monogram");
+        cv("cv-minimal-underlined-v2", "CvMinimalUnderlinedExample", "Minimal Underlined", "Single-column layout with underlined section titles and tight whitespace — minimalist reference shape.", "minimal");
+        cv("cv-mint-editorial-v2", "CvMintEditorialExample", "Mint Editorial", "Magazine-style editorial CV with mint accent palette and two-column body.", "editorial", "mint");
+
+        // ===== Templates / Cover Letter (v2 layered, paired 1:1 with CV) =====
+        letter("cover-letter-modern-professional-v2", "CvModernProfessionalLetterV2Example", "Modern Professional letter", "Letter paired with the Modern Professional CV palette.");
+        letter("cover-letter-nordic-clean-v2", "CvNordicCleanLetterV2Example", "Nordic Clean letter", "Letter paired with the Nordic Clean CV palette.");
+        letter("cover-letter-classic-serif-v2", "CvClassicSerifLetterV2Example", "Classic Serif letter", "Letter with Times-style serif typography.");
+        letter("cover-letter-compact-mono-v2", "CvCompactMonoLetterV2Example", "Compact Mono letter", "Letter with mono accent and compact spacing.");
+        letter("cover-letter-executive-v2", "CvExecutiveLetterV2Example", "Executive letter", "Slate-palette executive letter.");
+        letter("cover-letter-engineering-resume-v2", "CvEngineeringResumeLetterV2Example", "Engineering letter", "Letter paired with EngineeringResume palette.");
+        letter("cover-letter-timeline-minimal-v2", "CvTimelineMinimalLetterV2Example", "Timeline Minimal letter", "Letter with timeline-style minimal accents.");
+        letter("cover-letter-boxed-sections-v2", "CvBoxedSectionsLetterV2Example", "Boxed Sections letter", "Letter with grey-banner section headings.");
+        letter("cover-letter-centered-headline-v2", "CvCenteredHeadlineLetterV2Example", "Centered Headline letter", "Letter with centered name + accent rules.");
+        letter("cover-letter-blue-banner-v2", "CvBlueBannerLetterV2Example", "Blue Banner letter", "Letter paired with Blue Banner CV.");
+        letter("cover-letter-editorial-blue-v2", "CvEditorialBlueLetterV2Example", "Editorial Blue letter", "Editorial-magazine letter paired with Editorial Blue CV.");
+        letter("cover-letter-panel-v2", "CvPanelLetterV2Example", "Panel letter", "Letter paired with Panel CV soft-tinted panels.");
+        letter("cover-letter-sidebar-portrait-v2", "CvSidebarPortraitLetterV2Example", "Sidebar Portrait letter", "Letter paired with Sidebar Portrait CV.");
+        letter("cover-letter-monogram-sidebar-v2", "CvMonogramSidebarLetterV2Example", "Monogram Sidebar letter", "Letter paired with Monogram Sidebar CV.");
+        letter("cover-letter-mint-editorial-v2", "CvMintEditorialLetterV2Example", "Mint Editorial letter", "Letter paired with Mint Editorial CV — magazine-style mint accent.");
 
         // ===== Templates / Invoice =====
         invoice("invoice", "Invoice (canonical)", "Single-page invoice with line items, totals, and structured chrome — InvoiceTemplateV1.", "invoice");
@@ -161,14 +163,14 @@ private static String capitalize(String s) {
         return sb.toString();
     }
 
-    private static void cv(String id, String title, String desc, String... tags) {
+    private static void cv(String id, String exampleClass, String title, String desc, String... tags) {
         ENTRIES.put(id, entry(title, desc, withCategory("cv", tags),
-                EX_BASE + "/templates/cv/CvTemplateGalleryFileExample.java"));
+                EX_BASE + "/templates/cv/v2/" + exampleClass + ".java"));
     }
 
-    private static void letter(String id, String title, String desc, String... tags) {
+    private static void letter(String id, String exampleClass, String title, String desc, String... tags) {
         ENTRIES.put(id, entry(title, desc, withCategory("letter", tags),
-                EX_BASE + "/templates/coverletter/CoverLetterTemplateGalleryFileExample.java"));
+                EX_BASE + "/templates/coverletter/v2/" + exampleClass + ".java"));
     }
 
     private static void invoice(String id, String title, String desc, String... tags) {
diff --git a/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java b/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java
index 1f110bb2..966b6e28 100644
--- a/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java
+++ b/examples/src/main/java/com/demcha/examples/templates/coverletter/CoverLetterTemplateGalleryFileExample.java
@@ -13,6 +13,7 @@
 import com.demcha.compose.document.templates.coverletter.v2.presets.EditorialBlueLetter;
 import com.demcha.compose.document.templates.coverletter.v2.presets.EngineeringResumeLetter;
 import com.demcha.compose.document.templates.coverletter.v2.presets.ExecutiveLetter;
+import com.demcha.compose.document.templates.coverletter.v2.presets.MintEditorialLetter;
 import com.demcha.compose.document.templates.coverletter.v2.presets.ModernProfessionalLetter;
 import com.demcha.compose.document.templates.coverletter.v2.presets.MonogramSidebarLetter;
 import com.demcha.compose.document.templates.coverletter.v2.presets.NordicCleanLetter;
@@ -28,14 +29,14 @@
 import java.util.function.Supplier;
 
 /**
- * Renders all 14 layered cover-letter presets ({@code
+ * Renders all 15 layered cover-letter presets ({@code
  * coverletter.v2.presets.*} — the polished current standard) against
  * the same shared sample {@link CoverLetterDocument}. Each PDF lands in
  * {@code examples/target/generated-pdfs/templates/coverletter/cover-letter-<id>.pdf}
  * where {@code <id>} is the paired CV preset's stable identifier (e.g.
  * {@code cover-letter-modern-professional.pdf}).
  *
- * <p>The 14 letter renders match the 14 CV renders in
+ * <p>The 15 letter renders match the 15 CV renders in
  * {@link com.demcha.examples.templates.cv.CvTemplateGalleryFileExample}
  * — a writer can render both galleries and pick a CV / cover-letter
  * pair sharing the same visual signature.</p>
@@ -46,7 +47,7 @@ private CoverLetterTemplateGalleryFileExample() {
     }
 
     /**
-     * Renders all 14 layered cover-letter preset gallery PDFs.
+     * Renders all 15 layered cover-letter preset gallery PDFs.
      *
      * @return list of absolute paths of the rendered PDFs in source
      *         order
@@ -82,7 +83,8 @@ public static List<Path> generate(String presetId) throws Exception {
                 run("editorial-blue", EditorialBlueLetter.RECOMMENDED_MARGIN, EditorialBlueLetter::create),
                 run("panel", PanelLetter.RECOMMENDED_MARGIN, PanelLetter::create),
                 run("sidebar-portrait", SidebarPortraitLetter.RECOMMENDED_MARGIN, SidebarPortraitLetter::create),
-                run("monogram-sidebar", MonogramSidebarLetter.RECOMMENDED_MARGIN, MonogramSidebarLetter::create));
+                run("monogram-sidebar", MonogramSidebarLetter.RECOMMENDED_MARGIN, MonogramSidebarLetter::create),
+                run("mint-editorial", MintEditorialLetter.RECOMMENDED_MARGIN, MintEditorialLetter::create));
 
         CoverLetterDocument doc = ExampleDataFactory.sampleCoverLetterDocumentV2();
         List<Path> generated = new ArrayList<>();
diff --git a/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvMintEditorialLetterV2Example.java b/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvMintEditorialLetterV2Example.java
new file mode 100644
index 00000000..73c686d6
--- /dev/null
+++ b/examples/src/main/java/com/demcha/examples/templates/coverletter/v2/CvMintEditorialLetterV2Example.java
@@ -0,0 +1,47 @@
+package com.demcha.examples.templates.coverletter.v2;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.coverletter.v2.data.CoverLetterDocument;
+import com.demcha.compose.document.templates.coverletter.v2.presets.MintEditorialLetter;
+import com.demcha.examples.support.ExampleDataFactory;
+import com.demcha.examples.support.ExampleOutputPaths;
+
+import java.nio.file.Path;
+
+/**
+ * Renders the v2 Mint Editorial cover-letter preset — the CV's centred
+ * spaced-caps masthead and mint accent rule reused 1:1, then a
+ * single-column letter body. Pair with {@code CvMintEditorialExample}.
+ *
+ * <p>Output:
+ * {@code examples/target/generated-pdfs/templates/coverletter/cover-letter-mint-editorial-v2.pdf}.</p>
+ */
+public final class CvMintEditorialLetterV2Example {
+
+    private CvMintEditorialLetterV2Example() {
+    }
+
+    public static Path generate() throws Exception {
+        Path outputFile = ExampleOutputPaths.prepare(
+                "templates/coverletter", "cover-letter-mint-editorial-v2.pdf");
+        CoverLetterDocument doc = ExampleDataFactory.sampleCoverLetterDocumentV2();
+        DocumentTemplate<CoverLetterDocument> template = MintEditorialLetter.create();
+
+        float m = (float) MintEditorialLetter.RECOMMENDED_MARGIN;
+        try (DocumentSession document = GraphCompose.document(outputFile)
+                .pageSize(DocumentPageSize.A4)
+                .margin(m, m, m, m)
+                .create()) {
+            template.compose(document, doc);
+            document.buildPdf();
+        }
+        return outputFile;
+    }
+
+    public static void main(String[] args) throws Exception {
+        System.out.println("Generated: " + generate());
+    }
+}
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java
index 5ecce10d..013d85cd 100644
--- a/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/CvTemplateGalleryFileExample.java
@@ -13,6 +13,7 @@
 import com.demcha.compose.document.templates.cv.v2.presets.EditorialBlue;
 import com.demcha.compose.document.templates.cv.v2.presets.EngineeringResume;
 import com.demcha.compose.document.templates.cv.v2.presets.Executive;
+import com.demcha.compose.document.templates.cv.v2.presets.MintEditorial;
 import com.demcha.compose.document.templates.cv.v2.presets.ModernProfessional;
 import com.demcha.compose.document.templates.cv.v2.presets.MonogramSidebar;
 import com.demcha.compose.document.templates.cv.v2.presets.NordicClean;
@@ -28,7 +29,7 @@
 import java.util.function.Supplier;
 
 /**
- * Renders all 14 layered CV presets ({@code cv.v2.presets.*} — the
+ * Renders all 15 layered CV presets ({@code cv.v2.presets.*} — the
  * polished current standard) against the same shared sample
  * {@link CvDocument}. Each PDF lands in
  * {@code examples/target/generated-pdfs/templates/cv/cv-<id>.pdf}
@@ -45,7 +46,7 @@ private CvTemplateGalleryFileExample() {
     }
 
     /**
-     * Renders all 14 layered CV preset gallery PDFs.
+     * Renders all 15 layered CV preset gallery PDFs.
      *
      * @return list of absolute paths of the rendered PDFs in source
      *         order
@@ -79,7 +80,8 @@ public static List<Path> generate(String presetId) throws Exception {
                 run(EditorialBlue.ID, EditorialBlue.RECOMMENDED_MARGIN, EditorialBlue::create),
                 run(Panel.ID, Panel.RECOMMENDED_MARGIN, Panel::create),
                 run(SidebarPortrait.ID, SidebarPortrait.RECOMMENDED_MARGIN, SidebarPortrait::create),
-                run(MonogramSidebar.ID, MonogramSidebar.RECOMMENDED_MARGIN, MonogramSidebar::create));
+                run(MonogramSidebar.ID, MonogramSidebar.RECOMMENDED_MARGIN, MonogramSidebar::create),
+                run(MintEditorial.ID, MintEditorial.RECOMMENDED_MARGIN, MintEditorial::create));
 
         CvDocument doc = ExampleDataFactory.sampleCvDocumentV2();
         List<Path> generated = new ArrayList<>();
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvBlueBannerExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvBlueBannerExample.java
new file mode 100644
index 00000000..e4e24f2c
--- /dev/null
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvBlueBannerExample.java
@@ -0,0 +1,57 @@
+package com.demcha.examples.templates.cv.v2;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.templates.cv.v2.presets.BlueBanner;
+import com.demcha.examples.support.ExampleDataFactory;
+import com.demcha.examples.support.ExampleOutputPaths;
+
+import java.nio.file.Path;
+
+/**
+ * Renders the v2 Blue Banner CV preset against the structured
+ * {@code CvDocument} sample data using the preset's default theme.
+ *
+ * <p>Output:
+ * {@code examples/target/generated-pdfs/templates/cv/cv-blue-banner-v2.pdf}.</p>
+ *
+ * <p>Light-blue full-width section bands with high-contrast headings —
+ * the "blue banner" composition of the v2 layered CV stack.</p>
+ */
+public final class CvBlueBannerExample {
+
+    private CvBlueBannerExample() {
+    }
+
+    /**
+     * @return absolute path of the rendered PDF
+     * @throws Exception if rendering fails
+     */
+    public static Path generate() throws Exception {
+        Path outputFile = ExampleOutputPaths.prepare(
+                "templates/cv", "cv-blue-banner-v2.pdf");
+        CvDocument doc = ExampleDataFactory.sampleCvDocumentV2();
+        DocumentTemplate<CvDocument> template = BlueBanner.create();
+
+        float m = (float) BlueBanner.RECOMMENDED_MARGIN;
+        try (DocumentSession document = GraphCompose.document(outputFile)
+                .pageSize(DocumentPageSize.A4)
+                .margin(m, m, m, m)
+                .create()) {
+            template.compose(document, doc);
+            document.buildPdf();
+        }
+        return outputFile;
+    }
+
+    /**
+     * @param args ignored
+     * @throws Exception if rendering fails
+     */
+    public static void main(String[] args) throws Exception {
+        System.out.println("Generated: " + generate());
+    }
+}
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCenteredHeadlineExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCenteredHeadlineExample.java
new file mode 100644
index 00000000..3de1c400
--- /dev/null
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCenteredHeadlineExample.java
@@ -0,0 +1,57 @@
+package com.demcha.examples.templates.cv.v2;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.templates.cv.v2.presets.CenteredHeadline;
+import com.demcha.examples.support.ExampleDataFactory;
+import com.demcha.examples.support.ExampleOutputPaths;
+
+import java.nio.file.Path;
+
+/**
+ * Renders the v2 Centered Headline CV preset against the structured
+ * {@code CvDocument} sample data using the preset's default theme.
+ *
+ * <p>Output:
+ * {@code examples/target/generated-pdfs/templates/cv/cv-centered-headline-v2.pdf}.</p>
+ *
+ * <p>Centered name + role with full-width accent rules between sections —
+ * the "centered headline" composition of the v2 layered CV stack.</p>
+ */
+public final class CvCenteredHeadlineExample {
+
+    private CvCenteredHeadlineExample() {
+    }
+
+    /**
+     * @return absolute path of the rendered PDF
+     * @throws Exception if rendering fails
+     */
+    public static Path generate() throws Exception {
+        Path outputFile = ExampleOutputPaths.prepare(
+                "templates/cv", "cv-centered-headline-v2.pdf");
+        CvDocument doc = ExampleDataFactory.sampleCvDocumentV2();
+        DocumentTemplate<CvDocument> template = CenteredHeadline.create();
+
+        float m = (float) CenteredHeadline.RECOMMENDED_MARGIN;
+        try (DocumentSession document = GraphCompose.document(outputFile)
+                .pageSize(DocumentPageSize.A4)
+                .margin(m, m, m, m)
+                .create()) {
+            template.compose(document, doc);
+            document.buildPdf();
+        }
+        return outputFile;
+    }
+
+    /**
+     * @param args ignored
+     * @throws Exception if rendering fails
+     */
+    public static void main(String[] args) throws Exception {
+        System.out.println("Generated: " + generate());
+    }
+}
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvClassicSerifExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvClassicSerifExample.java
new file mode 100644
index 00000000..4ca5e88c
--- /dev/null
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvClassicSerifExample.java
@@ -0,0 +1,58 @@
+package com.demcha.examples.templates.cv.v2;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.templates.cv.v2.presets.ClassicSerif;
+import com.demcha.examples.support.ExampleDataFactory;
+import com.demcha.examples.support.ExampleOutputPaths;
+
+import java.nio.file.Path;
+
+/**
+ * Renders the v2 Classic Serif CV preset against the structured
+ * {@code CvDocument} sample data using the preset's default theme.
+ *
+ * <p>Output:
+ * {@code examples/target/generated-pdfs/templates/cv/cv-classic-serif-v2.pdf}.</p>
+ *
+ * <p>Two-page editorial CV with Times-style serif headings and
+ * conservative grey rules — the "classic serif" composition of the v2
+ * layered CV stack.</p>
+ */
+public final class CvClassicSerifExample {
+
+    private CvClassicSerifExample() {
+    }
+
+    /**
+     * @return absolute path of the rendered PDF
+     * @throws Exception if rendering fails
+     */
+    public static Path generate() throws Exception {
+        Path outputFile = ExampleOutputPaths.prepare(
+                "templates/cv", "cv-classic-serif-v2.pdf");
+        CvDocument doc = ExampleDataFactory.sampleCvDocumentV2();
+        DocumentTemplate<CvDocument> template = ClassicSerif.create();
+
+        float m = (float) ClassicSerif.RECOMMENDED_MARGIN;
+        try (DocumentSession document = GraphCompose.document(outputFile)
+                .pageSize(DocumentPageSize.A4)
+                .margin(m, m, m, m)
+                .create()) {
+            template.compose(document, doc);
+            document.buildPdf();
+        }
+        return outputFile;
+    }
+
+    /**
+     * @param args ignored
+     * @throws Exception if rendering fails
+     */
+    public static void main(String[] args) throws Exception {
+        System.out.println("Generated: " + generate());
+    }
+}
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCompactMonoExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCompactMonoExample.java
new file mode 100644
index 00000000..8df7a32e
--- /dev/null
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvCompactMonoExample.java
@@ -0,0 +1,58 @@
+package com.demcha.examples.templates.cv.v2;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.templates.cv.v2.presets.CompactMono;
+import com.demcha.examples.support.ExampleDataFactory;
+import com.demcha.examples.support.ExampleOutputPaths;
+
+import java.nio.file.Path;
+
+/**
+ * Renders the v2 Compact Mono CV preset against the structured
+ * {@code CvDocument} sample data using the preset's default theme.
+ *
+ * <p>Output:
+ * {@code examples/target/generated-pdfs/templates/cv/cv-compact-mono-v2.pdf}.</p>
+ *
+ * <p>Single-column dense layout with monospace contact line — the
+ * "compact mono" composition of the v2 layered CV stack, popular for
+ * engineering roles.</p>
+ */
+public final class CvCompactMonoExample {
+
+    private CvCompactMonoExample() {
+    }
+
+    /**
+     * @return absolute path of the rendered PDF
+     * @throws Exception if rendering fails
+     */
+    public static Path generate() throws Exception {
+        Path outputFile = ExampleOutputPaths.prepare(
+                "templates/cv", "cv-compact-mono-v2.pdf");
+        CvDocument doc = ExampleDataFactory.sampleCvDocumentV2();
+        DocumentTemplate<CvDocument> template = CompactMono.create();
+
+        float m = (float) CompactMono.RECOMMENDED_MARGIN;
+        try (DocumentSession document = GraphCompose.document(outputFile)
+                .pageSize(DocumentPageSize.A4)
+                .margin(m, m, m, m)
+                .create()) {
+            template.compose(document, doc);
+            document.buildPdf();
+        }
+        return outputFile;
+    }
+
+    /**
+     * @param args ignored
+     * @throws Exception if rendering fails
+     */
+    public static void main(String[] args) throws Exception {
+        System.out.println("Generated: " + generate());
+    }
+}
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMinimalUnderlinedExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMinimalUnderlinedExample.java
index 3e3325d5..9b85bb61 100644
--- a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMinimalUnderlinedExample.java
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMinimalUnderlinedExample.java
@@ -27,7 +27,7 @@ private CvMinimalUnderlinedExample() {
 
     public static Path generate() throws Exception {
         Path outputFile = ExampleOutputPaths.prepare(
-                "templates/cv", "cv-minimal-underlined.pdf");
+                "templates/cv", "cv-minimal-underlined-v2.pdf");
         CvDocument doc = ExampleDataFactory.sampleCvDocumentV2();
         DocumentTemplate<CvDocument> template = MinimalUnderlined.create();
 
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMintEditorialExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMintEditorialExample.java
new file mode 100644
index 00000000..8cd244ad
--- /dev/null
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvMintEditorialExample.java
@@ -0,0 +1,86 @@
+package com.demcha.examples.templates.cv.v2;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.exceptions.DocumentRenderingException;
+import com.demcha.compose.document.templates.cv.v2.presets.MintEditorial;
+import com.demcha.examples.support.ExampleDataFactory;
+import com.demcha.examples.support.ExampleOutputPaths;
+
+import java.io.IOException;
+import java.nio.file.Path;
+
+/**
+ * Renders the v2 Mint Editorial CV preset against the rich "Rose Harris"
+ * showcase dataset ({@link ExampleDataFactory#mintEditorialShowcaseCv()})
+ * so the output matches the Mint Editorial visual reference 1:1 — a
+ * two-page editorial resume with a full-width mint masthead rule, a
+ * contact / interests / education left sidebar beside profile + experience
+ * on page 1, and an expertise / skill-bars / social sidebar beside
+ * continued experience, awards and references on page 2.
+ *
+ * <p>The showcase dataset is example-local on purpose: the shared
+ * {@link ExampleDataFactory#sampleCvDocumentV2()} stays untouched so no
+ * other preset's visual baseline moves.</p>
+ *
+ * <p>Output:
+ * {@code examples/target/generated-pdfs/templates/cv/cv-mint-editorial-v2.pdf}
+ * (falls back to {@code …-rev2.pdf} when the primary file is locked by an
+ * open viewer).</p>
+ */
+public final class CvMintEditorialExample {
+
+    private CvMintEditorialExample() {
+    }
+
+    public static Path generate() throws Exception {
+        CvDocument doc = ExampleDataFactory.mintEditorialShowcaseCv();
+        Path primary = ExampleOutputPaths.prepare(
+                "templates/cv", "cv-mint-editorial-v2.pdf");
+        try {
+            return render(doc, primary);
+        } catch (DocumentRenderingException rendering) {
+            if (!causedByIo(rendering)) {
+                throw rendering;
+            }
+            // The user may still have the previous PDF open in a viewer,
+            // which holds a Windows file lock (surfaces as an IOException
+            // wrapped in DocumentRenderingException). Fall back to a -rev2
+            // path so the render still succeeds and is reported.
+            Path fallback = ExampleOutputPaths.prepare(
+                    "templates/cv", "cv-mint-editorial-v2-rev2.pdf");
+            System.out.println("Primary output locked (" + rendering.getMessage()
+                    + "); writing fallback: " + fallback);
+            return render(doc, fallback);
+        }
+    }
+
+    private static boolean causedByIo(Throwable t) {
+        for (Throwable c = t; c != null; c = c.getCause()) {
+            if (c instanceof IOException) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private static Path render(CvDocument doc, Path outputFile) throws Exception {
+        DocumentTemplate<CvDocument> template = MintEditorial.create();
+        float m = (float) MintEditorial.RECOMMENDED_MARGIN;
+        try (DocumentSession document = GraphCompose.document(outputFile)
+                .pageSize(DocumentPageSize.A4)
+                .margin(m, m, m, m)
+                .create()) {
+            template.compose(document, doc);
+            document.buildPdf();
+        }
+        return outputFile;
+    }
+
+    public static void main(String[] args) throws Exception {
+        System.out.println("Generated: " + generate());
+    }
+}
diff --git a/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvNordicCleanExample.java b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvNordicCleanExample.java
new file mode 100644
index 00000000..95ec0e7a
--- /dev/null
+++ b/examples/src/main/java/com/demcha/examples/templates/cv/v2/CvNordicCleanExample.java
@@ -0,0 +1,58 @@
+package com.demcha.examples.templates.cv.v2;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.templates.cv.v2.presets.NordicClean;
+import com.demcha.examples.support.ExampleDataFactory;
+import com.demcha.examples.support.ExampleOutputPaths;
+
+import java.nio.file.Path;
+
+/**
+ * Renders the v2 Nordic Clean CV preset against the structured
+ * {@code CvDocument} sample data using the preset's default theme.
+ *
+ * <p>Output:
+ * {@code examples/target/generated-pdfs/templates/cv/cv-nordic-clean-v2.pdf}.</p>
+ *
+ * <p>Sidebar layout with soft-tinted PROFILE panel, Nordic palette, and
+ * a bullet skill list — the "nordic clean" composition of the v2
+ * layered CV stack.</p>
+ */
+public final class CvNordicCleanExample {
+
+    private CvNordicCleanExample() {
+    }
+
+    /**
+     * @return absolute path of the rendered PDF
+     * @throws Exception if rendering fails
+     */
+    public static Path generate() throws Exception {
+        Path outputFile = ExampleOutputPaths.prepare(
+                "templates/cv", "cv-nordic-clean-v2.pdf");
+        CvDocument doc = ExampleDataFactory.sampleCvDocumentV2();
+        DocumentTemplate<CvDocument> template = NordicClean.create();
+
+        float m = (float) NordicClean.RECOMMENDED_MARGIN;
+        try (DocumentSession document = GraphCompose.document(outputFile)
+                .pageSize(DocumentPageSize.A4)
+                .margin(m, m, m, m)
+                .create()) {
+            template.compose(document, doc);
+            document.buildPdf();
+        }
+        return outputFile;
+    }
+
+    /**
+     * @param args ignored
+     * @throws Exception if rendering fails
+     */
+    public static void main(String[] args) throws Exception {
+        System.out.println("Generated: " + generate());
+    }
+}
diff --git a/scripts/cut-release.ps1 b/scripts/cut-release.ps1
index a68e0bb5..04d376d6 100644
--- a/scripts/cut-release.ps1
+++ b/scripts/cut-release.ps1
@@ -198,6 +198,51 @@ function Update-ReadmeInstallVersion($readmePath, $newVersion) {
     }
 }
 
+function Update-IndexHtmlVersion($indexHtmlPath, $newVersion) {
+    if (-not (Test-Path $indexHtmlPath)) {
+        Note "skip (no file): $indexHtmlPath"
+        return
+    }
+    $content = Get-Content $indexHtmlPath -Raw
+    $tag = "v$newVersion"
+    $changed = $false
+
+    # The GitHub Pages showcase (docs/index.html) hardcodes the version in five
+    # spots that do NOT inherit from the pom — they previously sat at v1.6.1
+    # while the library shipped v1.6.4. VersionConsistencyGuardTest fails the
+    # verify gate if any lags, so flip all five in lockstep with README + poms:
+    # JSON-LD softwareVersion (bare), JitPack downloadUrl, hero badge, and the
+    # Maven + Gradle install snippets (all v-prefixed). Lookbehind/lookahead so
+    # only the version token is rewritten.
+    $replacements = @(
+        @{ Regex = [regex]'(?<="softwareVersion": ")v?[\w\.\-]+(?=")';               Value = $newVersion; Label = 'JSON-LD softwareVersion' },
+        @{ Regex = [regex]'(?<=jitpack\.io/#DemchaAV/GraphCompose/)v?[\w\.\-]+(?=")'; Value = $tag;        Label = 'JitPack downloadUrl' },
+        @{ Regex = [regex]'(?<=Java &middot; )v?[\w\.\-]+(?= &middot; MIT)';          Value = $tag;        Label = 'hero badge' },
+        @{ Regex = [regex]'(?<=&lt;version&gt;)v?[\w\.\-]+(?=&lt;/version&gt;)';      Value = $tag;        Label = 'Maven snippet' },
+        @{ Regex = [regex]"(?<=:GraphCompose:)v?[\w\.\-]+(?=')";                      Value = $tag;        Label = 'Gradle snippet' }
+    )
+
+    foreach ($r in $replacements) {
+        $after = $r.Regex.Replace($content, $r.Value, 1)
+        if ($content -ne $after) {
+            $content = $after
+            $changed = $true
+            Note "bumped index.html $($r.Label) -> $($r.Value)"
+        }
+    }
+
+    if (-not $changed) {
+        Note "no change: docs/index.html version (already $tag?)"
+        return
+    }
+
+    if ($DryRun) {
+        Write-Host "    [DRY RUN] docs/index.html version -> $tag" -ForegroundColor Yellow
+    } else {
+        [System.IO.File]::WriteAllText($indexHtmlPath, $content)
+    }
+}
+
 function Update-ShowcaseGhBase($newRef) {
     if (-not (Test-Path $showcaseMetadata)) {
         throw "ShowcaseMetadata.java not found: $showcaseMetadata"
@@ -337,6 +382,7 @@ try {
     Update-PomVersion (Join-Path $repoRoot 'examples/pom.xml') $Version
     Update-PomVersion (Join-Path $repoRoot 'benchmarks/pom.xml') $Version
     Update-ReadmeInstallVersion (Join-Path $repoRoot 'README.md') $Version
+    Update-IndexHtmlVersion (Join-Path $repoRoot 'docs/index.html') $Version
 
     Step 2 "Update CHANGELOG date for v$Version"
     $changelog = Join-Path $repoRoot 'CHANGELOG.md'
@@ -386,7 +432,7 @@ try {
     Step 6 "Commit release"
     $commitMsg = "Release v$Version"
     if ($DryRun) {
-        Write-Host "    [DRY RUN] git add pom.xml aggregator/pom.xml examples/pom.xml benchmarks/pom.xml README.md CHANGELOG.md examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java docs/examples.json" -ForegroundColor Yellow
+        Write-Host "    [DRY RUN] git add pom.xml aggregator/pom.xml examples/pom.xml benchmarks/pom.xml README.md CHANGELOG.md examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java docs/examples.json docs/index.html" -ForegroundColor Yellow
         Write-Host "    [DRY RUN] git commit -m `"$commitMsg`"" -ForegroundColor Yellow
     } else {
         git add `
@@ -397,7 +443,8 @@ try {
             README.md `
             CHANGELOG.md `
             examples/src/main/java/com/demcha/examples/support/ShowcaseMetadata.java `
-            docs/examples.json
+            docs/examples.json `
+            docs/index.html
         git commit -m $commitMsg
         Note "commit: $commitMsg"
     }
diff --git a/src/main/java/com/demcha/compose/document/templates/coverletter/v2/presets/MintEditorialLetter.java b/src/main/java/com/demcha/compose/document/templates/coverletter/v2/presets/MintEditorialLetter.java
new file mode 100644
index 00000000..bd404f49
--- /dev/null
+++ b/src/main/java/com/demcha/compose/document/templates/coverletter/v2/presets/MintEditorialLetter.java
@@ -0,0 +1,133 @@
+package com.demcha.compose.document.templates.coverletter.v2.presets;
+
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.dsl.PageFlowBuilder;
+import com.demcha.compose.document.dsl.SectionBuilder;
+import com.demcha.compose.document.style.DocumentColor;
+import com.demcha.compose.document.style.DocumentInsets;
+import com.demcha.compose.document.style.DocumentTextDecoration;
+import com.demcha.compose.document.style.DocumentTextStyle;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.coverletter.v2.components.LetterBody;
+import com.demcha.compose.document.templates.coverletter.v2.data.CoverLetterDocument;
+import com.demcha.compose.document.templates.cv.v2.components.CvTextStyles;
+import com.demcha.compose.document.templates.cv.v2.data.CvIdentity;
+import com.demcha.compose.document.templates.cv.v2.theme.CvTheme;
+import com.demcha.compose.document.templates.cv.v2.widgets.Headline;
+import com.demcha.compose.document.templates.cv.v2.widgets.Subheadline;
+
+import java.util.Objects;
+
+/**
+ * v2 cover-letter pair for the {@code MintEditorial} CV preset.
+ *
+ * <p>Reproduces the CV's signature masthead 1:1 — a centred spaced-caps
+ * Poppins name, a centred soft-mint accent tagline, and a full-width 6pt
+ * mint accent rule — then a single-column letter body via the shared
+ * {@link LetterBody}. Palette / typography / spacing come from the
+ * <strong>same</strong> {@link CvTheme#mintEditorial()} the CV uses, and the
+ * mint accent is read from {@code theme.palette().banner()} exactly as in the
+ * CV, so the CV and the letter read as one matched set. The CV's two-column
+ * sidebar grids are a CV-body concern and are intentionally not part of the
+ * letter.</p>
+ */
+public final class MintEditorialLetter {
+
+    /** Stable template identifier. */
+    public static final String ID = "mint-editorial-letter";
+
+    /** Human-readable display name. */
+    public static final String DISPLAY_NAME = "Mint Editorial Letter";
+
+    /** Recommended symmetric page margin (in points). Matches the CV preset. */
+    public static final double RECOMMENDED_MARGIN = 48.0;
+
+    private MintEditorialLetter() {
+    }
+
+    /** Builds the letter with its Mint Editorial theme. */
+    public static DocumentTemplate<CoverLetterDocument> create() {
+        return create(CvTheme.mintEditorial());
+    }
+
+    /**
+     * Builds the letter with a caller-supplied theme (share the paired CV's
+     * theme instance for a guaranteed visual match).
+     */
+    public static DocumentTemplate<CoverLetterDocument> create(CvTheme theme) {
+        Objects.requireNonNull(theme, "theme");
+        return new Template(theme);
+    }
+
+    private static final class Template implements DocumentTemplate<CoverLetterDocument> {
+
+        private final CvTheme theme;
+        private final DocumentColor accent;
+
+        Template(CvTheme theme) {
+            this.theme = theme;
+            // Same accent source as the paired CV preset — the palette
+            // banner slot carries the mint accent.
+            this.accent = theme.palette().banner();
+        }
+
+        @Override
+        public String id() {
+            return ID;
+        }
+
+        @Override
+        public String displayName() {
+            return DISPLAY_NAME;
+        }
+
+        @Override
+        public void compose(DocumentSession document, CoverLetterDocument doc) {
+            Objects.requireNonNull(document, "document");
+            Objects.requireNonNull(doc, "doc");
+
+            double innerWidth = document.canvas().innerWidth();
+            double pageWidth = document.canvas().width();
+            // Full-page-width masthead rule (see MintEditorial): bleed past
+            // the page margins so the mint rule spans the whole page.
+            double ruleBleed = (pageWidth - innerWidth) / 2.0;
+            PageFlowBuilder flow = document.dsl()
+                    .pageFlow()
+                    .name("CoverLetterV2MintEditorialRoot")
+                    .spacing(theme.spacing().pageFlowSpacing());
+
+            flow.addSection("CoverLetterV2MintEditorialHeader",
+                    section -> addMasthead(section, doc.identity()));
+            flow.addLine(line -> line
+                    .name("CoverLetterV2MintEditorialHeaderRule")
+                    .horizontal(pageWidth)
+                    .color(accent)
+                    .thickness(theme.spacing().accentRuleWidth())
+                    .margin(new DocumentInsets(8, -ruleBleed, 14, -ruleBleed)));
+
+            flow.addSection("CoverLetterV2MintEditorialBody", host ->
+                    LetterBody.render(host, doc, theme));
+
+            flow.build();
+        }
+
+        /**
+         * Centred spaced-caps name + mint accent tagline — the identical
+         * masthead the {@code MintEditorial} CV preset renders, so the
+         * matched set never forks the header treatment.
+         */
+        private void addMasthead(SectionBuilder section, CvIdentity identity) {
+            Headline.spacedCentered(section, identity.name(), theme);
+            String jobTitle = identity.jobTitle();
+            if (jobTitle != null && !jobTitle.isBlank()) {
+                Subheadline.centeredSpacedCaps(section, jobTitle, taglineStyle());
+            }
+        }
+
+        private DocumentTextStyle taglineStyle() {
+            return CvTextStyles.of(theme.typography().headlineFont(),
+                    theme.typography().sizeContact(),
+                    DocumentTextDecoration.BOLD, accent);
+        }
+    }
+}
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/data/CvSkill.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/data/CvSkill.java
new file mode 100644
index 00000000..4e90c6d4
--- /dev/null
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/data/CvSkill.java
@@ -0,0 +1,50 @@
+package com.demcha.compose.document.templates.cv.v2.data;
+
+import java.util.Objects;
+import java.util.OptionalDouble;
+
+/**
+ * One atomic skill label with an optional proficiency level in
+ * {@code [0, 1]}.
+ *
+ * <p>The level is what data-driven skill visuals — proficiency bars,
+ * dots, meters — read. Skills created without a level (the common case,
+ * and every skill built through the string-based
+ * {@link SkillGroup#of(String, String...)} /
+ * {@link SkillGroup#ofNames(String, java.util.List)} APIs) carry an
+ * empty level, so name-only renderers are completely unaffected by the
+ * level channel.</p>
+ *
+ * @param name  non-blank skill label
+ * @param level optional proficiency in {@code [0, 1]}; empty when
+ *              unspecified
+ */
+public record CvSkill(String name, OptionalDouble level) {
+
+    public CvSkill {
+        Objects.requireNonNull(name, "name");
+        Objects.requireNonNull(level, "level");
+        name = name.trim();
+        if (name.isBlank()) {
+            throw new IllegalArgumentException("name must not be blank");
+        }
+        if (level.isPresent()) {
+            double value = level.getAsDouble();
+            if (value < 0.0 || value > 1.0) {
+                throw new IllegalArgumentException(
+                        "level must be in [0,1] but was " + value);
+            }
+        }
+    }
+
+    /** Skill with no proficiency level. */
+    public static CvSkill of(String name) {
+        return new CvSkill(name, OptionalDouble.empty());
+    }
+
+    /** Skill with a proficiency level, clamped to {@code [0, 1]}. */
+    public static CvSkill of(String name, double level) {
+        return new CvSkill(name,
+                OptionalDouble.of(Math.max(0.0, Math.min(1.0, level))));
+    }
+}
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillGroup.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillGroup.java
index 0003b7f4..b22a6441 100644
--- a/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillGroup.java
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillGroup.java
@@ -6,44 +6,82 @@
 import java.util.Objects;
 
 /**
- * One semantic skill category and its atomic skill labels.
+ * One semantic skill category and its atomic skill entries.
  *
  * <p>Examples: {@code Languages -> [Java 21, Kotlin, SQL]} or
  * {@code Testing -> [JUnit 5, AssertJ, visual regression]}. Presets
  * can render the same group as a table cell, a sidebar list, chips,
- * or a compact inline row without reparsing free text.</p>
+ * proficiency bars, or a compact inline row without reparsing free
+ * text.</p>
+ *
+ * <p>Each entry is a {@link CvSkill} that optionally carries a
+ * proficiency level in {@code [0, 1]}. The level is read only by
+ * data-driven visuals (skill bars/meters); name-only renderers use
+ * {@link #skills()} and are unaffected by whether levels are present.
+ * Groups built through the string APIs ({@link #of(String, String...)},
+ * {@link #ofNames(String, List)}) carry no levels.</p>
  *
  * @param category category label, non-blank
- * @param skills   ordered skill labels; blank values are ignored
+ * @param entries  ordered skill entries; blank-named entries are ignored
  */
-public record SkillGroup(String category, List<String> skills) {
+public record SkillGroup(String category, List<CvSkill> entries) {
 
     public SkillGroup {
         Objects.requireNonNull(category, "category");
-        Objects.requireNonNull(skills, "skills");
+        Objects.requireNonNull(entries, "entries");
         category = category.trim();
         if (category.isBlank()) {
             throw new IllegalArgumentException("category must not be blank");
         }
-        List<String> cleaned = new ArrayList<>(skills.size());
-        for (String skill : skills) {
-            String value = skill == null ? "" : skill.trim();
-            if (!value.isBlank()) {
-                cleaned.add(value);
+        List<CvSkill> cleaned = new ArrayList<>(entries.size());
+        for (CvSkill entry : entries) {
+            if (entry != null && !entry.name().isBlank()) {
+                cleaned.add(entry);
             }
         }
-        skills = List.copyOf(cleaned);
+        entries = List.copyOf(cleaned);
     }
 
+    /** Skill group from plain labels (no proficiency levels). */
     public static SkillGroup of(String category, String... skills) {
-        return new SkillGroup(category,
+        return ofNames(category,
                 skills == null ? List.of() : Arrays.asList(skills));
     }
 
+    /** Skill group from a list of plain labels (no proficiency levels). */
+    public static SkillGroup ofNames(String category, List<String> skills) {
+        List<CvSkill> out = new ArrayList<>(skills == null ? 0 : skills.size());
+        if (skills != null) {
+            for (String skill : skills) {
+                String value = skill == null ? "" : skill.trim();
+                if (!value.isBlank()) {
+                    out.add(CvSkill.of(value));
+                }
+            }
+        }
+        return new SkillGroup(category, out);
+    }
+
+    /**
+     * Ordered skill labels with the proficiency levels dropped.
+     *
+     * <p>This is the shape every name-only renderer consumes; it is kept
+     * stable so adding levels never changes name-based output.</p>
+     *
+     * @return ordered skill labels
+     */
+    public List<String> skills() {
+        List<String> names = new ArrayList<>(entries.size());
+        for (CvSkill entry : entries) {
+            names.add(entry.name());
+        }
+        return List.copyOf(names);
+    }
+
     /**
-     * @return comma-separated skills, useful for compact renderers
+     * @return comma-separated skill labels, useful for compact renderers
      */
     public String skillsInline() {
-        return String.join(", ", skills);
+        return String.join(", ", skills());
     }
 }
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSection.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSection.java
index 83f71954..ed4cea06 100644
--- a/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSection.java
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSection.java
@@ -65,7 +65,7 @@ public Builder group(SkillGroup group) {
         }
 
         public Builder group(String category, List<String> skills) {
-            this.groups.add(new SkillGroup(category, skills));
+            this.groups.add(SkillGroup.ofNames(category, skills));
             return this;
         }
 
@@ -74,6 +74,20 @@ public Builder group(String category, String... skills) {
             return this;
         }
 
+        /**
+         * Add a group whose entries carry optional proficiency levels.
+         * Use this for presets that render data-driven skill bars/meters;
+         * name-only presets render the same entries as plain labels.
+         *
+         * @param category group category label, non-blank
+         * @param entries  ordered leveled skill entries
+         * @return this builder
+         */
+        public Builder leveledGroup(String category, List<CvSkill> entries) {
+            this.groups.add(new SkillGroup(category, entries));
+            return this;
+        }
+
         public SkillsSection build() {
             return new SkillsSection(title, groups);
         }
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorial.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorial.java
new file mode 100644
index 00000000..4f455289
--- /dev/null
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorial.java
@@ -0,0 +1,934 @@
+package com.demcha.compose.document.templates.cv.v2.presets;
+
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.dsl.ParagraphBuilder;
+import com.demcha.compose.document.dsl.SectionBuilder;
+import com.demcha.compose.document.image.DocumentImageData;
+import com.demcha.compose.document.node.DocumentLinkOptions;
+import com.demcha.compose.document.node.ParagraphNode;
+import com.demcha.compose.document.node.TextAlign;
+import com.demcha.compose.document.style.DocumentColor;
+import com.demcha.compose.document.style.DocumentInsets;
+import com.demcha.compose.document.style.DocumentStroke;
+import com.demcha.compose.document.style.DocumentTextDecoration;
+import com.demcha.compose.document.style.DocumentTextStyle;
+import com.demcha.compose.document.table.DocumentTableCell;
+import com.demcha.compose.document.table.DocumentTableColumn;
+import com.demcha.compose.document.table.DocumentTableStyle;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.components.CvTextStyles;
+import com.demcha.compose.document.templates.cv.v2.components.MarkdownInline;
+import com.demcha.compose.document.templates.cv.v2.components.SectionLookup;
+import com.demcha.compose.document.templates.cv.v2.components.TextOrnaments;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.templates.cv.v2.data.CvEntry;
+import com.demcha.compose.document.templates.cv.v2.data.CvIdentity;
+import com.demcha.compose.document.templates.cv.v2.data.CvLink;
+import com.demcha.compose.document.templates.cv.v2.data.CvRow;
+import com.demcha.compose.document.templates.cv.v2.data.CvSection;
+import com.demcha.compose.document.templates.cv.v2.data.CvSkill;
+import com.demcha.compose.document.templates.cv.v2.data.EntriesSection;
+import com.demcha.compose.document.templates.cv.v2.data.ParagraphSection;
+import com.demcha.compose.document.templates.cv.v2.data.RowsSection;
+import com.demcha.compose.document.templates.cv.v2.data.SkillGroup;
+import com.demcha.compose.document.templates.cv.v2.data.SkillsSection;
+import com.demcha.compose.document.templates.cv.v2.data.Slot;
+import com.demcha.compose.document.templates.cv.v2.theme.CvTheme;
+import com.demcha.compose.document.templates.cv.v2.widgets.Headline;
+import com.demcha.compose.document.templates.cv.v2.widgets.IconTextRow;
+import com.demcha.compose.document.templates.cv.v2.widgets.SkillBar;
+import com.demcha.compose.document.templates.cv.v2.widgets.Subheadline;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.UncheckedIOException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Objects;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * v2 "Mint Editorial" CV preset — a two-page, two-column editorial resume
+ * ported from the flat canonical {@code MintEditorialCvTemplate}.
+ *
+ * <p>Visual signature: a centred spaced-caps name with a soft mint accent
+ * tagline, a full-width 6pt mint accent rule, then two pages that each lay
+ * out a narrow left sidebar (weight {@value #SIDEBAR_WEIGHT}) beside a wide
+ * main column. Page 1 sidebar carries Contact (icon rows), Interests and
+ * Education; page 1 main carries Profile and the first slice of Experience.
+ * Page 2 sidebar carries Expertise (badge + label list), level-driven Skill
+ * bars and Social rows; page 2 main carries the rest of Experience plus
+ * Awards and References two-column grids. Poppins throughout; the mint
+ * accent lives in {@code theme.palette().banner()}.</p>
+ *
+ * <h2>Atomic-row partitioning</h2>
+ *
+ * <p>Each page's sidebar+main grid is a single {@code addRow}, which the
+ * canonical paginator treats as <strong>atomic</strong> — the whole row must
+ * fit on one page or it raises {@code AtomicNodeTooLargeException} (rows do
+ * not page-break, and a row cannot host a table directly, so the Awards /
+ * References tables live inside the main <em>section</em> column, not the row).
+ * To keep each page's row inside the page bound the preset slices Experience
+ * across the two pages ({@value #EXPERIENCE_PAGE_ONE} entries on page 1, the
+ * remainder on page 2), mirroring the blueprint's
+ * {@code experiencePage1 / experiencePage2} split.</p>
+ *
+ * <p>The two rows reach two pages by <strong>natural atomic overflow</strong>,
+ * not an explicit page break: the page-1 row fills page 1, so the page-2 row —
+ * being atomic — moves whole onto page 2. An explicit {@code addPageBreak} is
+ * deliberately avoided because a break landing on an already-full page-1
+ * emits a blank intermediate page.</p>
+ *
+ * <h2>Section mapping &amp; graceful degradation</h2>
+ *
+ * <p>Sections are resolved from {@link Slot#MAIN} by title keyword via
+ * {@link SectionLookup}; the canonical sample places everything in MAIN.
+ * Mappings:</p>
+ *
+ * <ul>
+ *   <li><b>Contact</b> ← {@link CvIdentity#contact()} (phone / email /
+ *       address) + {@link CvIdentity#links()} as icon rows.</li>
+ *   <li><b>Interests</b> ← a {@link RowsSection} titled "interests" (absent
+ *       in the canonical sample → skipped).</li>
+ *   <li><b>Education</b> ← the Education {@link EntriesSection}.</li>
+ *   <li><b>Expertise</b> ← the {@link SkillsSection} group categories (the
+ *       category labels read as an expertise list), beneath the badge image.</li>
+ *   <li><b>Skills</b> ← the {@link SkillsSection} entries flattened into
+ *       {@link SkillBar}s; entries with a level draw a bar, name-only entries
+ *       render as a label.</li>
+ *   <li><b>Social</b> ← {@link CvIdentity#links()} as icon rows.</li>
+ *   <li><b>Profile</b> ← the summary / profile {@link ParagraphSection}.</li>
+ *   <li><b>Experience</b> ← the Experience {@link EntriesSection}, split
+ *       across the two pages.</li>
+ *   <li><b>Awards</b> ← a {@link RowsSection} titled "awards" (name = row
+ *       label, meta = row body); absent → skipped.</li>
+ *   <li><b>References</b> ← a {@link RowsSection} titled "references"; absent
+ *       → skipped.</li>
+ * </ul>
+ *
+ * <p>Absent sidebar/main sections are skipped rather than crashing, so the
+ * preset renders cleanly against documents that omit Interests, Awards,
+ * References, or Social.</p>
+ *
+ * <h2>Page chrome</h2>
+ *
+ * <p>Unlike the sidebar presets, Mint draws no {@code pageBackgrounds}: the
+ * page is white and the two-column structure comes purely from the per-page
+ * weighted {@code addRow}. The reusable drawing — icon rows, skill bars — is
+ * delegated to {@link IconTextRow} and {@link SkillBar}; the preset only
+ * orchestrates page composition, section mapping, and the Awards / References
+ * grids (which are page-composition concerns local to this layout).</p>
+ */
+public final class MintEditorial {
+
+    /** Stable template identifier. */
+    public static final String ID = "mint-editorial";
+
+    /** Human-readable display name. */
+    public static final String DISPLAY_NAME = "Mint Editorial";
+
+    /** Recommended symmetric page margin (in points). */
+    public static final double RECOMMENDED_MARGIN = 48.0;
+
+    /** Sidebar column weight; main column gets {@code 1 - SIDEBAR_WEIGHT}. */
+    private static final double SIDEBAR_WEIGHT = 0.31;
+
+    /** Main column weight. */
+    private static final double MAIN_WEIGHT = 1.0 - SIDEBAR_WEIGHT;
+
+    /** Horizontal gap (points) between the sidebar and main columns. */
+    private static final double COLUMN_GAP = 40.0;
+
+    /**
+     * Vertical gap (points) between consecutive blocks within a column.
+     * Each block is wrapped in its own sub-section so this gap applies
+     * <em>between</em> blocks only — never between the leaf paragraphs /
+     * lines inside a block (whose rhythm is margin-driven). Flattening all
+     * leaves into one section would multiply this gap across every child
+     * and overflow the atomic page row.
+     */
+    private static final double BLOCK_GAP = 22.0;
+
+    /** Visual gap (points) between the two grid columns in Awards / References. */
+    private static final double GRID_COLUMN_GAP = 24.0;
+
+    /** Experience entries rendered on page 1; the rest go to page 2. */
+    private static final int EXPERIENCE_PAGE_ONE = 2;
+
+    /** Expertise category labels shown beneath the badge. */
+    private static final int EXPERTISE_LIMIT = 6;
+
+    /** Skill bars rendered in the page-2 sidebar. */
+    private static final int SKILL_LIMIT = 6;
+
+    /** Inline contact / social icon edge length (points). */
+    private static final double CONTACT_ICON_SIZE = 9.0;
+
+    /** Social icon edge length (points) — the filled badges read larger. */
+    private static final double SOCIAL_ICON_SIZE = 12.0;
+
+    /** Expertise badge edge length (points). */
+    private static final double BADGE_SIZE = 36.0;
+
+    private static final String ICON_ROOT = "/templates/cv/mint-editorial/icons/";
+    private static final Map<String, byte[]> ICON_CACHE = new ConcurrentHashMap<>();
+
+    private static final List<String> INTERESTS_KEYS =
+            List.of("interests", "interest");
+    private static final List<String> EDUCATION_KEYS =
+            List.of("education", "certifications");
+    private static final List<String> SKILL_KEYS =
+            List.of("skills", "technical skills", "expertise");
+    private static final List<String> SUMMARY_KEYS =
+            List.of("profile", "professional profile", "summary",
+                    "professional summary");
+    private static final List<String> EXPERIENCE_KEYS =
+            List.of("experience", "employment", "professional experience",
+                    "work");
+    private static final List<String> AWARDS_KEYS =
+            List.of("awards", "award", "honours", "honors");
+    private static final List<String> REFERENCES_KEYS =
+            List.of("references", "reference", "referees");
+
+    private MintEditorial() {
+    }
+
+    /** Builds the preset with its Mint Editorial theme. */
+    public static DocumentTemplate<CvDocument> create() {
+        return create(CvTheme.mintEditorial());
+    }
+
+    /**
+     * Builds the preset with a caller-supplied theme (share the paired
+     * cover letter's theme instance for a guaranteed visual match).
+     */
+    public static DocumentTemplate<CvDocument> create(CvTheme theme) {
+        Objects.requireNonNull(theme, "theme");
+        return new Template(theme);
+    }
+
+    private static final class Template implements DocumentTemplate<CvDocument> {
+
+        private final CvTheme theme;
+        private final DocumentColor accent;
+
+        Template(CvTheme theme) {
+            this.theme = theme;
+            // Mint carries its accent in the palette banner slot — single
+            // source shared with the paired cover letter.
+            this.accent = theme.palette().banner();
+        }
+
+        @Override
+        public String id() {
+            return ID;
+        }
+
+        @Override
+        public String displayName() {
+            return DISPLAY_NAME;
+        }
+
+        @Override
+        public void compose(DocumentSession document, CvDocument doc) {
+            Objects.requireNonNull(document, "document");
+            Objects.requireNonNull(doc, "doc");
+
+            double innerWidth = document.canvas().innerWidth();
+            double pageWidth = document.canvas().width();
+            // Bleed the masthead accent rule edge-to-edge: draw it at full
+            // page width with negative side margins that cancel the page
+            // margins, so the mint rule spans the whole page (matching the
+            // reference) instead of only the content column.
+            double ruleBleed = (pageWidth - innerWidth) / 2.0;
+            // Gap is subtracted before the weighted split (see
+            // NodeDefinitionSupport row measurement), so derive the column
+            // inner widths the same way for the skill-bar track and grids.
+            double usable = Math.max(0.0, innerWidth - COLUMN_GAP);
+            double sidebarInner = usable * SIDEBAR_WEIGHT;
+            double mainInner = usable * MAIN_WEIGHT;
+            double gridColumnWidth = mainInner / 2.0;
+
+            List<CvSection> sections = doc.sectionsIn(Slot.MAIN);
+            CvIdentity identity = doc.identity();
+
+            CvSection interests = SectionLookup.firstMatching(sections, INTERESTS_KEYS);
+            CvSection education = SectionLookup.firstMatching(sections, EDUCATION_KEYS);
+            CvSection skills = SectionLookup.firstMatching(sections, SKILL_KEYS);
+            CvSection profile = SectionLookup.firstMatching(sections, SUMMARY_KEYS);
+            CvSection experience = SectionLookup.firstMatching(sections, EXPERIENCE_KEYS);
+            CvSection awards = SectionLookup.firstMatching(sections, AWARDS_KEYS);
+            CvSection references = SectionLookup.firstMatching(sections, REFERENCES_KEYS);
+
+            List<CvEntry> experienceEntries = entriesOf(experience);
+            List<CvEntry> experiencePage1 = experienceEntries.stream()
+                    .limit(EXPERIENCE_PAGE_ONE).toList();
+            List<CvEntry> experiencePage2 = experienceEntries.stream()
+                    .skip(EXPERIENCE_PAGE_ONE).toList();
+
+            document.dsl()
+                    .pageFlow()
+                    .name("CvV2MintEditorialRoot")
+                    .spacing(theme.spacing().pageFlowSpacing())
+                    .addSection("CvV2MintEditorialHeader",
+                            section -> addHeader(section, identity))
+                    .addLine(line -> line
+                            .name("CvV2MintEditorialHeaderRule")
+                            .horizontal(pageWidth)
+                            .color(accent)
+                            .thickness(theme.spacing().accentRuleWidth())
+                            .margin(new DocumentInsets(8, -ruleBleed, 14, -ruleBleed)))
+                    .addRow("CvV2MintEditorialPageOne", row -> {
+                        row.spacing(COLUMN_GAP).weights(SIDEBAR_WEIGHT, MAIN_WEIGHT);
+                        row.addSection("CvV2MintEditorialPageOneSidebar", sidebar -> {
+                            sidebar.spacing(BLOCK_GAP).padding(DocumentInsets.zero());
+                            addContact(sidebar, identity);
+                            addInterests(sidebar, interests);
+                            addEducation(sidebar, education);
+                        });
+                        row.addSection("CvV2MintEditorialPageOneMain", main -> {
+                            main.spacing(BLOCK_GAP).padding(DocumentInsets.zero());
+                            addProfile(main, profile);
+                            addExperience(main, "Experience", experiencePage1);
+                        });
+                    })
+                    .addRow("CvV2MintEditorialPageTwo", row -> {
+                        row.spacing(COLUMN_GAP).weights(SIDEBAR_WEIGHT, MAIN_WEIGHT);
+                        row.addSection("CvV2MintEditorialPageTwoSidebar", sidebar -> {
+                            sidebar.spacing(BLOCK_GAP).padding(DocumentInsets.zero());
+                            addExpertise(sidebar, skills);
+                            addSkills(sidebar, skills, sidebarInner);
+                            addSocial(sidebar, identity);
+                        });
+                        row.addSection("CvV2MintEditorialPageTwoMain", main -> {
+                            main.spacing(BLOCK_GAP).padding(DocumentInsets.zero());
+                            addExperience(main, "Experience", experiencePage2);
+                            addAwards(main, awards, gridColumnWidth);
+                            addReferences(main, references, gridColumnWidth);
+                        });
+                    })
+                    .build();
+        }
+
+        // -- Header --------------------------------------------------------
+
+        private void addHeader(SectionBuilder section, CvIdentity identity) {
+            // Headline.spacedCentered sets the section's spacing + padding;
+            // it renders the centred spaced-caps name as the page's loudest
+            // element. The tagline follows in the mint accent.
+            Headline.spacedCentered(section, identity.name(), theme);
+            String jobTitle = identity.jobTitle();
+            if (jobTitle != null && !jobTitle.isBlank()) {
+                Subheadline.centeredSpacedCaps(section, jobTitle, taglineStyle());
+            }
+        }
+
+        // -- Sidebar: Contact ---------------------------------------------
+
+        private void addContact(SectionBuilder section, CvIdentity identity) {
+            section.addSection("CvV2MintEditorialContact", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, "Contact");
+                DocumentTextStyle style = contactStyle();
+                String phone = identity.contact().phone();
+                if (!phone.isBlank()) {
+                    IconTextRow.render(block, icon("phone.png"), CONTACT_ICON_SIZE,
+                            phone, style, null, DocumentInsets.bottom(13));
+                }
+                String email = identity.contact().email();
+                if (!email.isBlank()) {
+                    IconTextRow.render(block, icon("email.png"), CONTACT_ICON_SIZE,
+                            email, style, new DocumentLinkOptions("mailto:" + email),
+                            DocumentInsets.bottom(13));
+                }
+                String address = identity.contact().address();
+                if (!address.isBlank()) {
+                    IconTextRow.render(block, icon("location.png"), CONTACT_ICON_SIZE,
+                            address, style, null, DocumentInsets.bottom(13));
+                }
+                for (CvLink link : identity.links()) {
+                    if (link.label().isBlank()) {
+                        continue;
+                    }
+                    DocumentLinkOptions options = link.url().isBlank()
+                            ? null
+                            : new DocumentLinkOptions(link.url().trim());
+                    IconTextRow.render(block, icon(contactIconFile(link.label())),
+                            CONTACT_ICON_SIZE, link.label(), style, options,
+                            DocumentInsets.bottom(13));
+                }
+            });
+        }
+
+        // -- Sidebar: Interests -------------------------------------------
+
+        private void addInterests(SectionBuilder section, CvSection interests) {
+            if (!(interests instanceof RowsSection rows) || rows.rows().isEmpty()) {
+                return;
+            }
+            section.addSection("CvV2MintEditorialInterests", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, interests.title());
+                for (CvRow row : rows.rows()) {
+                    addLabel(block, MarkdownInline.plainText(row.label()));
+                }
+            });
+        }
+
+        // -- Sidebar: Education -------------------------------------------
+
+        private void addEducation(SectionBuilder section, CvSection education) {
+            List<CvEntry> entries = entriesOf(education);
+            if (entries.isEmpty()) {
+                return;
+            }
+            section.addSection("CvV2MintEditorialEducation", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, education.title());
+                DocumentTextStyle degreeStyle = labelStyle();
+                DocumentTextStyle metaStyle = smallStyle();
+                for (CvEntry entry : entries) {
+                    block.addParagraph(p -> p
+                            .text(TextOrnaments.spacedUpper(
+                                    MarkdownInline.plainText(entry.title())))
+                            .textStyle(degreeStyle)
+                            .align(TextAlign.LEFT)
+                            .margin(DocumentInsets.bottom(5)));
+                    if (!entry.subtitle().isBlank()) {
+                        block.addParagraph(p -> p
+                                .text(MarkdownInline.plainText(entry.subtitle()))
+                                .textStyle(metaStyle)
+                                .align(TextAlign.LEFT)
+                                .margin(DocumentInsets.bottom(5)));
+                    }
+                    if (!entry.date().isBlank()) {
+                        block.addParagraph(p -> p
+                                .text(MarkdownInline.plainText(entry.date()))
+                                .textStyle(metaStyle)
+                                .align(TextAlign.LEFT)
+                                .margin(DocumentInsets.bottom(20)));
+                    }
+                }
+            });
+        }
+
+        // -- Sidebar: Expertise -------------------------------------------
+
+        private void addExpertise(SectionBuilder section, CvSection skills) {
+            if (!(skills instanceof SkillsSection skillsSection)) {
+                return;
+            }
+            List<String> categories = new ArrayList<>();
+            for (SkillGroup group : skillsSection.groups()) {
+                if (!group.category().isBlank()) {
+                    categories.add(group.category());
+                }
+            }
+            if (categories.isEmpty()) {
+                return;
+            }
+            section.addSection("CvV2MintEditorialExpertise", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, "Expertise");
+                block.addImage(image -> image
+                        .name("CvV2MintEditorialExpertiseBadge")
+                        .source(icon("expertise-badge.png"))
+                        .size(BADGE_SIZE, BADGE_SIZE)
+                        .margin(DocumentInsets.bottom(18)));
+                for (String category : categories.stream().limit(EXPERTISE_LIMIT).toList()) {
+                    addLabel(block, category);
+                }
+            });
+        }
+
+        // -- Sidebar: Skills (bars) ---------------------------------------
+
+        private void addSkills(SectionBuilder section, CvSection skills,
+                               double trackWidth) {
+            if (!(skills instanceof SkillsSection skillsSection)) {
+                return;
+            }
+            List<CvSkill> flattened = new ArrayList<>();
+            for (SkillGroup group : skillsSection.groups()) {
+                flattened.addAll(group.entries());
+            }
+            if (flattened.isEmpty()) {
+                return;
+            }
+            section.addSection("CvV2MintEditorialSkills", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, "Skills");
+                for (CvSkill skill : flattened.stream().limit(SKILL_LIMIT).toList()) {
+                    SkillBar.render(block, skill, trackWidth, theme);
+                }
+            });
+        }
+
+        // -- Sidebar: Social ----------------------------------------------
+
+        private void addSocial(SectionBuilder section, CvIdentity identity) {
+            if (identity.links().isEmpty()) {
+                return;
+            }
+            section.addSection("CvV2MintEditorialSocial", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, "Social");
+                DocumentTextStyle style = labelStyle();
+                for (CvLink link : identity.links()) {
+                    if (link.label().isBlank()) {
+                        continue;
+                    }
+                    DocumentLinkOptions options = link.url().isBlank()
+                            ? null
+                            : new DocumentLinkOptions(link.url().trim());
+                    IconTextRow.render(block, icon(socialIconFile(link.label())),
+                            SOCIAL_ICON_SIZE, link.label(), style, options,
+                            DocumentInsets.bottom(11));
+                }
+            });
+        }
+
+        // -- Main: Profile -------------------------------------------------
+
+        private void addProfile(SectionBuilder section, CvSection profile) {
+            if (!(profile instanceof ParagraphSection paragraph)
+                    || paragraph.body().isBlank()) {
+                return;
+            }
+            section.addSection("CvV2MintEditorialProfile", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, "Profile");
+                DocumentTextStyle bodyStyle = bodyStyle();
+                block.addParagraph(p -> p
+                        .textStyle(bodyStyle)
+                        .lineSpacing(theme.typography().bodyLineSpacing())
+                        .align(TextAlign.LEFT)
+                        .margin(DocumentInsets.bottom(12))
+                        .rich(rich -> MarkdownInline.appendTrimmed(rich,
+                                paragraph.body(), bodyStyle)));
+            });
+        }
+
+        // -- Main: Experience ---------------------------------------------
+
+        private void addExperience(SectionBuilder section, String title,
+                                   List<CvEntry> entries) {
+            if (entries.isEmpty()) {
+                return;
+            }
+            section.addSection("CvV2MintEditorialExperience", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, title);
+                DocumentTextStyle titleStyle = labelStyle();
+                DocumentTextStyle metaStyle = smallStyle();
+                DocumentTextStyle bodyStyle = bodyStyle();
+                for (CvEntry entry : entries) {
+                    block.addParagraph(p -> p
+                            .text(TextOrnaments.spacedUpper(
+                                    MarkdownInline.plainText(entry.title())))
+                            .textStyle(titleStyle)
+                            .align(TextAlign.LEFT)
+                            .margin(DocumentInsets.bottom(5)));
+                    String meta = composeMeta(entry);
+                    if (!meta.isBlank()) {
+                        block.addParagraph(p -> p
+                                .text(meta)
+                                .textStyle(metaStyle)
+                                .align(TextAlign.LEFT)
+                                .margin(DocumentInsets.bottom(8)));
+                    }
+                    // The body may carry trailing markdown bullet lines
+                    // ("- highlight"). Render the prose part as a paragraph
+                    // and the bullet lines as a real bullet list. Bodies
+                    // without bullet lines (the canonical sample) take the
+                    // plain-paragraph path unchanged.
+                    BodyParts parts = splitBody(entry.body());
+                    boolean hasBullets = !parts.bullets().isEmpty();
+                    if (!parts.prose().isBlank()) {
+                        block.addParagraph(p -> p
+                                .textStyle(bodyStyle)
+                                .lineSpacing(theme.typography().bodyLineSpacing())
+                                .align(TextAlign.LEFT)
+                                .margin(DocumentInsets.bottom(hasBullets ? 6 : 18))
+                                .rich(rich -> MarkdownInline.appendTrimmed(rich,
+                                        parts.prose(), bodyStyle)));
+                    }
+                    if (hasBullets) {
+                        block.addList(list -> list
+                                .bullet()
+                                .items(parts.bullets())
+                                .textStyle(smallStyle())
+                                .lineSpacing(theme.typography().bodyLineSpacing())
+                                .margin(new DocumentInsets(0, 0, 18, 12)));
+                    }
+                }
+            });
+        }
+
+        // -- Main: Awards (2-col grid) ------------------------------------
+
+        private void addAwards(SectionBuilder section, CvSection awards,
+                               double gridColumnWidth) {
+            if (!(awards instanceof RowsSection rows) || rows.rows().isEmpty()) {
+                return;
+            }
+            List<CvRow> entries = rows.rows();
+            DocumentTableStyle nameLeft = cellStyle(labelStyle(), 4, GRID_COLUMN_GAP);
+            DocumentTableStyle nameRight = cellStyle(labelStyle(), 4, 0);
+            DocumentTableStyle metaLeft = cellStyle(smallStyle(), 18, GRID_COLUMN_GAP);
+            DocumentTableStyle metaRight = cellStyle(smallStyle(), 18, 0);
+            DocumentTableStyle metaLeftLast = cellStyle(smallStyle(), 0, GRID_COLUMN_GAP);
+            DocumentTableStyle metaRightLast = cellStyle(smallStyle(), 0, 0);
+
+            section.addSection("CvV2MintEditorialAwards", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, awards.title());
+                block.addTable(table -> {
+                    table.name("CvV2MintEditorialAwardsGrid")
+                            .columns(DocumentTableColumn.fixed(gridColumnWidth),
+                                    DocumentTableColumn.fixed(gridColumnWidth))
+                            .padding(DocumentInsets.zero())
+                            .margin(DocumentInsets.zero());
+                    int pairs = (entries.size() + 1) / 2;
+                    for (int pairIndex = 0; pairIndex < pairs; pairIndex++) {
+                        CvRow left = entries.get(pairIndex * 2);
+                        CvRow right = pairIndex * 2 + 1 < entries.size()
+                                ? entries.get(pairIndex * 2 + 1)
+                                : null;
+                        boolean lastPair = pairIndex == pairs - 1;
+                        table.rowCells(
+                                gridCell(TextOrnaments.spacedUpper(
+                                        MarkdownInline.plainText(left.label())), nameLeft),
+                                gridCell(right == null ? "" : TextOrnaments.spacedUpper(
+                                        MarkdownInline.plainText(right.label())), nameRight));
+                        table.rowCells(
+                                gridCell(MarkdownInline.plainText(left.body()),
+                                        lastPair ? metaLeftLast : metaLeft),
+                                gridCell(right == null ? "" : MarkdownInline.plainText(right.body()),
+                                        lastPair ? metaRightLast : metaRight));
+                    }
+                });
+            });
+        }
+
+        // -- Main: References (2-col grid) --------------------------------
+
+        private void addReferences(SectionBuilder section, CvSection references,
+                                   double gridColumnWidth) {
+            if (!(references instanceof RowsSection rows) || rows.rows().isEmpty()) {
+                return;
+            }
+            List<CvRow> entries = rows.rows();
+            DocumentTableStyle nameLeft = cellStyle(labelStyle(), 4, GRID_COLUMN_GAP);
+            DocumentTableStyle nameRight = cellStyle(labelStyle(), 4, 0);
+            DocumentTableStyle subLeft = cellStyle(smallStyle(), 3, GRID_COLUMN_GAP);
+            DocumentTableStyle subRight = cellStyle(smallStyle(), 3, 0);
+            DocumentTableStyle lastLeft = cellStyle(smallStyle(), 18, GRID_COLUMN_GAP);
+            DocumentTableStyle lastRight = cellStyle(smallStyle(), 18, 0);
+            DocumentTableStyle lastLeftEnd = cellStyle(smallStyle(), 0, GRID_COLUMN_GAP);
+            DocumentTableStyle lastRightEnd = cellStyle(smallStyle(), 0, 0);
+
+            section.addSection("CvV2MintEditorialReferences", block -> {
+                block.spacing(0).padding(DocumentInsets.zero());
+                addBlockHeading(block, references.title());
+                block.addTable(table -> {
+                    table.name("CvV2MintEditorialReferencesGrid")
+                            .columns(DocumentTableColumn.fixed(gridColumnWidth),
+                                    DocumentTableColumn.fixed(gridColumnWidth))
+                            .padding(DocumentInsets.zero())
+                            .margin(DocumentInsets.zero());
+                    int pairs = (entries.size() + 1) / 2;
+                    for (int pairIndex = 0; pairIndex < pairs; pairIndex++) {
+                        CvRow left = entries.get(pairIndex * 2);
+                        CvRow right = pairIndex * 2 + 1 < entries.size()
+                                ? entries.get(pairIndex * 2 + 1)
+                                : null;
+                        boolean lastPair = pairIndex == pairs - 1;
+                        // Name row (spaced-caps bold).
+                        table.rowCells(
+                                gridCell(TextOrnaments.spacedUpper(
+                                        MarkdownInline.plainText(left.label())), nameLeft),
+                                gridCell(right == null ? "" : TextOrnaments.spacedUpper(
+                                        MarkdownInline.plainText(right.label())), nameRight));
+                        // One table row per body line (Company / "P: phone" /
+                        // email). The email line becomes a clickable mailto via
+                        // a composed ParagraphNode cell — the working
+                        // composed-cell shape on the PDF backend (paragraph
+                        // cells render; section cells do not).
+                        List<String> leftLines = bodyLines(left);
+                        List<String> rightLines = right == null
+                                ? List.of() : bodyLines(right);
+                        int lineRows = Math.max(leftLines.size(), rightLines.size());
+                        for (int i = 0; i < lineRows; i++) {
+                            boolean lastLine = i == lineRows - 1;
+                            DocumentTableStyle leftStyle = lastLine
+                                    ? (lastPair ? lastLeftEnd : lastLeft) : subLeft;
+                            DocumentTableStyle rightStyle = lastLine
+                                    ? (lastPair ? lastRightEnd : lastRight) : subRight;
+                            table.rowCells(
+                                    referenceLineCell(
+                                            i < leftLines.size() ? leftLines.get(i) : "",
+                                            leftStyle),
+                                    referenceLineCell(
+                                            i < rightLines.size() ? rightLines.get(i) : "",
+                                            rightStyle));
+                        }
+                    }
+                });
+            });
+        }
+
+        private List<String> bodyLines(CvRow row) {
+            List<String> out = new ArrayList<>();
+            for (String raw : row.body().split("\\R")) {
+                String line = MarkdownInline.plainText(raw).strip();
+                if (!line.isBlank()) {
+                    out.add(line);
+                }
+            }
+            return out;
+        }
+
+        /**
+         * Builds a single reference detail cell. A line that contains an
+         * email becomes a clickable {@code mailto:} link via a composed
+         * {@link com.demcha.compose.document.node.ParagraphNode} cell (the
+         * working composed-cell shape on the PDF backend); every other line
+         * is a plain text cell.
+         */
+        private DocumentTableCell referenceLineCell(String line,
+                                                    DocumentTableStyle cellStyle) {
+            if (line == null || line.isBlank()) {
+                return gridCell("", cellStyle);
+            }
+            String email = extractEmail(line);
+            if (email == null) {
+                return gridCell(line, cellStyle);
+            }
+            DocumentLinkOptions link = new DocumentLinkOptions("mailto:" + email);
+            DocumentTextStyle linkStyle = CvTextStyles.of(
+                    theme.typography().bodyFont(),
+                    theme.typography().sizeEntryDate(),
+                    DocumentTextDecoration.UNDERLINE, theme.palette().muted());
+            ParagraphNode linked = new ParagraphBuilder()
+                    .name("CvV2MintEditorialReferenceEmail")
+                    .align(TextAlign.LEFT)
+                    .inlineText(line, linkStyle, link)
+                    .build();
+            return DocumentTableCell.node(linked).withStyle(cellStyle);
+        }
+
+        // -- Shared block heading (spaced-caps accent title) --------------
+
+        private void addBlockHeading(SectionBuilder block, String title) {
+            if (title == null || title.isBlank()) {
+                return;
+            }
+            block.addParagraph(p -> p
+                    .text(TextOrnaments.spacedUpper(title))
+                    .textStyle(headingStyle())
+                    .align(TextAlign.LEFT)
+                    .margin(DocumentInsets.bottom(18)));
+        }
+
+        private void addLabel(SectionBuilder section, String text) {
+            if (text == null || text.isBlank()) {
+                return;
+            }
+            section.addParagraph(p -> p
+                    .text(TextOrnaments.spacedUpper(text))
+                    .textStyle(labelStyle())
+                    .align(TextAlign.LEFT)
+                    .margin(DocumentInsets.bottom(14)));
+        }
+
+        private DocumentTableCell gridCell(String text, DocumentTableStyle style) {
+            return DocumentTableCell.text(text == null ? "" : text).withStyle(style);
+        }
+
+        // -- Style factories ----------------------------------------------
+
+        private DocumentTextStyle taglineStyle() {
+            return CvTextStyles.of(theme.typography().headlineFont(),
+                    theme.typography().sizeContact(),
+                    DocumentTextDecoration.BOLD, accent);
+        }
+
+        private DocumentTextStyle headingStyle() {
+            return CvTextStyles.of(theme.typography().headlineFont(),
+                    theme.typography().sizeBanner(),
+                    DocumentTextDecoration.BOLD, accent);
+        }
+
+        private DocumentTextStyle labelStyle() {
+            return CvTextStyles.of(theme.typography().bodyFont(),
+                    theme.typography().sizeEntryTitle(),
+                    DocumentTextDecoration.BOLD, theme.palette().ink());
+        }
+
+        private DocumentTextStyle bodyStyle() {
+            return CvTextStyles.of(theme.typography().bodyFont(),
+                    theme.typography().sizeBody(),
+                    DocumentTextDecoration.DEFAULT, theme.palette().ink());
+        }
+
+        private DocumentTextStyle contactStyle() {
+            return CvTextStyles.of(theme.typography().bodyFont(),
+                    theme.typography().sizeContact(),
+                    DocumentTextDecoration.DEFAULT, theme.palette().muted());
+        }
+
+        private DocumentTextStyle smallStyle() {
+            return CvTextStyles.of(theme.typography().bodyFont(),
+                    theme.typography().sizeEntryDate(),
+                    DocumentTextDecoration.DEFAULT, theme.palette().muted());
+        }
+
+        /**
+         * No-border, no-fill table cell style — a zero-width white stroke
+         * and a white fill suppress the engine's default 1pt black cell
+         * border. {@code rightPadding} drives the inter-column gap on the
+         * left column only (keep the right column at zero).
+         */
+        private DocumentTableStyle cellStyle(DocumentTextStyle textStyle,
+                                             double bottomPadding,
+                                             double rightPadding) {
+            return DocumentTableStyle.builder()
+                    .textStyle(textStyle)
+                    .padding(new DocumentInsets(0, rightPadding, bottomPadding, 0))
+                    .stroke(DocumentStroke.of(DocumentColor.WHITE, 0))
+                    .fillColor(DocumentColor.WHITE)
+                    .build();
+        }
+
+        private DocumentImageData icon(String fileName) {
+            return DocumentImageData.fromBytes(
+                    ICON_CACHE.computeIfAbsent(ICON_ROOT + fileName,
+                            MintEditorial::readIconBytes));
+        }
+    }
+
+    // -- Static helpers ----------------------------------------------------
+
+    private static String composeMeta(CvEntry entry) {
+        String subtitle = MarkdownInline.plainText(entry.subtitle());
+        String date = MarkdownInline.plainText(entry.date());
+        if (subtitle.isBlank()) {
+            return date;
+        }
+        if (date.isBlank()) {
+            return subtitle;
+        }
+        return subtitle + " | " + date;
+    }
+
+    private static List<CvEntry> entriesOf(CvSection section) {
+        if (section instanceof EntriesSection entries) {
+            return entries.entries();
+        }
+        return List.of();
+    }
+
+    /**
+     * Splits an experience body into a leading prose block and trailing
+     * markdown bullet lines (lines beginning with {@code "- "} or
+     * {@code "* "}). Bodies with no bullet lines yield the whole text as
+     * prose and an empty bullet list, so the canonical sample renders
+     * exactly as before.
+     */
+    private static BodyParts splitBody(String body) {
+        if (body == null || body.isBlank()) {
+            return new BodyParts("", List.of());
+        }
+        List<String> prose = new ArrayList<>();
+        List<String> bullets = new ArrayList<>();
+        for (String rawLine : body.split("\\R")) {
+            String line = rawLine.strip();
+            if (line.startsWith("- ") || line.startsWith("* ")) {
+                String item = line.substring(2).strip();
+                if (!item.isBlank()) {
+                    bullets.add(item);
+                }
+            } else if (!line.isBlank()) {
+                prose.add(line);
+            }
+        }
+        return new BodyParts(String.join(" ", prose), List.copyOf(bullets));
+    }
+
+    /** Prose + bullet split of an experience entry body. */
+    private record BodyParts(String prose, List<String> bullets) {
+    }
+
+    /**
+     * Returns the bare email address contained in {@code line} (e.g. the
+     * {@code "hello@email.com"} inside {@code "E: hello@email.com"}), or
+     * {@code null} when the line carries no email-shaped token.
+     */
+    private static String extractEmail(String line) {
+        if (line == null) {
+            return null;
+        }
+        for (String token : line.split("\\s+")) {
+            int at = token.indexOf('@');
+            if (at > 0 && token.indexOf('.', at) > at + 1) {
+                return token;
+            }
+        }
+        return null;
+    }
+
+    /** Maps a contact link label to its small inline glyph file. */
+    private static String contactIconFile(String label) {
+        String normalized = SectionLookup.normalize(label);
+        if (normalized.contains("linkedin")) {
+            return "linkedin.png";
+        }
+        if (normalized.contains("twitter")) {
+            return "twitter.png";
+        }
+        if (normalized.contains("facebook")) {
+            return "facebook.png";
+        }
+        if (normalized.contains("pinterest")) {
+            return "pinterest.png";
+        }
+        // GitHub, portfolio, personal site, etc. → the globe glyph.
+        return "website.png";
+    }
+
+    /** Maps a social link label to its filled-badge glyph file. */
+    private static String socialIconFile(String label) {
+        String normalized = SectionLookup.normalize(label);
+        if (normalized.contains("twitter")) {
+            return "twitter.png";
+        }
+        if (normalized.contains("facebook")) {
+            return "facebook.png";
+        }
+        if (normalized.contains("pinterest")) {
+            return "pinterest.png";
+        }
+        if (normalized.contains("linkedin")) {
+            return "linkedin.png";
+        }
+        // GitHub, portfolio, personal site, etc. → the globe glyph.
+        return "website.png";
+    }
+
+    private static byte[] readIconBytes(String resourcePath) {
+        try (InputStream input = MintEditorial.class
+                .getResourceAsStream(resourcePath)) {
+            if (input == null) {
+                throw new IllegalStateException(
+                        "Missing mint editorial icon: " + resourcePath);
+            }
+            return input.readAllBytes();
+        } catch (IOException e) {
+            throw new UncheckedIOException(
+                    "Failed to read mint editorial icon: " + resourcePath, e);
+        }
+    }
+}
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvPalette.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvPalette.java
index 56bd2f0c..743155d3 100644
--- a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvPalette.java
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvPalette.java
@@ -243,4 +243,22 @@ public static CvPalette executive() {
                 DocumentColor.rgb(193, 201, 211),  // rule — V1 MUTED_RULE
                 DocumentColor.rgb(220, 226, 230)); // banner — unused, inherits classic
     }
+
+    /**
+     * Mint Editorial palette: near-black ink, mid-grey metadata,
+     * dark-grey skill-bar rules, and a soft mint accent. The
+     * {@code banner} slot carries the mint accent (rgb(139,207,190)) —
+     * Mint draws no banner panels, so it reuses the slot for the accent
+     * the way the sidebar presets reuse it for the sidebar fill. Both
+     * the CV preset and its paired cover letter read
+     * {@code palette.banner()} as the single accent source, so the
+     * matched set never forks the colour.
+     */
+    public static CvPalette mintEditorial() {
+        return new CvPalette(
+                DocumentColor.rgb(24, 24, 24),     // ink (black)
+                DocumentColor.rgb(82, 82, 82),     // muted
+                DocumentColor.rgb(70, 70, 70),     // rule (skill-bar track)
+                DocumentColor.rgb(139, 207, 190)); // banner — reused as mint accent
+    }
 }
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvSpacing.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvSpacing.java
index 03ab942c..f9c38c3a 100644
--- a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvSpacing.java
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvSpacing.java
@@ -424,4 +424,30 @@ public static CvSpacing executive() {
                 0.45,                                    // entryDateWeight
                 3.0);                                    // entrySeparation
     }
+
+    /**
+     * Spacing for the Mint Editorial preset: a measured editorial flow
+     * with a thick (6pt) full-width mint accent rule under the centered
+     * masthead, generous separation between experience entries, and
+     * tight section bodies. The two-column sidebar/main split and its
+     * column gap are page-composition concerns owned by the preset, not
+     * spacing tokens.
+     */
+    public static CvSpacing mintEditorial() {
+        return new CvSpacing(
+                18,                                      // pageFlowSpacing (header / rule / grid rhythm)
+                5,                                       // sectionBodySpacing
+                DocumentInsets.zero(),                   // sectionBodyPadding
+                DocumentInsets.zero(),                   // headlinePadding (header section owns its spacing)
+                DocumentInsets.zero(),                   // contactPadding
+                0.0,                                     // bannerCornerRadius (unused — no banners)
+                0.0,                                     // bannerInnerPadding (unused)
+                DocumentInsets.zero(),                   // bannerMargin (unused)
+                6.0,                                     // accentRuleWidth (thick mint masthead rule)
+                2.0,                                     // paragraphMarginTop
+                8.0,                                     // entryHeaderRowSpacing
+                1.0,                                     // entryTitleWeight
+                0.45,                                    // entryDateWeight
+                12.0);                                   // entrySeparation (roomy editorial gap)
+    }
 }
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTheme.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTheme.java
index 5d53b6ec..7f866831 100644
--- a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTheme.java
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTheme.java
@@ -263,6 +263,24 @@ public static CvTheme executive() {
                 CvSpacing.executive(),
                 CvDecoration.classic());
     }
+
+    /**
+     * The "Mint Editorial" look — Poppins throughout, near-black ink, a
+     * soft mint accent (carried in the palette {@code banner} slot) used
+     * for the full-width masthead rule, the spaced-caps section
+     * headings, and the centered tagline. Two-page two-column editorial
+     * CV: a left sidebar (contact, interests, education, expertise,
+     * skill bars, social) beside a main column (profile, experience,
+     * awards, references). Paired 1:1 with the Mint Editorial cover
+     * letter, which reuses this exact theme.
+     */
+    public static CvTheme mintEditorial() {
+        return new CvTheme(
+                CvPalette.mintEditorial(),
+                CvTypography.mintEditorial(),
+                CvSpacing.mintEditorial(),
+                CvDecoration.classic());
+    }
     // -- pre-built text-style helpers ------------------------------------
     // Renderers ask the theme for an already-composed DocumentTextStyle
     // instead of re-assembling font + size + decoration + colour every
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTypography.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTypography.java
index 538ce668..8d053584 100644
--- a/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTypography.java
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/theme/CvTypography.java
@@ -310,4 +310,23 @@ public static CvTypography executive() {
                 9.5,     // body (V1 BODY_SIZE)
                 1.25);   // line spacing
     }
+
+    /**
+     * Poppins headline + body scale for the Mint Editorial preset: a
+     * 26pt spaced-caps centered name, an 11pt spaced-caps accent section
+     * heading, and compact 7.4-8pt metadata/body tuned for the dense
+     * two-column editorial layout.
+     */
+    public static CvTypography mintEditorial() {
+        return new CvTypography(
+                FontName.POPPINS, FontName.POPPINS,
+                26.0,    // headline (spaced-caps centered name)
+                7.4,     // contact (icon line text)
+                11.0,    // banner (spaced-caps accent section heading)
+                8.0,     // entry title (job title / degree label)
+                7.4,     // entry date (meta)
+                7.4,     // entry subtitle (school / company)
+                8.0,     // body (profile / experience)
+                1.3);    // line spacing
+    }
 }
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/widgets/IconTextRow.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/widgets/IconTextRow.java
new file mode 100644
index 00000000..0ad816ff
--- /dev/null
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/widgets/IconTextRow.java
@@ -0,0 +1,92 @@
+package com.demcha.compose.document.templates.cv.v2.widgets;
+
+import com.demcha.compose.document.dsl.SectionBuilder;
+import com.demcha.compose.document.image.DocumentImageData;
+import com.demcha.compose.document.node.DocumentLinkOptions;
+import com.demcha.compose.document.node.InlineImageAlignment;
+import com.demcha.compose.document.node.TextAlign;
+import com.demcha.compose.document.style.DocumentInsets;
+import com.demcha.compose.document.style.DocumentTextStyle;
+
+import java.util.Objects;
+
+/**
+ * Inline icon-plus-text row widget — a small glyph image followed by a
+ * label on the same baseline, optionally wrapped as a single click target.
+ *
+ * <h2>What it renders</h2>
+ *
+ * <p>One left-aligned paragraph holding two inline runs: a centred inline
+ * image of {@code iconSize}×{@code iconSize}, then three spaces and the
+ * label text. When a {@link DocumentLinkOptions} is supplied it is applied
+ * to <strong>both</strong> the image run and the text run, so the whole row
+ * (icon + label) is one clickable rectangle in the PDF — mirroring the flat
+ * Mint Editorial blueprint's {@code iconLine()} contact / social rows.</p>
+ *
+ * <h2>When to use</h2>
+ *
+ * <p>Reach for {@code IconTextRow} when a sidebar stacks contact details or
+ * social links as PNG-glyph rows (phone / email / location / website /
+ * LinkedIn …) where each entire row should be clickable. It differs from the
+ * shared {@code ContactLine} variants — those assume pipe-separated text or a
+ * stacked link list with no per-row glyph — so this is the icon-driven row
+ * primitive those widgets do not cover.</p>
+ *
+ * <h2>Reuse</h2>
+ *
+ * <p>Lives in {@code cv/v2/widgets} as a CV-sidebar primitive. Mint Editorial
+ * is the first consumer; any future CV preset that wants icon-led contact or
+ * social rows with a full-row click target can reuse it instead of inlining
+ * the inline-image + link paragraph again.</p>
+ */
+public final class IconTextRow {
+
+    /** Spacer between the icon glyph and the label text. */
+    private static final String GAP = "   ";
+
+    private IconTextRow() {
+    }
+
+    /**
+     * Renders an icon + text row.
+     *
+     * @param host     host section the row paragraph is appended to
+     * @param icon     glyph image payload (already decoded / cached by the
+     *                 caller); when {@code null} the row renders text only
+     * @param iconSize icon edge length in points (width == height)
+     * @param text     label text rendered after the icon; a blank label
+     *                 still renders the icon, so callers should skip empty
+     *                 rows upstream if that is unwanted
+     * @param style    text style for the label
+     * @param link     optional link wrapping the whole row (icon + label);
+     *                 {@code null} renders a non-clickable row
+     * @param margin   paragraph margin (vertical rhythm between rows)
+     */
+    public static void render(SectionBuilder host, DocumentImageData icon,
+                              double iconSize, String text,
+                              DocumentTextStyle style, DocumentLinkOptions link,
+                              DocumentInsets margin) {
+        Objects.requireNonNull(host, "host");
+        Objects.requireNonNull(style, "style");
+        String label = text == null ? "" : text;
+        DocumentInsets rowMargin = margin == null ? DocumentInsets.zero() : margin;
+
+        host.addParagraph(paragraph -> {
+            paragraph.textStyle(style)
+                    .align(TextAlign.LEFT)
+                    .link(link)
+                    .margin(rowMargin)
+                    .rich(rich -> {
+                        if (icon != null) {
+                            rich.image(icon, iconSize, iconSize,
+                                    InlineImageAlignment.CENTER, 0.0, link);
+                        }
+                        if (link != null) {
+                            rich.link(GAP + label, link);
+                        } else {
+                            rich.style(GAP + label, style);
+                        }
+                    });
+        });
+    }
+}
diff --git a/src/main/java/com/demcha/compose/document/templates/cv/v2/widgets/SkillBar.java b/src/main/java/com/demcha/compose/document/templates/cv/v2/widgets/SkillBar.java
new file mode 100644
index 00000000..e60d7629
--- /dev/null
+++ b/src/main/java/com/demcha/compose/document/templates/cv/v2/widgets/SkillBar.java
@@ -0,0 +1,134 @@
+package com.demcha.compose.document.templates.cv.v2.widgets;
+
+import com.demcha.compose.document.dsl.SectionBuilder;
+import com.demcha.compose.document.node.TextAlign;
+import com.demcha.compose.document.style.DocumentInsets;
+import com.demcha.compose.document.style.DocumentTextDecoration;
+import com.demcha.compose.document.style.DocumentTextStyle;
+import com.demcha.compose.document.templates.cv.v2.components.CvTextStyles;
+import com.demcha.compose.document.templates.cv.v2.components.TextOrnaments;
+import com.demcha.compose.document.templates.cv.v2.data.CvSkill;
+import com.demcha.compose.document.templates.cv.v2.theme.CvTheme;
+
+import java.util.Objects;
+
+/**
+ * Data-driven proficiency-bar widget — a spaced-caps skill label above a
+ * thin full-width track with a short vertical marker positioned by the
+ * skill's proficiency level.
+ *
+ * <h2>What it renders</h2>
+ *
+ * <p>Two stacked elements:</p>
+ *
+ * <ol>
+ *   <li>the skill name in letter-spaced uppercase (bold, ink), via
+ *       {@link TextOrnaments#spacedUpper(String)};</li>
+ *   <li>a horizontal track line spanning {@code trackWidth} in the theme
+ *       rule colour, overlaid with a short vertical marker (ink) whose
+ *       left offset is {@code level * trackWidth} — so a higher
+ *       proficiency pushes the tick further right.</li>
+ * </ol>
+ *
+ * <p>The marker is drawn as a second {@code addLine} immediately after the
+ * track, pulled back up over the track with a negative top margin and
+ * shifted right with a left margin of {@code level * trackWidth}. This is
+ * the same overlay trick the flat Mint Editorial blueprint used for its
+ * {@code skillBar()} (track 0.65pt rule, marker 1.2pt ink, ~8pt tall).</p>
+ *
+ * <h2>When to use</h2>
+ *
+ * <p>Reach for {@code SkillBar} when a preset renders skills as visual
+ * meters rather than plain labels or comma-separated chips — the editorial
+ * sidebar look. It reads the proficiency from {@link CvSkill#level()}: when
+ * the level is empty the label renders <strong>with no bar</strong> (so a
+ * mixed list of levelled and name-only skills degrades gracefully instead of
+ * drawing a meaningless empty track).</p>
+ *
+ * <h2>Reuse</h2>
+ *
+ * <p>Lives in {@code cv/v2/widgets} because a proficiency meter keyed off
+ * {@link CvSkill} is CV-specific (no other document family models skill
+ * levels). Mint Editorial is the first consumer; any future CV preset that
+ * wants level-driven skill bars can reuse it without re-deriving the marker
+ * geometry.</p>
+ */
+public final class SkillBar {
+
+    /** Track stroke width in points — a hairline rule. */
+    private static final double TRACK_THICKNESS = 0.65;
+
+    /** Proficiency marker stroke width in points — heavier than the track. */
+    private static final double MARKER_THICKNESS = 1.2;
+
+    /** Proficiency marker height in points. */
+    private static final double MARKER_HEIGHT = 8.0;
+
+    /** Gap (points) between the skill label and the track below it. */
+    private static final double LABEL_TO_TRACK_GAP = 8.0;
+
+    /**
+     * Vertical pull-up (points) applied to the marker so it overlays the
+     * track instead of stacking below it. Half the marker height plus a
+     * touch so the tick straddles the track line.
+     */
+    private static final double MARKER_OVERLAP = MARKER_HEIGHT / 2.0 + 0.35;
+
+    /** Gap (points) below the marker before the next skill bar. */
+    private static final double BAR_BOTTOM_GAP = 12.0;
+
+    private SkillBar() {
+    }
+
+    /**
+     * Renders a skill label and, when the skill carries a proficiency
+     * level, its proficiency bar.
+     *
+     * @param host       host section the label + bar are appended to
+     * @param skill      skill to render; its {@link CvSkill#level()} drives
+     *                   the marker position (empty level → label only)
+     * @param trackWidth full track width in points (typically the sidebar
+     *                   inner width)
+     * @param theme      active theme — supplies the body font, label/ink
+     *                   colour, and the rule colour for the track
+     */
+    public static void render(SectionBuilder host, CvSkill skill,
+                              double trackWidth, CvTheme theme) {
+        Objects.requireNonNull(host, "host");
+        Objects.requireNonNull(skill, "skill");
+        Objects.requireNonNull(theme, "theme");
+
+        boolean levelled = skill.level().isPresent();
+        DocumentTextStyle labelStyle = CvTextStyles.of(
+                theme.typography().bodyFont(),
+                theme.typography().sizeEntryTitle(),
+                DocumentTextDecoration.BOLD,
+                theme.palette().ink());
+        // When there is no bar, the label is the whole entry, so give it a
+        // little breathing room below to match the rhythm of a barred entry.
+        double labelBottom = levelled ? LABEL_TO_TRACK_GAP : BAR_BOTTOM_GAP;
+        host.addParagraph(paragraph -> paragraph
+                .text(TextOrnaments.spacedUpper(skill.name()))
+                .textStyle(labelStyle)
+                .align(TextAlign.LEFT)
+                .margin(DocumentInsets.bottom(labelBottom)));
+
+        if (!levelled) {
+            return;
+        }
+
+        double level = skill.level().getAsDouble();
+        double markerLeft = Math.max(0.0, Math.min(1.0, level)) * trackWidth;
+        host.addLine(line -> line
+                .horizontal(trackWidth)
+                .color(theme.palette().rule())
+                .thickness(TRACK_THICKNESS)
+                .margin(DocumentInsets.zero()));
+        host.addLine(line -> line
+                .vertical(MARKER_HEIGHT)
+                .color(theme.palette().ink())
+                .thickness(MARKER_THICKNESS)
+                .margin(new DocumentInsets(-MARKER_OVERLAP, 0,
+                        BAR_BOTTOM_GAP, markerLeft)));
+    }
+}
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/email.png b/src/main/resources/templates/cv/mint-editorial/icons/email.png
new file mode 100644
index 00000000..c3369c19
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/email.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/expertise-badge.png b/src/main/resources/templates/cv/mint-editorial/icons/expertise-badge.png
new file mode 100644
index 00000000..cdba6024
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/expertise-badge.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/facebook.png b/src/main/resources/templates/cv/mint-editorial/icons/facebook.png
new file mode 100644
index 00000000..75e0e24d
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/facebook.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/linkedin.png b/src/main/resources/templates/cv/mint-editorial/icons/linkedin.png
new file mode 100644
index 00000000..5990eeab
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/linkedin.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/location.png b/src/main/resources/templates/cv/mint-editorial/icons/location.png
new file mode 100644
index 00000000..03454608
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/location.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/phone.png b/src/main/resources/templates/cv/mint-editorial/icons/phone.png
new file mode 100644
index 00000000..eee1b2d5
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/phone.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/pinterest.png b/src/main/resources/templates/cv/mint-editorial/icons/pinterest.png
new file mode 100644
index 00000000..91326373
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/pinterest.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/twitter.png b/src/main/resources/templates/cv/mint-editorial/icons/twitter.png
new file mode 100644
index 00000000..c43d9de3
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/twitter.png differ
diff --git a/src/main/resources/templates/cv/mint-editorial/icons/website.png b/src/main/resources/templates/cv/mint-editorial/icons/website.png
new file mode 100644
index 00000000..3e29e34a
Binary files /dev/null and b/src/main/resources/templates/cv/mint-editorial/icons/website.png differ
diff --git a/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2SmokeTest.java b/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2SmokeTest.java
index 85452b24..5cbf664f 100644
--- a/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2SmokeTest.java
+++ b/src/test/java/com/demcha/compose/document/templates/coverletter/v2/presets/CoverLetterV2SmokeTest.java
@@ -75,7 +75,9 @@ private static Stream<Arguments> presets() {
                 Arguments.of((Supplier<DocumentTemplate<CoverLetterDocument>>) MonogramSidebarLetter::create,
                         "monogram-sidebar-letter", "Monogram Sidebar Letter"),
                 Arguments.of((Supplier<DocumentTemplate<CoverLetterDocument>>) TimelineMinimalLetter::create,
-                        "timeline-minimal-letter", "Timeline Minimal Letter"));
+                        "timeline-minimal-letter", "Timeline Minimal Letter"),
+                Arguments.of((Supplier<DocumentTemplate<CoverLetterDocument>>) MintEditorialLetter::create,
+                        "mint-editorial-letter", "Mint Editorial Letter"));
     }
 
     private static CoverLetterDocument sampleDocument() {
diff --git a/src/test/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSectionTest.java b/src/test/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSectionTest.java
index f01ddab1..5cd01e92 100644
--- a/src/test/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSectionTest.java
+++ b/src/test/java/com/demcha/compose/document/templates/cv/v2/data/SkillsSectionTest.java
@@ -11,7 +11,7 @@ class SkillsSectionTest {
 
     @Test
     void skillGroup_trims_category_and_skips_blank_skills() {
-        SkillGroup group = new SkillGroup(" Languages ",
+        SkillGroup group = SkillGroup.ofNames(" Languages ",
                 List.of(" Java 21 ", "", "Kotlin"));
 
         assertThat(group.category()).isEqualTo("Languages");
@@ -19,11 +19,34 @@ void skillGroup_trims_category_and_skips_blank_skills() {
         assertThat(group.skillsInline()).isEqualTo("Java 21, Kotlin");
     }
 
+    @Test
+    void skillGroup_carries_optional_levels_without_affecting_names() {
+        SkillGroup group = new SkillGroup("Design", List.of(
+                CvSkill.of("Illustration", 0.9),
+                CvSkill.of("Typography")));
+
+        // Name-only view is unchanged whether or not levels are present.
+        assertThat(group.skills()).containsExactly("Illustration", "Typography");
+        // Levels are readable by data-driven renderers.
+        assertThat(group.entries()).hasSize(2);
+        assertThat(group.entries().get(0).level().getAsDouble()).isEqualTo(0.9);
+        assertThat(group.entries().get(1).level()).isEmpty();
+    }
+
+    @Test
+    void cvSkill_clamps_level_via_factory_and_rejects_blank_name() {
+        assertThat(CvSkill.of("X", 1.5).level().getAsDouble()).isEqualTo(1.0);
+        assertThat(CvSkill.of("X", -0.2).level().getAsDouble()).isEqualTo(0.0);
+        assertThatThrownBy(() -> CvSkill.of(" "))
+                .isInstanceOf(IllegalArgumentException.class)
+                .hasMessageContaining("name");
+    }
+
     @Test
     void skillsSection_keeps_non_empty_groups_only() {
         SkillsSection section = SkillsSection.builder("Technical Skills")
                 .group("Languages", "Java 21", "Kotlin")
-                .group(new SkillGroup("Empty", List.of()))
+                .group(SkillGroup.ofNames("Empty", List.of()))
                 .group("Testing", "JUnit 5")
                 .build();
 
diff --git a/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java
index a36090a1..addd9e78 100644
--- a/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java
+++ b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/CvV2VisualParityTest.java
@@ -6,6 +6,7 @@
 import com.demcha.compose.document.templates.api.DocumentTemplate;
 import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
 import com.demcha.compose.document.templates.cv.v2.data.CvIdentity;
+import com.demcha.compose.document.templates.cv.v2.data.CvSkill;
 import com.demcha.compose.document.templates.cv.v2.data.EntriesSection;
 import com.demcha.compose.document.templates.cv.v2.data.ParagraphSection;
 import com.demcha.compose.document.templates.cv.v2.data.RowStyle;
@@ -17,6 +18,7 @@
 import org.junit.jupiter.params.provider.MethodSource;
 
 import java.nio.file.Path;
+import java.util.List;
 import java.util.function.Supplier;
 import java.util.stream.Stream;
 
@@ -158,26 +160,50 @@ private static CvDocument canonicalDocument() {
                                 + "high-throughput PDF rendering, semantic authoring "
                                 + "DSLs, and turning brittle production-ops scripts "
                                 + "into typed, snapshot-tested libraries that scale."))
+                // Skill names match the name-only form exactly; only
+                // optional proficiency levels are added so data-driven
+                // presets (Mint Editorial) can render meters. Name-only
+                // presets read SkillGroup.skills() and render identically,
+                // so the existing baselines are unaffected.
                 .section(SkillsSection.builder("Technical Skills")
-                        .group("Languages", "Java 21", "Kotlin", "Groovy",
-                                "Python", "SQL")
-                        .group("Document & Print", "PDFBox",
-                                "Apache POI (DOCX/XLSX)", "iText",
-                                "PostScript", "ICC colour profiles",
-                                "font metrics")
-                        .group("Layout engines", "Custom DSL design",
-                                "semantic layout trees", "pagination",
-                                "snapshot testing", "visual regression")
-                        .group("Build & infrastructure", "Maven", "Gradle",
-                                "GitHub Actions", "JitPack", "Docker",
-                                "JMH benchmarking")
-                        .group("Testing", "JUnit 5", "AssertJ",
-                                "PDFBox-based PNG diff",
-                                "layout-graph snapshots",
-                                "mutation testing (Pitest)")
-                        .group("Distribution", "Maven Central",
-                                "Sonatype OSSRH", "GPG signing", "JitPack",
-                                "semantic versioning discipline")
+                        .leveledGroup("Languages", List.of(
+                                CvSkill.of("Java 21", 0.95),
+                                CvSkill.of("Kotlin", 0.85),
+                                CvSkill.of("Groovy", 0.7),
+                                CvSkill.of("Python", 0.75),
+                                CvSkill.of("SQL", 0.8)))
+                        .leveledGroup("Document & Print", List.of(
+                                CvSkill.of("PDFBox", 0.9),
+                                CvSkill.of("Apache POI (DOCX/XLSX)", 0.7),
+                                CvSkill.of("iText", 0.65),
+                                CvSkill.of("PostScript", 0.6),
+                                CvSkill.of("ICC colour profiles", 0.55),
+                                CvSkill.of("font metrics", 0.7)))
+                        .leveledGroup("Layout engines", List.of(
+                                CvSkill.of("Custom DSL design", 0.9),
+                                CvSkill.of("semantic layout trees", 0.85),
+                                CvSkill.of("pagination", 0.85),
+                                CvSkill.of("snapshot testing", 0.8),
+                                CvSkill.of("visual regression", 0.8)))
+                        .leveledGroup("Build & infrastructure", List.of(
+                                CvSkill.of("Maven", 0.9),
+                                CvSkill.of("Gradle", 0.75),
+                                CvSkill.of("GitHub Actions", 0.85),
+                                CvSkill.of("JitPack", 0.8),
+                                CvSkill.of("Docker", 0.7),
+                                CvSkill.of("JMH benchmarking", 0.65)))
+                        .leveledGroup("Testing", List.of(
+                                CvSkill.of("JUnit 5", 0.9),
+                                CvSkill.of("AssertJ", 0.85),
+                                CvSkill.of("PDFBox-based PNG diff", 0.8),
+                                CvSkill.of("layout-graph snapshots", 0.8),
+                                CvSkill.of("mutation testing (Pitest)", 0.6)))
+                        .leveledGroup("Distribution", List.of(
+                                CvSkill.of("Maven Central", 0.8),
+                                CvSkill.of("Sonatype OSSRH", 0.75),
+                                CvSkill.of("GPG signing", 0.7),
+                                CvSkill.of("JitPack", 0.8),
+                                CvSkill.of("semantic versioning discipline", 0.85)))
                         .build())
                 .section(EntriesSection.builder("Education & Certifications")
                         .entry("MSc Computer Science",
diff --git a/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorialSmokeTest.java b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorialSmokeTest.java
new file mode 100644
index 00000000..ffa43d51
--- /dev/null
+++ b/src/test/java/com/demcha/compose/document/templates/cv/v2/presets/MintEditorialSmokeTest.java
@@ -0,0 +1,168 @@
+package com.demcha.compose.document.templates.cv.v2.presets;
+
+import com.demcha.compose.GraphCompose;
+import com.demcha.compose.document.api.DocumentPageSize;
+import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.layout.LayoutGraph;
+import com.demcha.compose.document.templates.api.DocumentTemplate;
+import com.demcha.compose.document.templates.cv.v2.data.CvDocument;
+import com.demcha.compose.document.templates.cv.v2.data.CvIdentity;
+import com.demcha.compose.document.templates.cv.v2.data.CvSkill;
+import com.demcha.compose.document.templates.cv.v2.data.EntriesSection;
+import com.demcha.compose.document.templates.cv.v2.data.ParagraphSection;
+import com.demcha.compose.document.templates.cv.v2.data.RowStyle;
+import com.demcha.compose.document.templates.cv.v2.data.RowsSection;
+import com.demcha.compose.document.templates.cv.v2.data.SkillsSection;
+import com.demcha.compose.document.templates.cv.v2.theme.CvTheme;
+import org.junit.jupiter.api.Test;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+/**
+ * Smoke test for the v2 Mint Editorial preset. Covers stable identity,
+ * the two-page atomic-row composition against the full canonical sample
+ * (including level-driven skill bars and the Awards / References grids),
+ * and graceful degradation when the optional sidebar/main sections are
+ * absent.
+ */
+class MintEditorialSmokeTest {
+
+    @Test
+    void exposes_stable_identity() {
+        DocumentTemplate<CvDocument> template = MintEditorial.create();
+        assertThat(template.id()).isEqualTo("mint-editorial");
+        assertThat(template.displayName()).isEqualTo("Mint Editorial");
+    }
+
+    @Test
+    void default_factory_renders_two_pages() throws Exception {
+        try (DocumentSession session = GraphCompose.document()
+                .pageSize(DocumentPageSize.A4)
+                .margin(48, 48, 48, 48)
+                .create()) {
+            MintEditorial.create().compose(session, fullDocument());
+            assertThat(session.roots()).isNotEmpty();
+            LayoutGraph layout = session.layoutGraph();
+            // The preset emits two atomic page rows. The dense fullDocument
+            // fills page 1, so the second (atomic) row flows whole onto
+            // page 2 — a clean two-page document with neither row overflowing.
+            assertThat(layout.totalPages()).isEqualTo(2);
+        }
+    }
+
+    @Test
+    void custom_theme_factory_renders() throws Exception {
+        try (DocumentSession session = GraphCompose.document()
+                .pageSize(DocumentPageSize.A4)
+                .margin(48, 48, 48, 48)
+                .create()) {
+            MintEditorial.create(CvTheme.mintEditorial())
+                    .compose(session, fullDocument());
+            assertThat(session.roots()).isNotEmpty();
+        }
+    }
+
+    @Test
+    void renders_with_awards_and_references_grids() throws Exception {
+        try (DocumentSession session = GraphCompose.document()
+                .pageSize(DocumentPageSize.A4)
+                .margin(48, 48, 48, 48)
+                .create()) {
+            MintEditorial.create().compose(session, documentWithAwardsAndReferences());
+            assertThat(session.roots()).isNotEmpty();
+        }
+    }
+
+    @Test
+    void degrades_when_optional_sections_absent() throws Exception {
+        // Only identity + profile + a single experience entry — no skills,
+        // education, interests, awards, references or social.
+        CvDocument minimal = CvDocument.builder()
+                .identity(CvIdentity.builder()
+                        .name("Jane", "Doe")
+                        .jobTitle("Designer")
+                        .contact("+44 0", "j@d.com", "London")
+                        .build())
+                .sections(
+                        new ParagraphSection("Profile", "Builds **clean** layouts."),
+                        EntriesSection.builder("Professional Experience")
+                                .entry("Designer", "Acme", "2021-2024", "Did design.")
+                                .build())
+                .build();
+        try (DocumentSession session = GraphCompose.document()
+                .pageSize(DocumentPageSize.A4)
+                .margin(48, 48, 48, 48)
+                .create()) {
+            MintEditorial.create().compose(session, minimal);
+            assertThat(session.roots()).isNotEmpty();
+        }
+    }
+
+    private static CvDocument fullDocument() {
+        return CvDocument.builder()
+                .identity(CvIdentity.builder()
+                        .name("Jordan", "Rivera")
+                        .jobTitle("Platform Engineer")
+                        .contact("+44 20 5555 1000", "jordan.rivera@example.com",
+                                "London, UK")
+                        .link("LinkedIn", "https://linkedin.com/in/jordan-rivera-demo")
+                        .link("GitHub", "https://github.com/jrivera-demo")
+                        .build())
+                .sections(
+                        new ParagraphSection("Professional Summary",
+                                "Platform engineer building **resilient** document "
+                                        + "pipelines and developer-facing template systems."),
+                        SkillsSection.builder("Technical Skills")
+                                .leveledGroup("Languages", List.of(
+                                        CvSkill.of("Java 21", 0.95),
+                                        CvSkill.of("Kotlin", 0.85),
+                                        CvSkill.of("SQL", 0.8)))
+                                .leveledGroup("Testing", List.of(
+                                        CvSkill.of("JUnit 5", 0.9),
+                                        CvSkill.of("AssertJ", 0.85)))
+                                .build(),
+                        EntriesSection.builder("Education & Certifications")
+                                .entry("MSc Computer Science",
+                                        "University of Manchester", "2019-2021",
+                                        "Distinction.")
+                                .entry("BSc Software Engineering",
+                                        "Imperial College London", "2015-2019",
+                                        "First-class honours.")
+                                .build(),
+                        EntriesSection.builder("Professional Experience")
+                                .entry("Senior Platform Engineer", "Northwind Systems",
+                                        "2024-Present", "Led the document platform.")
+                                .entry("Software Engineer", "BrightLeaf Labs",
+                                        "2021-2024", "Built rendering pipelines.")
+                                .entry("Backend Engineer", "Helix Print Co",
+                                        "2019-2021", "Maintained invoice printing.")
+                                .build())
+                .build();
+    }
+
+    private static CvDocument documentWithAwardsAndReferences() {
+        return CvDocument.builder()
+                .identity(CvIdentity.builder()
+                        .name("Jordan", "Rivera")
+                        .jobTitle("Designer")
+                        .contact("+44 0", "j@d.com", "London")
+                        .link("LinkedIn", "https://linkedin.com/in/jordan")
+                        .build())
+                .sections(
+                        new ParagraphSection("Profile", "Designs editorial layouts."),
+                        EntriesSection.builder("Professional Experience")
+                                .entry("Designer", "Acme", "2021-2024", "Did design.")
+                                .build(),
+                        RowsSection.builder("Awards", RowStyle.PLAIN)
+                                .row("Best Layout", "Design Guild | 2023")
+                                .row("Editorial Prize", "Type Society | 2022")
+                                .build(),
+                        RowsSection.builder("References", RowStyle.PLAIN)
+                                .row("Alex Stone", "Acme | alex@acme.com")
+                                .row("Sam Reed", "BrightLeaf | sam@bl.com")
+                                .build())
+                .build();
+    }
+}
diff --git a/src/test/java/com/demcha/compose/document/templates/cv/v2/widgets/WidgetSmokeTest.java b/src/test/java/com/demcha/compose/document/templates/cv/v2/widgets/WidgetSmokeTest.java
index 984ef065..d423d21e 100644
--- a/src/test/java/com/demcha/compose/document/templates/cv/v2/widgets/WidgetSmokeTest.java
+++ b/src/test/java/com/demcha/compose/document/templates/cv/v2/widgets/WidgetSmokeTest.java
@@ -2,6 +2,7 @@
 
 import com.demcha.compose.GraphCompose;
 import com.demcha.compose.document.api.DocumentSession;
+import com.demcha.compose.document.image.DocumentImageData;
 import com.demcha.compose.document.node.TextAlign;
 import com.demcha.compose.document.style.DocumentColor;
 import com.demcha.compose.document.style.DocumentInsets;
@@ -9,6 +10,7 @@
 import com.demcha.compose.document.style.DocumentTextStyle;
 import com.demcha.compose.document.templates.cv.v2.data.CvIdentity;
 import com.demcha.compose.document.templates.cv.v2.data.CvName;
+import com.demcha.compose.document.templates.cv.v2.data.CvSkill;
 import com.demcha.compose.document.templates.cv.v2.theme.CvTheme;
 import com.demcha.compose.font.FontName;
 import org.junit.jupiter.api.Test;
@@ -77,6 +79,31 @@ void subheadline_variants_render_without_throwing() throws Exception {
                         theme.bodyStyle()));
     }
 
+    @Test
+    void skillBar_renders_with_and_without_level() throws Exception {
+        CvTheme theme = CvTheme.mintEditorial();
+        // Levelled skill → label + proficiency bar.
+        renderWithSection(section ->
+                SkillBar.render(section, CvSkill.of("Java 21", 0.9), 120, theme));
+        // Name-only skill → label, no bar (graceful degrade).
+        renderWithSection(section ->
+                SkillBar.render(section, CvSkill.of("Kotlin"), 120, theme));
+    }
+
+    @Test
+    void iconTextRow_renders_with_and_without_link() throws Exception {
+        CvTheme theme = CvTheme.mintEditorial();
+        DocumentImageData icon = DocumentImageData.fromBytes(readMintIcon("phone.png"));
+        // Linked row (whole row clickable) and plain row.
+        renderWithSection(section -> IconTextRow.render(section, icon, 9.0,
+                "hello@example.com", theme.bodyStyle(),
+                new com.demcha.compose.document.node.DocumentLinkOptions(
+                        "mailto:hello@example.com"),
+                DocumentInsets.bottom(12)));
+        renderWithSection(section -> IconTextRow.render(section, icon, 9.0,
+                "London, UK", theme.bodyStyle(), null, DocumentInsets.bottom(12)));
+    }
+
     @Test
     void sectionHeader_variants_render_without_throwing() throws Exception {
         CvTheme theme = CvTheme.boxedClassic();
@@ -187,6 +214,14 @@ private static void renderWithFlow(FlowAction action) throws Exception {
         }
     }
 
+    private static byte[] readMintIcon(String fileName) throws Exception {
+        try (var input = WidgetSmokeTest.class.getResourceAsStream(
+                "/templates/cv/mint-editorial/icons/" + fileName)) {
+            assertThat(input).as("mint editorial icon %s", fileName).isNotNull();
+            return input.readAllBytes();
+        }
+    }
+
     private static CvName name() {
         return CvName.of("Jane", "Doe");
     }
diff --git a/src/test/java/com/demcha/documentation/VersionConsistencyGuardTest.java b/src/test/java/com/demcha/documentation/VersionConsistencyGuardTest.java
index 44ffad76..a4cb2d8c 100644
--- a/src/test/java/com/demcha/documentation/VersionConsistencyGuardTest.java
+++ b/src/test/java/com/demcha/documentation/VersionConsistencyGuardTest.java
@@ -88,10 +88,40 @@ void readmeInstallSnippetsMatchTheProjectVersion() throws Exception {
                 .isEqualTo(root);
     }
 
+    /**
+     * The GitHub Pages showcase ({@code docs/index.html}) hardcodes the version
+     * in five spots — JSON-LD {@code softwareVersion}, the JitPack download URL,
+     * the hero badge, and the Maven + Gradle install snippets. None of these
+     * inherit from the pom, so without this guard they silently drift (they sat
+     * at v1.6.1 while the library shipped v1.6.4). {@code cut-release.ps1} flips
+     * them on release; this fails the verify gate if any spot lags behind.
+     */
+    @Test
+    void showcaseSiteVersionMatchesTheProjectVersion() throws Exception {
+        String root = effectiveVersion(PROJECT_ROOT.resolve("pom.xml"));
+        String site = Files.readString(PROJECT_ROOT.resolve("docs/index.html"));
+
+        assertThat(firstGroup(site, "\"softwareVersion\":\\s*\"v?([0-9][^\"]*)\""))
+                .describedAs("docs/index.html JSON-LD softwareVersion must equal the project version (%s)", root)
+                .isEqualTo(root);
+        assertThat(firstGroup(site, "jitpack\\.io/#DemchaAV/GraphCompose/v?([0-9][^\"]*)"))
+                .describedAs("docs/index.html JitPack downloadUrl must equal the project version (%s)", root)
+                .isEqualTo(root);
+        assertThat(firstGroup(site, "v([0-9][0-9.]*)\\s*&middot;\\s*MIT"))
+                .describedAs("docs/index.html hero version badge must equal the project version (%s)", root)
+                .isEqualTo(root);
+        assertThat(firstGroup(site, "&lt;version&gt;v?([0-9][^&]*)&lt;/version&gt;"))
+                .describedAs("docs/index.html Maven install snippet must equal the project version (%s)", root)
+                .isEqualTo(root);
+        assertThat(firstGroup(site, "GraphCompose:v?([0-9][^')]*)"))
+                .describedAs("docs/index.html Gradle install snippet must equal the project version (%s)", root)
+                .isEqualTo(root);
+    }
+
     private static String firstGroup(String text, String regex) {
         Matcher matcher = Pattern.compile(regex).matcher(text);
         assertThat(matcher.find())
-                .describedAs("Expected a GraphCompose install-snippet version matching /%s/ in README.md", regex)
+                .describedAs("Expected a GraphCompose version token matching /%s/ in the scanned file", regex)
                 .isTrue();
         return matcher.group(1);
     }