Documentation
LintPDF docs
Detection-only PDF preflight with 500+ checks plus the PDF/X-4 conformance suite. Sourced live from the lint-pdf engine repo — edits there appear here within minutes.
Getting started
Overview
LintPDF is the OSS preflight engine that powers the hosted SaaS at lintpdf.com. The hosted product layers multi-tenancy, billing, white-label reports, and an admin console on top of this engine; the OSS package is the engine plus a…
Deployment
Self-hosting reference for the LintPDF OSS engine — environment variables, supporting services, Docker / Railway / single-node topology, and the OSS-mode hard-fail toggles.
Architecture
Component layout, request flow through the API and Celery worker, the three-scope toggle cascade, snapshot recording, and the AI-tier model that gates which analyzers run.
Reference
Extending the engine
How to override the engine's service seams (email, entitlements, billing, auth) and a quick-reference walkthrough for authoring analyzer plugins via the lintpdf.plugins entry point.
Plugin API
Full Protocol reference for analyzer plugins — manifest fields, AnalyzerContext shape, banned imports policed by the engine-purity tripwire, capability providers, and tier guidance for CPU / GPU / external-AI analyzers.
PDF Data Requirements
Exhaustive reference of every piece of PDF data the engine needs to run 100% of its checks — CPU, GPU, and AI tiers.
SDK contract
Cross-language SDK contract — transport rules, security primitives (webhook signing, share-link tokens), and the type surface every official LintPDF SDK must implement.
Rulesets and profiles
Built-in profiles (GWG 2022, PDF/X-4, ECG, HP Indigo EPM, ISO 12647) and the JSON schema for authoring custom rulesets — enabled / disabled checks, severity overrides, and tunable thresholds.
HTTP API
Reference for the engine's HTTP surface — 91 routes across job submission, results, reports, viewer payloads, AI explain, decisions audit, profile catalogue, and batch jobs. The OpenAPI spec is the single source of truth.
External preflight imports
Import third-party preflight reports (Enfocus PitStop, callas pdfToolbox, Adobe Acrobat Pro Preflight) so their findings join LintPDF's output — useful for vendor-neutral consolidated reporting.
Preflight capability map
What the lint-pdf engine detects today across print production, packaging, accessibility/PDF-UA, and AI regulatory checks — mapped to the built-in profiles that enable each surface.
Project
Contributing
Dev environment setup, sign-off and DCO, test conventions, commit / PR style, and the engine-purity tripwire that gates every analyzer change.
Licensing
AGPL-3.0+ terms for the LintPDF OSS engine, what self-hosting and modification mean in practice, and how to obtain a commercial license for proprietary or embedded use.
Security
Vulnerability disclosure process, supported versions, the engine's security model (sandboxing, untrusted PDF handling, AGPL-aware reporting), and where to send a security report.
Service ownership contract
Ownership boundaries across loupe-pdf (display and visual inspection UX), lint-pdf (reporting, policy/rules, preflight workflow orchestration), and codex-pdf (extraction and normalized document intelligence).