Templates v1-classic · CV, cover letter, invoice, proposal

July 12, 2026 · View on GitHub

🗄️ Archived. This page documents the classic template surface (*Spec records + *Builder + presets + BusinessTheme, introduced by ADR 0011) that shipped through the 1.x line and was removed in GraphCompose 2.0. It is kept for readers maintaining a pre-2.0 caller. The current template surface is the layered stack at templates/v2-layered/; the migration map is in which-template-system.md § 3. Nothing below is updated anymore.

GraphCompose v1.6 ships a rebuilt canonical template surface for the four business document shapes: CV, cover letter, invoice, proposal. Every preset is one final class with one create(BusinessTheme) factory, and the spec / preset / theme split is the same across all four domains so a caller learns it once and reuses it everywhere.

This page is a landing reference. For a full conceptual walk-through (four-layer architecture, when to extend a preset vs. write your own, how rendering decisions cascade through theme tokens), read ./authoring.md. For the v1 → v2 upgrade table (every old class → its v2 replacement, with before/after code), read ../../roadmaps/migration-v1-5-to-v1-6.md.

Architecture in four layers

Every Templates v2 preset is composed in four layers, top-to-bottom:

Theme tokens — BusinessTheme + Spacing + Typography. Colours, type scale, gutters, accent rules.
Layout slots — SingleColumn, TwoColumnSidebar, ThreeColumnMagazine, LetterFormat. The page geometry strategy.
Components + blocks — Header, Module, MarkdownText; sealed Block hierarchy (ParagraphBlock, BulletListBlock, KeyValueBlock, IndentedBlock, MultiParagraphBlock).
Spec data — CvSpec, CoverLetterSpec, InvoiceSpec, ProposalSpec. The plain-Java record carrying the document's content.

Presets glue 1+2+3 together; a caller hands them 4. Adjusting one visual decision is one method on one preset, never a fork of a 600-line composer.

Quick start

import com.demcha.compose.document.templates.cv.presets.ModernProfessional;
import com.demcha.compose.document.templates.cv.spec.CvSpec;
import com.demcha.compose.document.templates.api.DocumentTemplate;
import com.demcha.compose.document.theme.BusinessTheme;

DocumentTemplate<CvSpec> template = ModernProfessional.create(BusinessTheme.modern());
template.compose(session, mySpec);

Same shape for cover letters, invoices, and proposals — swap the package, the spec type, and the preset class.

CV preset gallery (14)

Each preset is a one-class final type with RECOMMENDED_MARGIN and create(BusinessTheme). Visual baselines are pixel-diff verified against v1 reference renders.

Preset	Layout	Notes
`ModernProfessional`	Single column	Slate-blue name + royal-blue underlined links; canonical default
`NordicClean`	Two-column sidebar	Soft-tinted profile panel on the left
`ClassicSerif`	Two-page editorial	Serif-only typography, restrained accents
`CompactMono`	Single column	Tight grid for technical CVs
`Executive`	Two-column sidebar	Larger accent rule + uppercase section heads
`EngineeringResume`	Two-column sidebar	Dense skill stack, code-friendly mono
`TimelineMinimal`	Single column	Vertical rule + dot timeline along the left margin
`BoxedSections`	Single column	Section headers in tinted boxes with full-width rule
`CenteredHeadline`	Single column	Centered name + bullet & key-value sections
`BlueBanner`	Single column	Full-width section banners in theme accent
`EditorialBlue`	Single column	Slab subtitle + jobTitle line + uppercase rule
`Panel`	Two-column sidebar	Soft-tinted panel for sidebar; project-leader shape
`SidebarPortrait`	Two-column sidebar	Portrait + sidebar fill to page bottom
`MonogramSidebar`	Two-column sidebar	Monogram badge + sidebar fill

Cover-letter preset gallery (14, paired)

Each cover-letter preset pairs visually with its same-named CV preset (palette, header rhythm, accent rule). Mix-and-match is supported but the default pairing produces the cleanest visual.

ModernProfessional · NordicClean · ClassicSerif · CompactMono · Executive · EngineeringResume · TimelineMinimal · BoxedSections · CenteredHeadline · BlueBanner · EditorialBlue · Panel · SidebarPortrait · MonogramSidebar

Render any preset against a sample spec to inspect the output:

./mvnw -f examples/pom.xml exec:java \
    -Dexec.mainClass=com.demcha.examples.templates.cv.CvTemplateGalleryFileExample

The runnable gallery writes one PDF per preset under examples/target/generated-pdfs/templates/cv/. The cover-letter gallery mirrors the layout under templates/coverletter/.

Invoice + proposal (minimal v2 surface)

ModernInvoice and ModernProposal ship as the canonical builder seam for invoices and proposals respectively. Cinematic feature parity (rich hero blocks, accent-driven section bands) lives in InvoiceTemplateV2 / ProposalTemplateV2 under templates/builtins/ — those remain the recommended path when full visual styling is required, while the v2 builders provide a smaller, copy-and-tweak entry point for callers extending their own branding.

Authoring features built into every preset

Inline markdown — body strings carrying **bold** and *italic* markers render with proper DocumentTextDecoration via templates.core.text.MarkdownText.
Active hyperlinks — header email + LinkedIn / GitHub labels become clickable mailto: / https: runs via DocumentLinkOptions.
Slot-based layouts — multi-column presets (Panel, SidebarPortrait, MonogramSidebar) declare named slots (MAIN, SIDEBAR); custom presets rearrange modules via .place(slot, "Module Name", ...).
Adaptive sidebar fill — sidebar layouts size the trailing spacer dynamically from canvas().innerHeight() so background panels reach the page bottom on A4 / Letter / smaller fixtures without overflow.
CvHeader.jobTitle subtitle — presets that surface a subtitle (EditorialBlue, Panel, SidebarPortrait, MonogramSidebar) read it from the spec; an empty value falls back to a placeholder.

Visual parity & regression coverage

28 layout-snapshot baselines under core/src/test/resources/layout-snapshots/canonical-templates/{cv-v2,coverletter-v2}/ lock the rendered tree of every preset.
29 pixel-diff baselines under core/src/test/resources/visual-baselines/{cv-v2,coverletter-v2}/ enforce per-channel rendering parity against the v1 reference renders. The gate runs on every CI build with a calibrated mismatchedPixelBudget for cross-platform PDFBox font drift.
Re-bless after a deliberate visual change with -Dgraphcompose.visual.approve=true.

Migration from v1 templates

Legacy CV / cover-letter classes (CvTemplateV1, NordicCleanCvTemplate, MonogramSidebarCvTemplate, ...) are deleted, not deprecated, in v1.6. Any code constructing those classes must switch to the matching v2 preset's create(BusinessTheme) factory. The full mapping (every old class → its v2 replacement, with side-by-side code) is documented in docs/roadmaps/migration-v1-5-to-v1-6.md.