Improve SEO, discoverability, and Skia PR visibility

- Expand README intro with "Kotlin JVM library", "PDF generation" keywords
- Add Maven Central badge to README
- Add "How it works" section explaining Skia SVG→PDFBox pipeline
- Reference JetBrains/skiko#775 (native PDF backend) in README and docs
- Expand POM description for better Maven Central search ranking
- Add SEO metadata to docs _config.yml (tagline, author, lang)
- Update docs homepage H1 to "compose2pdf — Kotlin PDF Library for Compose Desktop"
- Add "Future: native Skia PDF backend" section to architecture guide

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 2 people

README.md

@@ -1,9 +1,10 @@
 # Compose 2 PDF
 
 [![CI](https://github.com/chrisjenx/compose2pdf/actions/workflows/ci.yml/badge.svg)](https://github.com/chrisjenx/compose2pdf/actions/workflows/ci.yml)
+[![Maven Central](https://img.shields.io/maven-central/v/com.chrisjenx/compose2pdf)](https://central.sonatype.com/artifact/com.chrisjenx/compose2pdf)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 
-Render [Compose Desktop](https://www.jetbrains.com/compose-multiplatform/) content directly to PDF.
+A **Kotlin JVM library** for rendering [Compose Desktop](https://www.jetbrains.com/compose-multiplatform/) content directly to PDF. Generate production-quality PDF documents with vector text, embedded fonts, auto-pagination, and server-side streaming support.
 
 ```kotlin
 val pdfBytes = renderToPdf {
@@ -29,6 +30,7 @@ File("hello.pdf").writeBytes(pdfBytes)
 - **Auto-pagination** — content automatically flows across pages; elements are kept together at page boundaries
 - **Multi-page** — render multiple pages in a single PDF (manual or automatic)
 - **Page presets** — A4, Letter, A3 with configurable margins and landscape support
+- **Streaming output** — write PDFs directly to an `OutputStream` for Ktor, servlets, or any JVM server
 
 ## Installation
 
@@ -111,6 +113,17 @@ PdfLink(href = "https://example.com") {
 }
 ```
 
+## How it works
+
+compose2pdf renders Compose content through a **Skia SVGCanvas → Apache PDFBox** pipeline:
+
+1. Your `@Composable` content is rendered by Compose Desktop's layout engine
+2. Skia's SVGCanvas captures the draw calls as SVG
+3. compose2pdf converts the SVG to PDF vector commands via PDFBox
+4. Fonts are resolved, subsetted, and embedded; link annotations are mapped to PDF coordinates
+
+> **Want native PDF output from Skia?** The [Skiko PR #775](https://github.com/JetBrains/skiko/pull/775) proposes adding a direct PDF backend to Skia/Skiko, which would eliminate the SVG intermediary entirely — producing smaller files, faster rendering, and full gradient/effect support in vector mode. If this matters to you, upvote the PR!
+
 ## Documentation
 
 **[Full documentation](https://chrisjenx.github.io/compose2pdf/)** — getting started, usage guides, API reference, examples, and more.

compose2pdf/build.gradle.kts

@@ -27,7 +27,10 @@ mavenPublishing {
     coordinates("com.chrisjenx", "compose2pdf", version.toString())
     pom {
         name.set("compose2pdf")
-        description.set("Render Compose Desktop content to PDF")
+        description.set(
+            "Kotlin JVM library for rendering Compose Desktop content to production-quality PDFs " +
+                "with vector text, embedded fonts, auto-pagination, and server-side streaming support."
+        )
         url.set("https://github.com/chrisjenx/compose2pdf")
         licenses {
             license {

docs/_config.yml

@@ -1,6 +1,9 @@
 title: compose2pdf
-description: Render Compose Desktop content directly to PDF
+description: "Kotlin JVM library for rendering Compose Desktop content to production-quality PDFs with vector text, embedded fonts, auto-pagination, and server-side streaming."
+tagline: "Kotlin PDF library for Compose Desktop"
 remote_theme: just-the-docs/just-the-docs@v0.10.0
+author: Christopher Jenkins
+lang: en
 
 url: "https://chrisjenx.github.io"
 baseurl: "/compose2pdf"

docs/guides/architecture.md

@@ -132,6 +132,27 @@ PDFBox's `PDType0Font.load()` automatically subsets embedded fonts -- only the g
 
 ---
 
+## Future: native Skia PDF backend
+
+The current vector pipeline goes through an SVG intermediary: **Compose → Skia Picture → SVGCanvas → SVG string → XML parse → PDFBox commands**. This works well but introduces inherent limitations — gradients and some visual effects don't survive the SVG round-trip.
+
+[**Skiko PR #775**](https://github.com/JetBrains/skiko/pull/775) proposes adding a thin wrapper around Skia's native PDF backend (`SkDocument`). If merged, this would enable a much simpler pipeline:
+
+```
+Current:  Compose → Skia → SVG → parse → PDFBox → PDF
+Future:   Compose → Skia → PDF (direct)
+```
+
+Benefits of the native PDF backend:
+- **Full visual fidelity** — gradients, shadows, blur, and all Skia effects preserved
+- **Faster rendering** — no SVG serialization/parsing overhead
+- **Smaller file sizes** — Skia's PDF backend is optimized for compactness
+- **Simpler codebase** — eliminates SvgToPdfConverter, SvgPathParser, SvgColorParser, CoordinateTransform
+
+If native PDF rendering in Compose Desktop matters to you, please upvote [JetBrains/skiko#775](https://github.com/JetBrains/skiko/pull/775).
+
+---
+
 ## See also
 
 - [Vector vs Raster]({{ site.baseurl }}/usage/vector-vs-raster) -- User-facing comparison

docs/index.md

@@ -2,11 +2,12 @@
 title: Home
 layout: home
 nav_order: 1
+description: "Kotlin JVM library for PDF generation from Compose Desktop — vector text, embedded fonts, auto-pagination, and server-side streaming with Ktor."
 ---
 
-# compose2pdf
+# compose2pdf — Kotlin PDF Library for Compose Desktop
 
-**Render Compose Desktop content directly to PDF** -- vector text, embedded fonts, and page-perfect layout.
+**Generate production-quality PDFs from Compose Desktop content** — vector text, embedded fonts, auto-pagination, and server-side streaming. A Kotlin JVM library that turns your `@Composable` functions into PDF documents.
 {: .fs-6 .fw-300 }
 
 [Get Started]({{ site.baseurl }}/getting-started){: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 }
@@ -78,13 +79,24 @@ No new DSL to learn. Write `@Composable` functions, pass them to `renderToPdf()`
 | **Raster fallback** | Pixel-perfect rendering as an embedded image |
 | **Font embedding** | Bundled Inter fonts or system font resolution with automatic subsetting |
 | **Link annotations** | Clickable URLs in the PDF via `PdfLink` |
-| **Multi-page** | Render multiple pages in a single PDF |
+| **Auto-pagination** | Content automatically flows across pages; elements kept together at boundaries |
+| **Multi-page** | Render multiple pages in a single PDF (automatic or manual) |
+| **Streaming output** | Write PDFs directly to an `OutputStream` for Ktor, servlets, or files |
 | **Page presets** | A4, Letter, A3 with configurable margins and landscape support |
 | **Shapes** | Backgrounds, borders, clips, rounded corners, Canvas drawing |
 | **Images** | Embed bitmap images with clipping and layout |
 
 ---
 
+## How it works
+
+compose2pdf renders your Compose content through a **Skia SVGCanvas → Apache PDFBox** pipeline. Compose Desktop's layout engine runs your composables, Skia captures the draw calls as SVG, and compose2pdf converts that to vector PDF commands with embedded fonts and link annotations.
+
+{: .note }
+**Want native PDF output from Skia?** [Skiko PR #775](https://github.com/JetBrains/skiko/pull/775) proposes adding a direct PDF backend to Skia/Skiko. This would eliminate the SVG intermediary — faster rendering, smaller files, and full gradient/effect support in vector mode. If this matters to you, upvote the PR!
+
+---
+
 ## Requirements
 
 - **JDK 17** or later