Add GitHub Pages showcase

Author: DemchaAV

README.md

@@ -18,6 +18,10 @@
   </a>
 </p>
 
+<p align="center">
+  <a href="https://demchaav.github.io/GraphCompose/"><b>View Live Showcase</b></a>
+</p>
+
 ## Why GraphCompose?
 
 Most Java PDF libraries hand you low-level drawing commands. GraphCompose gives Java applications a **semantic authoring model** &mdash; you describe modules, paragraphs, tables, rows, layers, and themes; the engine measures, paginates, and renders.

docs/README.md

@@ -0,0 +1,51 @@
+# 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.
+
+## 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"
+}
+```
+
+## Local Preview
+
+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.
+
+## GitHub Pages
+
+To publish this site with GitHub Pages:
+
+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.
+
+The site should become available at:
+
+https://demchaav.github.io/GraphCompose/

docs/assets/logo/graphcompose-logo.png

@@ -0,0 +1,50 @@
+[
+  {
+    "title": "Cinematic Invoice",
+    "description": "A polished invoice template with semantic sections, theme-driven layout, advanced tables, and totals.",
+    "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"
+  },
+  {
+    "title": "Business Proposal",
+    "description": "A multi-section proposal layout using cinematic panels, typography, and reusable document structure.",
+    "tags": ["Template", "Sections", "Layout"],
+    "image": "assets/screenshots/proposal-v2.png",
+    "pdf": "assets/pdf/proposal-v2.pdf",
+    "code": "https://github.com/DemchaAV/GraphCompose/blob/main/examples/src/main/java/com/demcha/examples/ProposalCinematicFileExample.java"
+  },
+  {
+    "title": "CV Template",
+    "description": "A compact CV render from the canonical template surface, driven by structured profile data.",
+    "tags": ["Template", "CV", "Semantic Data"],
+    "image": "assets/screenshots/cv-template.png",
+    "pdf": "assets/pdf/cv-template.pdf",
+    "code": "https://github.com/DemchaAV/GraphCompose/blob/main/examples/src/main/java/com/demcha/examples/CvFileExample.java"
+  },
+  {
+    "title": "Advanced Tables",
+    "description": "Table rendering with row spans, repeating headers, zebra rows, totals, and structured layout behavior.",
+    "tags": ["Tables", "Pagination", "PDF"],
+    "image": "assets/screenshots/advanced-table.png",
+    "pdf": "assets/pdf/advanced-table.pdf",
+    "code": "https://github.com/DemchaAV/GraphCompose/blob/main/examples/src/main/java/com/demcha/examples/TableAdvancedExample.java"
+  },
+  {
+    "title": "Layers and Transforms",
+    "description": "Layered visual composition with rotate, scale, z-index ordering, and PDFBox-backed rendering.",
+    "tags": ["Layers", "Transforms", "Visual Layer"],
+    "image": "assets/screenshots/layers-theme.png",
+    "pdf": "assets/pdf/layers-theme.pdf",
+    "code": "https://github.com/DemchaAV/GraphCompose/blob/main/examples/src/main/java/com/demcha/examples/TransformsExample.java"
+  },
+  {
+    "title": "Shape Containers",
+    "description": "Visual containers with clipping behavior, rounded shapes, and layout-aware content composition.",
+    "tags": ["Shapes", "Containers", "Visual Layer"],
+    "image": "assets/screenshots/shape-container.png",
+    "pdf": "assets/pdf/shape-container.pdf",
+    "code": "https://github.com/DemchaAV/GraphCompose/blob/main/examples/src/main/java/com/demcha/examples/ShapeContainerExample.java"
+  }
+]