Introduction

Oicana offers seamless PDF templating across multiple platforms. Define templates using the modern and open source typesetter Typst. Then specify dynamic inputs and generate high quality PDFs from any environment - whether it’s a web browser, server application, or desktop software.

What Oicana offers

• Runs in your infrastructure: PDFs are generated inside your own application. No data is sent to a third-party service.
• Multi-platform: the same template works in the browser, Node.js, C#, Java, Rust, Python, and PHP.
• Powerful layouting: templates have all of Typst, including its package ecosystem.
• Performant: a warmed up template renders a PDF in single-digit milliseconds.
• AI and version control ready: templates are text files. They live next to your code, and AI can help write them.
• No proprietary format: templates are plain Typst projects. The Typst compiler is open source.

The Typst version behind Oicana

Oicana compiles templates with a patched Typst 0.15.1. Everything that version of Typst supports, your templates can use: its syntax, its standard library, and any package on Typst Universe that works with that version. The patch adds support for custom PDF metadata, which is what lets Oicana write the XMP an e-invoice needs.

The oicana Typst package your templates import (@preview/oicana:0.2.0) is versioned separately from the integrations and the CLI.