README.md

GraphCompose Examples

A runnable, single-file Java example for every public surface in GraphCompose — built-in templates, v1.5 cinematic features, public-API showcases, and a kitchen-sink master demo. Each example writes a PDF to examples/target/generated-pdfs/; the same PDFs are committed to assets/readme/examples/ so you can preview every render straight from GitHub without running anything.

Run examples

Install the library artifact once from the repository root:

./mvnw -DskipTests install

Then run all 63 examples in one shot:

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

…or run a single example by passing its main class:

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

Generated PDFs land in examples/target/generated-pdfs/. The same mvnw.cmd form works on Windows PowerShell with backslash paths.

GenerateAllExamples runs 63 example programs — 16 CV + 15 cover-letter presets plus invoices, proposals, a schedule, the feature demos, and the flagships. The showcase site surfaces the full generated catalogue (~53 PDFs); a curated 39-PDF subset is committed under assets/readme/examples/ for the previews linked below.

Gallery — pick by your goal

Examples are categorised by maturity / intent, not by the GraphCompose release that introduced them. Pick the row that matches how far along you are with the canonical DSL, then jump to its detailed section below.

Maturity legend. 🚀 Start here — minimum-friction entry points; pick one if you've never used the canonical DSL before. 🧱 Core DSL — features you'll author against every day once the basics click. 📋 Templates recommended — the v2 / layered template surfaces and how to drive them; pick when you want a one-line CV / invoice / proposal / cover-letter. 🔧 Advanced SPI — production-deployment patterns, specialty SPIs (shapes, transforms, barcodes), engine-level tools (snapshots). 🗄️ Legacy — pre-rebuild examples kept for downstream callers still on V1; do not start new code here. See docs/templates/which-template-system.md for the V1 → V2 migration path.

🚀 Start here

Example	What it shows	Preview · Source
CV — single template	One CV via ModernProfessional.create(BusinessTheme.modern()) (Templates v2)	PDF · Source
Invoice — cinematic V2	InvoiceTemplateV2 + BusinessTheme.modern() — the recommended invoice path	PDF · Source
Cover Letter	One-page BusinessTheme.modern() cover letter with section presets	PDF · Source
Module-first Profile	Authoring directly against DocumentSession.module(...).paragraph(...) — DSL-direct, no template	PDF · Source
Engine Showcase	Single-page cinematic brand promo — semantic-graph → polished-PDFs visual metaphor with rounded clip frame, magazine headline lockup, KPI cards, capability columns; source of the README hero image	Source
Engine Deck	Multi-page landscape capability deck — page 1 is a banner infographic (DSL code → engine → backends → real rendered-document thumbnails), then an authoring-pipeline walkthrough, and two pages of real benchmark data (GraphCompose vs iText 9 vs JasperReports) loaded from a bundled result file and drawn as tables + native charts; the landscape companion to Engine Showcase	PDF · Source

🧱 Core DSL

Example	What it shows	Preview · Source
Rich text	Every RichText method (bold / italic / underline / link / colour / accent / size / append)	PDF · Source
Inline shapes	InlineShapeRun — dots, arrows, chevrons, diamonds, stars, checkmarks and checkboxes drawn as geometry on the text baseline	PDF · Source
Section presets	pageBackground, band, softPanel, accentLeft / Right / Top / Bottom, per-corner DocumentCornerRadius	PDF · Source
Nested lists	ListBuilder.addItem(label, Consumer) — depth cascade, per-depth markers, mixed flat / nested authoring	PDF · Source
Composed table cells	DocumentTableCell.node(DocumentNode) — paragraphs, lists, sub-tables inside cells with two-pass measurement	PDF · Source
Canvas layer (free placement)	CanvasLayerNode — pixel-precise (x, y) placement of children inside a fixed bounding box, with ClipPolicy clipping	PDF · Source
Transforms	rotate, scale, and per-layer zIndex swap	PDF · Source
Block alignment	addAligned(align, node) / addSvgIcon(icon, w, align) — seat any fixed-size node left / centre / right across the content width	PDF · Source

📋 Templates recommended

Example	What it shows	Preview · Source
CV — template gallery	The v2 CV presets in one orchestrated run	Source
Cover letter — template gallery	All paired v2 cover-letter presets in one orchestrated run	Source
Proposal — cinematic V2	ProposalTemplateV2 + BusinessTheme.modern()	PDF · Source
Custom Business Theme	Hand-built BusinessTheme driving InvoiceTemplateV2 — theme-token customisation entry point	PDF · Source

🔧 Advanced SPI

Example	What it shows	Preview · Source
Shape containers	Circles, ellipses, rounded cards with ClipPolicy.CLIP_PATH	PDF · Source
Vector paths (Bézier)	addPath(...) + SvgPath.parse(...) — design shapes and imported SVG icons as native curves; zero tessellation	PDF · Source
SVG icon gallery	34 real-world multicolour svgrepo icons via SvgIcon.parse — up to 19 layers each, the whole set 156 KB of sources	PDF · Source
Advanced tables	Row span, zebra rows, totals, repeating header on page break	PDF · Source
Barcodes	QR, Code 128, Code 39, EAN-13, EAN-8, branded QR with theme colours	PDF · Source
Charts	Native vector bar, line, and pie/donut charts — data/spec/style layers, axis & grid toggles, point markers, value labels, legend	PDF · Source
PDF chrome	DocumentMetadata, DocumentWatermark, DocumentHeaderFooter, DocumentBookmarkOptions	PDF · Source
HTTP streaming	writePdf(OutputStream) for Servlet / S3 / GCS — caller's stream is not closed	PDF · Source
Word export (DOCX)	DocxSemanticBackend — the same session renders a fixed-layout PDF and an editable Word file; paragraphs / lists / tables / images map 1:1, charts fall back to their data table	PDF · DOCX · Source
Layout snapshot regression	Deterministic layoutSnapshot() workflow with baseline + drift report — production regression-testing pattern	PDF · Source
Debug overlay	DocumentDebugOptions — guide lines + semantic node-path labels on the sheet; trace any misplaced block back to the builder call that authored it	PDF · Source
Business report cover	Single-page Q1 investor brief — hero image, KPI cards, bar chart, metrics table	PDF · Source
Financial report one-pager	Single-page monthly financial dashboard — three margin gauges, cash & stacked-OPEX charts, a revenue donut, and forecast bars; all v1.8 native vector charts plus inline sparklines and a path-clipped photo masthead	PDF · Source
Master showcase	Kitchen-sink "Q2 sample report" combining the canonical surface end-to-end	PDF · Source
Feature catalog	Browsable reference PDF: every shipped capability as a block — outline-clickable heading, the exact API call, the rendered result right under it	PDF · Source

🗄️ Legacy

Example	What it shows	Preview · Source
Invoice (V1)	InvoiceTemplateV1 driven from InvoiceDocumentSpec — pre-rebuild surface, supported only	PDF · Source
Proposal (V1)	ProposalTemplateV1 driven from ProposalDocumentSpec — pre-rebuild surface, supported only	PDF · Source
Handcrafted Proposal	v1.4-style cinematic proposal composed by hand — pre-template authoring; kept for parity reference	PDF · Source
Weekly schedule	Bar / restaurant shift schedule via WeeklyScheduleRenderer (WeeklyScheduleTemplateV1 — no V2 yet; will be re-shaped before 2.0)	PDF · Source

---

Document templates

Cover letter

A one-page modern cover letter — BusinessTheme.modern() drives every colour and font choice; section presets (softPanel, accentLeft, accentTop) carry the visual hierarchy; opening rich-text strip highlights the candidate's headline.

try (DocumentSession document = GraphCompose.document(outputFile)
        .pageSize(DocumentPageSize.A4)
        .pageBackground(THEME.pageBackground())
        .margin(56, 48, 56, 48)
        .create()) {

    document.pageFlow()
            .name("CoverLetter")
            .spacing(18)
            .addRow("Header", row -> row
                    .weights(3, 1)
                    .addSection("Identity", section -> section
                            .addParagraph(p -> p.text("Mariia Demchyshyn")
                                    .textStyle(THEME.text().h1())))
                    .addSection("Date", section -> section
                            .addParagraph(p -> p.text("15 May 2026"))))
            .addSection("Headline", section -> section
                    .softPanel(THEME.palette().surfaceMuted(), 10, 18)
                    .accentLeft(ACCENT, 4)
                    .addRich(rich -> rich
                            .plain("I help teams ship ")
                            .style("designed PDFs as code", BOLD_BRAND)
                            .plain(" — semantic Java DSL, deterministic layout.")))
            // … recipient block + body paragraphs + highlights row + closing …
            .build();

    document.buildPdf();
}

📄 View PDF · 📜 Full source

Invoice (V1)

InvoiceTemplateV1.compose(document, spec) handles the full layout — header band, parties row, line-items table, totals row, payment-terms footer — driven from a InvoiceDocumentSpec. Use this when you want the legacy hard-coded theme; for V2 cinematic, see below.

InvoiceDocumentSpec spec = InvoiceDocumentSpec.builder()
        .invoiceNumber("GC-2026-041")
        .issueDate("02 Apr 2026")
        .dueDate("16 Apr 2026")
        .fromParty(p -> p.name("GraphCompose Studio"))
        .billToParty(p -> p.name("Northwind Systems"))
        .lineItem("Template architecture", "Reusable invoice flow", "2", "GBP 980", "GBP 1,960")
        .totalRow("Total", "GBP 1,960")
        .build();

try (DocumentSession document = GraphCompose.document(outputFile)
        .pageSize(DocumentPageSize.A4)
        .margin(28, 28, 28, 28)
        .create()) {
    new InvoiceTemplateV1().compose(document, spec);
    document.buildPdf();
}

📄 View PDF · 📜 Full source

Proposal (V1)

ProposalTemplateV1 rendered against a ProposalDocumentSpec — sections, scope items, deliverables, sign-off. Pairs naturally with InvoiceTemplateV1 for consistent "spec → PDF" pipelines.

📄 View PDF · 📜 Full source

Module-first profile

Authoring against DocumentSession.pageFlow().module(...) — no template, no theme, just the canonical DSL. Smallest possible footprint for "I just need a one-page PDF from data".

document.pageFlow()
        .module("Profile", module -> module
                .heading("Mariia Demchyshyn")
                .paragraph("Senior Backend Engineer")
                .paragraph("mariia@example.com  ·  +44 20 7946 0234"));
document.buildPdf();

📄 View PDF · 📜 Full source

CV — single template

One CV rendered through the Templates v2 surface: ModernProfessional.create(BusinessTheme.modern()) paired with a CvSpec data shape. The preset is one final class with one create(BusinessTheme) factory — copy-and-tweak rather than fork-a-monolith.

📄 View PDF · 📜 Full source

CV — template gallery

Generates the v2 CV presets in one orchestrated run, covering single-column, two-column-sidebar, and three-column-magazine layouts. Use this as the side-by-side catalogue when picking a base preset for your own CV product. Each preset is a one-liner factory (ModernProfessional.create(), NordicClean.create(), …); see cv/v2/presets/ for the full list.

Variant	PDF
Modern professional	PDF
Nordic clean	PDF
Classic serif	PDF
Compact mono	PDF
Timeline minimal	PDF
Engineering resume	PDF
Panel	PDF
Executive · BoxedSections · CenteredHeadline · BlueBanner · EditorialBlue · SidebarPortrait · MonogramSidebar · MintEditorial · MinimalUnderlined	run the gallery to render

📜 Full source

Cover letter — template gallery

Generates all paired v2 cover-letter presets in one run — one letter style per CV preset so a candidate's CV and cover letter share the same visual language end-to-end. Each preset is a one-liner factory (ModernProfessionalLetter.create(), NordicCleanLetter.create(), …) under coverletter/v2/presets/.

📜 Full source

---

Cinematic templates (v1.5)

Invoice — cinematic V2

InvoiceTemplateV2(BusinessTheme.modern()) — the cinematic invoice. Hero softPanel with invoice number / dates / inline rich-text status, two-column parties row, themed line-items table with headerStyle + zebra + totals + repeatHeader(), footer row with accentLeft strips.

BusinessTheme theme = BusinessTheme.modern();
InvoiceTemplateV2 template = new InvoiceTemplateV2(theme);

try (DocumentSession document = GraphCompose.document(outputFile)
        .pageSize(DocumentPageSize.A4)
        .pageBackground(theme.pageBackground())
        .margin(28, 28, 28, 28)
        .create()) {
    template.compose(document, invoice);
    document.buildPdf();
}

📄 View PDF · 📜 Full source

Proposal — cinematic V2

ProposalTemplateV2 — same BusinessTheme-driven pattern as the invoice. Hero rounded only on the right (DocumentCornerRadius.right(...)), themed executive-summary panel, sender / recipient parties row, theme.text().h2() headings, timeline + pricing tables with repeatHeader(), zebra rows, and a totalRow(...).

📄 View PDF · 📜 Full source

Handcrafted proposal

A v1.4-style cinematic proposal composed by hand — no template — to show how the same primitives compose without a XxxTemplateV2 wrapper. Useful starting point when your domain doesn't fit any built-in template.

📄 View PDF · 📜 Full source

---

v1.5 feature showcases

Shape containers

addContainer(...), addCircle(...), addEllipse(...) build a ShapeContainerNode whose bounding box is dictated by a ShapeOutline. Children are clipped via ClipPolicy.CLIP_PATH (default), CLIP_BOUNDS, or OVERFLOW_VISIBLE. The ShapeContainerBuilder exposes the same nine-point alignment vocabulary as LayerStackBuilder plus position(node, dx, dy, anchor) for screen-space nudges.

.addContainer(
        ShapeOutline.RoundedRectangle.of(220, 140, 14),
        ClipPolicy.CLIP_PATH,
        DocumentColor.rgb(28, 31, 38),                       // background
        DocumentStroke.of(DocumentColor.rgb(196, 153, 76), 1.0),
        container -> container
                .center(centeredImage)                       // 9-point alignment
                .position(badge, 120, 18, Anchor.TOP_LEFT))  // pixel-precise

📄 View PDF · 📜 Full source

Transforms

DocumentTransform.rotate(deg) and .scale(uniform | sx, sy) — attached to any Transformable<T> builder (ShapeContainerBuilder, ShapeBuilder, LineBuilder, EllipseBuilder, ImageBuilder, BarcodeBuilder). Identity transforms emit no markers, so layout snapshots stay byte-identical to v1.4. Per-layer zIndex lets a layer declared earlier draw on top of layers declared later — LayerStackNode.Layer and shape-container layers both gain int zIndex (default 0).

.addCircle(60, ROYAL_BLUE, container -> container
        .rotate(15)
        .center(label))

.layer(redSquare,  Anchor.CENTER, /* zIndex */ 10)   // declared first, drawn on top
.layer(tealSquare, Anchor.CENTER)                    // declared second, drawn beneath

📄 View PDF · 📜 Full source

Vector paths (Bézier)

Free-form design shapes with native cubic Bézier curves through addPath(...): stroked waves, filled blobs, and mixed line/curve ribbons in one closed subpath. Curves render as native PDF curveTo operators — perfectly smooth at any zoom, no tessellation. Coordinates are normalized to the shape's box ((0,0) bottom-left, y up) and control points may overshoot it. Strokes can be dashed via dashed(on, off, ...) — the pattern follows the curve. SVG icons drop in through SvgPath.parse(d, viewBox...) + .svg(...), or whole files via SvgIcon.read(file) + addSvgIcon(icon, width) — multi-layer icons with group transforms and per-layer paints, all as native curves.

flow.addPath(path -> path
        .size(320, 60)
        .moveTo(0.0, 0.5)
        .curveTo(0.25, 1.0, 0.25, 0.0, 0.5, 0.5)
        .curveTo(0.75, 1.0, 0.75, 0.0, 1.0, 0.5)
        .stroke(DocumentStroke.of(accent, 2.4)));

📄 View PDF · 📜 Full source

SVG icon gallery

A stress-test sheet for the beta SVG reader: 34 real-world multicolour icons (svgrepo.com) parsed by SvgIcon.parse and presented as a tile grid — each icon centred on a rounded card with a label plaque across the bottom, every layer a native vector path. The entire icon set weighs 156 KB of .svg sources; the rendered page is a 70 KB PDF.

flow.addSvgIcon(SvgIcon.parse(readResource("/icons/apple.svg")), 50);

📄 View PDF · 📜 Full source

Block alignment

A fixed-size node (an SVG icon, a vector path, an image) left-aligns in the flow by default. addSvgIcon(icon, width, HorizontalAlign.CENTER) and the general addAligned(align, node) seat it left, centre, or right across the content width — the margin: auto the flow does not give fixed nodes on its own, with no manual width maths.

flow.addSvgIcon(icon, 44, HorizontalAlign.CENTER);
flow.addAligned(HorizontalAlign.RIGHT, anyFixedNode);

📄 View PDF · 📜 Full source

Advanced tables

DocumentTableCell.rowSpan(int) mirrors colSpan(int). TableBuilder.zebra(odd, even) paints alternating rows. totalRow(...) adds a bold-on-grey-blue totals row. repeatHeader() re-emits the leading rows on every continuation page when the table paginates.

table.columns(...)
        .headerRow("Item", "Description", "Qty", "Unit", "Amount")
        .repeatHeader()                                   // pinned on every page
        .zebra(zebraOdd, zebraEven)
        .row("Tall", "Spans 3 rows", "—", "—", "—") // colSpan(2).rowSpan(3) cell
        .row("…", …)
        .totalRow("", "", "", "Total", "GBP 1,960");

📄 View PDF · 📜 Full source

Custom Business Theme

Build a BusinessTheme from raw DocumentPalette / SpacingScale / TextScale / TablePreset records — no factory shortcut. Plug it straight into InvoiceTemplateV2 to retheme the whole template without touching any code that uses it.

BusinessTheme studioEmerald = new BusinessTheme(
        new DocumentPalette(/* page, surface, surfaceMuted, ink, accent, … */),
        SpacingScale.cinematic(),
        new TextScale(/* h1, h2, body, caption fonts … */),
        TablePreset.cinematic());

new InvoiceTemplateV2(studioEmerald).compose(document, invoice);

📄 View PDF · 📜 Full source

---

Public-API surface

Rich text

Every RichText method laid out as labelled rows on a single A4 page: plain, bold, italic, boldItalic, underline, strikethrough, color, accent, size, style, link, append. Use this as the visual reference when picking which call to make for inline text.

.addRich(rich -> rich
        .plain("Customer ")
        .bold("Northwind Systems")
        .plain(" placed order ")
        .accent("#GC-2026-041", BRAND_GOLD)
        .plain(" — see ")
        .link("invoice", "https://example.com/invoice/41")
        .plain("."))

📄 View PDF · 📜 Full source

Inline shapes

InlineShapeRun (@since 1.7.0) draws geometric figures on the text baseline from geometry — no font glyph needed — so rating dots, arrows, chevrons, diamonds, stars, checkmarks, checkboxes (checked / unchecked todo markers) and any other ShapeOutline work between text and as list bullets, at any size and colour. The tick and arrow designs are swappable via CheckmarkStyle / ArrowStyle.

.addRich(rich -> rich
        .plain("Draft ")
        .arrow(8, ShapeOutline.Direction.RIGHT, accent)
        .plain(" Review ")
        .arrow(8, ShapeOutline.Direction.RIGHT, accent)
        .plain(" Published"))
// also: dot(size, fill), diamond, triangle, star, chevron,
// checkbox(size, checked, color) for todo markers, and
// arrow(size, dir, ArrowStyle.TRIANGLE, fill) to pick a design variant

📄 View PDF · 📜 Full source

Section presets

pageBackground, band, softPanel, the four accentLeft / accentRight / accentTop / accentBottom strips, and per-corner DocumentCornerRadius (top, bottom, left, right, only(...)) rendered side-by-side as recipe cards.

.addSection("Hero", section -> section
        .softPanel(theme.palette().surfaceMuted(), 10, 18)
        .accentLeft(theme.palette().accent(), 4)
        .cornerRadius(DocumentCornerRadius.right(12))
        .addParagraph(p -> p.text("Hero block").textStyle(theme.text().h1())))

📄 View PDF · 📜 Full source

Barcodes

BarcodeBuilder with five symbology types — QR, Code 128, Code 39, EAN-13, EAN-8 — plus a branded QR using the active theme's foreground / background colours. ZXing is the encoder; the PDF backend rasterises and embeds.

.addBarcode(b -> b
        .symbology(BarcodeSymbology.QR_CODE)
        .data("https://github.com/DemchaAV/GraphCompose")
        .size(140, 140)
        .foreground(theme.palette().ink())
        .background(theme.palette().surface()))

📄 View PDF · 📜 Full source

Charts

Native vector charts compiled into engine primitives — deterministic, snapshot-testable, no raster dependency. Data, structure, and style are independent layers: the same ChartData feeds bar and line specs, and a ChartStyle cascade recolours a chart without touching its data.

ChartData revenue = ChartData.builder()
    .categories("Q1", "Q2", "Q3", "Q4")
    .series("2024", 12.4, 15.1, 9.8, 14.2)
    .series("2025", 14.0, 18.2, 11.3, 16.9)
    .build();

section.chart(ChartSpec.bar()
        .data(revenue)
        .legend(LegendPosition.BOTTOM)
        .valueLabels(ValueLabelMode.OUTSIDE)
        .size(ChartSize.aspectRatio(16, 7))
        .build(),
    ChartStyle.builder()
        .seriesPaint(0, DocumentPaint.solid(DocumentColor.rgb(20, 80, 95)))
        .barCornerRadius(DocumentCornerRadius.top(2))
        .build());

Axis numbers, grid lines, and category labels are independently toggleable (AxisSpec.showTickLabels(false), showGridLines(false), ChartSpec.bar().showCategoryLabels(false)) — down to a minimal "bars + value numbers only" look. Pie/donut charts (ChartSpec.pie().donutRatio(0.58).centerText("58.4k")) add slice labels, separators, pad-angle gaps, and a donut-centre KPI.

📄 View PDF · 📜 Full source

PDF chrome

Backend-neutral DocumentMetadata, DocumentWatermark, DocumentHeaderFooter (header + footer with {page} / {pages} / {date} tokens), and paragraph-level DocumentBookmarkOptions materialising as PDF outline entries.

GraphCompose.document(outputFile)
        .metadata(DocumentMetadata.builder()
                .title("Q1 2026 Investor Brief")
                .author("Mariia Demchyshyn")
                .build())
        .watermark(DocumentWatermark.draftStamp(theme.palette().muted()))
        .headerFooter(DocumentHeaderFooter.tokens("Q1 Brief", "Page {page} of {pages}"))
        .create();

📄 View PDF · 📜 Full source

---

Production patterns

HTTP streaming

writePdf(OutputStream) for Servlet / S3 / GCS adopters. The caller's stream is not closed by GraphCompose — pinned by HttpStreamingDemoTest. A Spring Boot @RestController snippet in the example javadoc shows the canonical wiring.

@GetMapping(value = "/invoice/{id}", produces = MediaType.APPLICATION_PDF_VALUE)
public ResponseEntity<StreamingResponseBody> invoice(@PathVariable Long id) {
    InvoiceDocumentSpec spec = invoiceService.loadInvoice(id);

    StreamingResponseBody body = response -> {
        try (DocumentSession document = GraphCompose.document()
                .pageSize(DocumentPageSize.A4)
                .pageBackground(BusinessTheme.modern().pageBackground())
                .margin(28, 28, 28, 28)
                .create()) {
            new InvoiceTemplateV2(BusinessTheme.modern()).compose(document, spec);
            document.writePdf(response);   // streams directly, no in-memory PDF
        }
    };

    return ResponseEntity.ok()
            .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=invoice.pdf")
            .body(body);
}

📄 View PDF · 📜 Full source

Word export (DOCX)

The semantic backend walks the document graph and writes editable Word content — no layout pass, no PDF chrome. One session, two outputs:

try (DocumentSession document = GraphCompose.document(pdfFile)
        .pageSize(595, 842)
        .margin(DocumentInsets.of(48))
        .create()) {
    document.metadata(DocumentMetadata.builder()
            .title("GraphCompose Word export companion")
            .author("GraphCompose").build());          // → Word core properties

    document.pageFlow().name("Flow")
            .addRich(rich -> rich.plain("Inline ").bold("runs").plain(" survive."))
            .addList(list -> list.markerFor(1, ListMarker.custom("◦"))
                    .addItem("Nested authoring", l1 -> l1
                            .addItem("Two spaces of indent per depth in Word")))
            .addTable(t -> t.headerRow("Quarter", "Revenue").row("Q1", "42"))
            .addSection("Chart", s -> s.chart(ChartSpec.bar().data(quarters).build()))
            .build();

    document.buildPdf();                                   // fixed-layout PDF
    document.export(new DocxSemanticBackend(), docxFile);  // editable Word file
}

Paragraphs (inline runs included), lists, tables, side-by-side rows, images, spacers, and page breaks map 1:1; session metadata lands in the Word core properties. Charts export as their categories-by-series data table (one capability warning per export), shape containers flatten to inline layers, and pure geometry — dividers, shapes, barcodes — stays PDF-only by design. Requires org.apache.poi:poi-ooxml on the classpath (the dependency is optional in the GraphCompose POM).

📄 View PDF · 📝 Word file · 📜 Full source

Layout snapshot regression

The full compose → layoutSnapshot() → LayoutSnapshotJson.toJson(...) workflow with a copy-and-paste baseline / drift report pattern, plus a pointer to the production LayoutSnapshotAssertions.assertMatches(document, "...") helper for in-test usage.

DocumentSession document = GraphCompose.document(outputFile)…create();
new InvoiceTemplateV2(theme).compose(document, spec);

String snapshot = LayoutSnapshotJson.toJson(document.layoutSnapshot());
String baseline = Files.readString(baselinePath);
if (!baseline.equals(snapshot)) {
    Files.writeString(driftPath, snapshot);
    throw new AssertionError("Layout drift detected — diff " + driftPath);
}
document.buildPdf();

📄 View PDF · 📜 Full source

Debug overlay

One switch turns the rendered sheet into a self-describing layout map: fragment boxes, dashed margin / padding guides, and a small purple label with each node's stable semantic path — the same path layoutSnapshot() reports. Spot a misplaced block on paper, read its label, then search that name in your builder code.

try (DocumentSession document = GraphCompose.document(outputFile)
        .debug(DocumentDebugOptions.guidesAndNodeLabels())
        .create()) {
    document.pageFlow(page -> page
            .module("InvoiceHeader", m -> m.paragraph("ACME Corp — Invoice 2026-104")));
    document.buildPdf();
}

Labels default to the compact own segment (InvoiceHeaderTitle[0]); DocumentDebugOptions.LabelText.FULL_PATH prints the whole ancestor chain instead. Debug overlays draw strictly on top of content and never affect measurement or pagination — disabling them returns the exact production bytes.

📄 View PDF · 📜 Full source

---

Operational documents

Weekly schedule

Bar / restaurant weekly shift schedule rendered through the canonical DSL via a reusable WeeklyScheduleRenderer. The renderer's typed API lets you express any combination of full-day status fills, half-day shifts (lunch / dinner), and cross-meal shifts without parsing strings:

import com.demcha.examples.support.WeeklyScheduleRenderer;
import com.demcha.examples.support.WeeklyScheduleRenderer.*;

private static final List<StaffMember> STAFF = List.of(
        new StaffMember("AARON PARK",  JobTitle.MANAGER),
        new StaffMember("DIANA COLE",  JobTitle.BARTENDER),
        new StaffMember("JASPER LIN",  JobTitle.BAR_BACK)
);

private static final Map<String, DayShift[]> SHIFTS = Map.ofEntries(
        Map.entry("AARON PARK", new DayShift[] {
                DayShift.acrossDay("09:00", "18:00", ShiftType.STOCK),  // Mon — stock recon all day
                DayShift.OFF,                                            // Tue
                DayShift.OFF,                                            // Wed
                DayShift.dinnerOnly("16:00", "00:00"),                   // Thu — dinner only
                DayShift.OFF,                                            // Fri
                DayShift.shifts("11:00", "16:00", "16:00", "22:00"),     // Sat — both halves
                DayShift.shifts("08:00", "13:00", "13:00", "18:00")      // Sun
        }),
        Map.entry("DIANA COLE", new DayShift[] {
                DayShift.halves(Half.shift("12:00", "20:00"), Half.STANDBY),
                // …
        })
);

WeeklyScheduleRenderer.renderTo(outputFile, "AURORA",
        LocalDate.of(2026, 5, 4), STAFF, WEEK, SHIFTS);

The renderer auto-fills the seven date labels from weekStart (Monday 4th / Tuesday 5th / …), sorts staff by JobTitle.ordinal() so groups appear in declared order, and emits a separator row at every job-title boundary so adding or removing a StaffMember never requires updating positional indices. The colour palette and column widths live behind Theme.aurora() and Layout.landscape() records, so reskinning is one parameter swap.

📄 View PDF · 📜 Example source · 📜 Renderer source

Business report cover

Single-page Q1 investor brief — top band identifier, serif headline, procedurally rendered hero image (Java Graphics2D PNG embedded via DocumentImageData.fromBytes(...)), three gold-ringed KPI cards, strategic-highlights bullet list paired with a five-quarter Revenue / Profit bar chart, YoY metrics table, and a confidential / page-number footer. Use this as the visual reference for landing-page hero shots.

📄 View PDF · 📜 Full source

Master showcase

Fictional "Q2 sample report" combining the canonical surface end-to-end: BusinessTheme + page background + hero with rotated shape container + branded QR + executive summary + zebra-striped totals table + accent-bordered highlight cards + Code 128 footer barcode. Reference it when composing your own multi-page documents.

📄 View PDF · 📜 Full source

---

Anatomy of an example

Every example file follows the same shape:

public final class FooExample {

    private static final BusinessTheme THEME = BusinessTheme.modern();
    // … more constants if useful …

    private FooExample() {
    }

    public static Path generate() throws Exception {
        Path outputFile = ExampleOutputPaths.prepare("foo.pdf");

        try (DocumentSession document = GraphCompose.document(outputFile)
                .pageSize(DocumentPageSize.A4)
                .pageBackground(THEME.pageBackground())
                .margin(28, 28, 28, 28)
                .create()) {

            document.pageFlow()
                    .name("Foo")
                    .spacing(12)
                    // … your composition …
                    .build();

            document.buildPdf();
        }

        return outputFile;
    }

    public static void main(String[] args) throws Exception {
        System.out.println("Generated: " + generate());
    }
}

This makes every example runnable on its own (main), callable from GenerateAllExamples (generate() returns the output path), and deterministic — the same data + same code always produces the same bytes (verified by LayoutSnapshotRegressionExample).

For the canonical authoring patterns — builder hierarchy, theme tokens, table presets, golden / anti-patterns, and a 40-line skeleton for new templates — read docs/templates/v1-classic/authoring.md once before writing your own.

Where things live

Path	What's there
examples/src/main/java/com/demcha/examples/	One file per example, runnable via main
examples/src/main/java/com/demcha/examples/support/	Reusable helpers (ExampleOutputPaths, WeeklyScheduleRenderer)
examples/target/generated-pdfs/	Output of running the examples (gitignored)
assets/readme/examples/	Committed PDF previews linked from this gallery
docs/templates/v1-classic/authoring.md	Template authoring cheatsheet
CHANGELOG.md	Per-version surface changes (every example link is current to v1.6)