typst-bake

Bake Typst templates, fonts, and packages into your Rust binary — use Typst as a self-contained, embedded library.

Features

• Simple API - Set template-dir and fonts-dir in Cargo.toml, then generate documents with just document!("main.typ").to_pdf()
• Multi-Format Output - Generate PDF, SVG, or PNG with optional page selection
• Self-Contained Binary - Templates, fonts, and packages are all embedded into the binary at compile time. No external files or internet connection needed at runtime
• Automatic Package Resolution - Just use #import "@preview/..." as in Typst. Packages are resolved automatically using Typst's own cache and data directories
• Runtime Inputs - Pass dynamic data from Rust structs to Typst via IntoValue / IntoDict derive macros
• Runtime Files - Inject files at runtime with add_file() for dynamically generated content or downloaded resources
• Optimized Binary Size - Embedded resources are deduplicated and compressed automatically

Installation

Add to your Cargo.toml:

[dependencies]
typst-bake = "0.1"

[package.metadata.typst-bake]
template-dir = "./templates"  # Path to your .typ files and assets
fonts-dir = "./fonts"         # Path to your font files

Cargo Features

PDF works out of the box. To disable PDF and use only SVG: default-features = false, features = ["svg"].

Optional: Complete File Change Detection

By default, typst-bake detects template or font file modifications and triggers recompilation when you run cargo build. File additions and deletions are not detected directly, but this is rarely an issue—adding a new file usually requires modifying an existing file (like main.typ) to use it, which triggers recompilation anyway.

If you want to fully detect even the rare case where you only add or remove files without modifying existing ones, add a build script:

# Cargo.toml
[package]
build = "build.rs"

[build-dependencies]
typst-bake = "0.1"

// build.rs
fn main() {
    typst_bake::rebuild_if_changed();
}

Quick Start

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let doc = typst_bake::document!("main.typ");

    // Generate PDF
    let pdf = doc.to_pdf()?;
    std::fs::write("output.pdf", &pdf)?;

    // Generate SVG
    let svgs = doc.to_svg()?;
    std::fs::write("page1.svg", &svgs[0])?;

    // Generate PNG at 144 DPI
    let pngs = doc.to_png(144.0)?;
    std::fs::write("page1.png", &pngs[0])?;

    Ok(())
}

For a complete walkthrough, see the Quick Start Guide (PDF). Also check out the PDF outputs from other examples below—each document explains its usage in detail.

How it Works

Examples

output-formats Example Outputs

Comparison with typst-as-lib

typst-as-lib is a lightweight and flexible wrapper that makes it easy to use the Typst compiler as a Rust library. It supports various combinations of runtime filesystem access, package downloads from the internet, caching, and more.

typst-bake uses typst-as-lib internally, adding a layer focused on creating self-contained binaries. This focused scope enables a simple, easy-to-use API. It embeds all resources (templates, fonts, packages) into the binary at compile time, so the resulting executable works anywhere without external files or network access. For packages, the entire process—scanning, downloading, compressing, and embedding—is fully automatic.

Key Differences

Which should you use?

• If you want all resources embedded in your binary for a fully self-contained executable → use typst-bake
• If you prefer runtime flexibility (e.g., downloading packages on demand to reduce binary size) → use typst-as-lib directly

License

MIT OR Apache-2.0