Fullbleed PDF Engine

Fullbleed PDF Engine

Generate PDFs from HTML/CSS in Python, Rust, JavaScript, and C#. MIT licensed.

Build invoices, reports, statements, and variable-data print jobs with a deterministic Rust engine. Use the native Rust API, the Python package, or the optional JavaScript and .NET integrations. The Python wheel includes the engine, fonts, and CLI with no required third-party Python packages or system PDF stack. The JavaScript package includes the WebAssembly engine and fonts for Node.js and browser workers; the .NET package includes native libraries for in-process rendering.

Try your own document · Documentation · Examples · PyPI · crates.io · npm · Release notes · MIT license

Actual Fullbleed output. Open either preview for its PDF, or explore the designed examples with HTML/CSS, data, and font setup.

Compare both designs in HTML/CSS and Python components, with matching page output and runnable source. The component versions use the opt-in 2.6 alpha.

Choose your language

The language packages release independently. The Node quickstart, browser guide and C# quickstart record the tested package and engine versions; downloadable starters pin their dependencies.

JavaScript applications can export styled or unstyled component HTML and generate PDFs and previews. Import fullbleed in Node or fullbleed/browser in a web app. Node applications can use a bounded render queue and optional process isolation.

FullBleed.DotNet's managed library targets .NET 8 and works with .NET 8, 9, and 10 applications. It includes C# components, native rendering, compiled bindings and previews. Its separate CLI adapter requires the Python CLI. The Python package provides the complete CLI, including compiled variable-data jobs and print profiles; the Rust guide covers the native API.

Your first PDF

Start in the HTML/CSS playground with a designed invoice or report, or choose Open local files to use your own HTML, CSS, images, and fonts. Rendering runs locally in your browser, with no account or document upload.

Download the PDF, or select Python or Node.js under Project language and choose Download project. The ZIP includes your source, assets, fonts, licenses, pinned dependencies, and a script to render the document locally.

Keep the ZIP unchanged, then choose Open saved project in the playground to continue editing on a later visit.

If the output needs work, report a rendering problem with a small example using data and assets you can share publicly. For a guided Python walkthrough, use the notebook in Colab, or start with a local script below.

Python

Python 3.10–3.15 on Windows, macOS, or Linux:

python -m pip install fullbleed

Save this as hello.py, then run python hello.py:

from pathlib import Path

import fullbleed

html = " Invoice INV-1042 Consulting: USD 1,200.00 " css = "@page { size: A4; margin: 20mm; } h1 { color: #175c52; }" pdf = fullbleed.PdfEngine().render_pdf(html, css) Path("invoice.pdf").write_bytes(pdf)

Open invoice.pdf. The quickstart adds fonts, previews, and a complete project. The runnable source is in examples/quickstart/hello.py.

Node.js

Use Node.js 22 or newer. Run npm install fullbleed, save this as invoice.mjs, then run node invoice.mjs:

import { writeFile } from 'node:fs/promises';

import { renderPdf } from 'fullbleed';

const result = await renderPdf({ html: ' Invoice INV-1042 Consulting: USD 1,200.00 ', css: '@page { size: A4; margin: 20mm } h1 { color: #175c52 }', previewDpi: 96, }); await writeFile('invoice.pdf', result.pdf); await writeFile('invoice.png', result.previews[0]);

Open invoice.pdf or its PNG preview. The Node.js quickstart includes a downloadable designed invoice project. The separate Node package supports ESM, CommonJS, and TypeScript. For an application route, use the Next.js starter.

Browser JavaScript

Try the editable browser app to generate an invoice or report, change its HTML/CSS, and download the PDF. Rendering runs locally in a Web Worker; the starter does not upload document inputs to a rendering service.

To build on it, download the complete project. Extract the ZIP, open a terminal in fullbleed-browser-starter, and use Node.js 22.12 or newer for the development tools:

npm ci

npm run dev

Open the localhost URL printed by Vite. The browser guide explains adding fullbleed/browser to an existing app, serving its runtime assets over HTTPS or localhost, cancellation, custom fonts, and static deployment. This renders supplied static HTML/CSS; it does not capture a live browser page.

Rust

Start with the native Rust quickstart. The fullbleed crate exposes FullBleed::builder() and render_to_buffer(...), with no Python requirement. The guide includes runnable invoice and report examples with explicit fonts and PNG previews, plus the latest hosted Rust API reference.

C# and .NET

Install FullBleed.DotNet in a .NET 8, 9, or 10 project and follow the C# quickstart. Compose documents with ordinary methods, LINQ children and immutable style objects. The component guide explains WithClass, attached stylesheets and inline overrides and includes a complete invoice download with explicit fonts. Existing HTML/CSS templates remain supported. Native rendering runs inside the .NET process on Windows x64, Linux x64, Intel macOS, and Apple Silicon macOS, without a Python or browser runtime.

Author with reusable components

Components are another way to author the same print documents. Use ordinary functions, children and reusable styles instead of writing HTML strings:

• Python components and styling — the stable fullbleed.ui API includes function components, class_name and document stylesheets.
• JavaScript functions and JSX/TSX — try the live invoice or customize the React starter.
• C# components and styles — compose documents with typed methods, LINQ and immutable styles.

Python release channels

The component API remains experimental: independent-kit integration and independent author feedback still need to be settled. fullbleed.components is the intended public namespace for the 2.6 API. Existing fullbleed.ui imports remain supported, and earlier alpha imports from fullbleed.ui.experimental expose the same objects. See the release-status review and graduation criteria or read the current component guide. The language packages have their own versions and API coverage.

The alpha also adds native PDF links for both HTML and component authors, including internal destinations and wrapped links. This navigation work is separate from the stable 2.5 API and requires alpha 14 rather than an earlier alpha kit.

The complete-document migration guide maps styles, page geometry, metadata, fonts and renderer options from the existing API. Its paired portrait and landscape reports preserve PDF text and rendered output. Both styled and unstyled HTML exports remain available.

Choose your starting point

| Distinctive invoices, reports, notices, and statements | [Designed showcase with fonts and source](https://docs.fullbleed.dev