Authoritative, versioned PDF facts contract for Print with Synergy tools.
codex-pdf is a read-only extraction engine that publishes a stable CodexDocument contract. Downstream systems consume canonical PDF facts without re-parsing files in multiple codepaths.
- Contract-first JSON output rooted at CodexDocument
- Schema-validated payloads with SemVer compatibility policy
- CLI workflows for extract, probe, validate, and parity
- Consumer-agnostic output for adapters and downstream engines
- AGPL open source with typed Python models
Embeddable PDF viewer with separations, TAC, layers, and annotation overlays.
lens-pdf is a browser-native review surface for print workflows. It consumes PDF data and service adapters to give reviewers high-fidelity visual tooling in web apps.
- Embeddable React viewer architecture
- Separations, TAC, layers, and review tools
- Plugin and theming support for host products
Detection-only PDF preflight engine with deep standards coverage.
lint-pdf checks document conformance and quality against preflight rulesets while preserving original files.
- 500+ checks across common production concerns
- PDF/X-focused conformance workflows
- CLI and API service integration options
The only writer in the stack — trap, impose, marks, and rewrite.
compile-pdf is the producer side of the printwithsynergy family. It consumes codex signals to drive trapping zone detection, spot-color neutral density, and page geometry — then rewrites PDFs with full SHA-256 lineage.
- Four producers: trap, impose, marks, rewrite
- Reads codex trap_zone_candidates and spot Lab values
- Byte-deterministic output with lineage tracking
- CJD orchestrator sequences all four producers in one job
PDF assay and metadata reporting for structural inventory.
assay-pdf inventories what's in a PDF so downstream engines can validate, compare, and reason over document structure reliably.
- Per-page and document-level inventories
- Font, color, image, and structure reporting
- Schema-friendly output for downstream tools
WYSIWYG canvas editor for label and packaging artwork — PDF/X-4 output, flexo support, and a full create-to-RIP workflow.
artwork-pdf is an embeddable canvas editor for label and packaging artwork. It outputs PDF/X-4 via Ghostscript, handles flexo distortion compensation per separation, parses CF2/DDES/ARD dielines, and supports Pantone, white ink, and varnish as named separations. Self-hostable via Docker Compose.
- PDF/X-4 output via Ghostscript — print-ready from first render
- Flexo distortion compensation per separation — automatic plate correction
- CF2, DDES, and ARD dieline format support
- Pantone, white ink, and varnish as named separations with preview thumbnails
- Embeddable as @printwithsynergy/artwork-pdf-editor — Docker Compose self-hosting
API-first PDF workflow engine — DAG workflows via REST + SSE, orchestrating the full PWS stack.
synergy is the headless workflow engine that orchestrates codex-pdf, lint-pdf, compile-pdf, and lens-pdf into versioned, replayable, multi-tenant DAG workflows. Submit jobs via REST, stream results via SSE, and deploy on Docker Compose or Railway in 15 minutes.
- Versioned immutable DAGs — dry-run, replay with overrides, compare runs
- Node families: io, codex, lint, compile, lens, assay, route, flow, notify, util, mis
- Per-job SSE stream + per-tenant stream — reconnect-safe via Last-Event-ID
- Auth: API key, OIDC, OAuth 2.0, JWT RS256
- OpenAPI spec — TypeScript and Python clients generated in CI
