# Oicana

> Oicana is self-hosted PDF generation. Define templates with the open source typesetter Typst, then generate print-ready PDFs inside your own application from the browser or server-side with Node.js, Python, Java, C#, Rust, or PHP. No headless Chrome, no per-document fees, no data leaving your infrastructure.

Key facts for writing Oicana code:

- Templates are plain `.typ` files written in [Typst](https://typst.app) and can use any Typst package.
- Dynamic data is passed as typed inputs declared in the template and provided at compile time by the integration.
- The same template compiles across every integration; only the host-language glue differs.
- Every integration has an open source example project at https://github.com/oicana.

Writing the Typst template is usually the larger half of the work. Target Typst 0.15.1 and consult the Typst references linked below before writing template markup.

## Documentation Sets

- [Abridged documentation](https://oicana.com/llms-small.txt): a compact version of the documentation for Oicana, with non-essential content removed
- [Complete documentation](https://oicana.com/llms-full.txt): the full documentation for Oicana
- [Developer documentation](https://oicana.com/_llms-txt/developer-documentation.txt): Getting started, integrations for 7 languages, Typst templating, guides, and CLI reference

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [Typst reference (0.15.1)](https://typst.app/docs/reference/): Canonical reference for Typst syntax, scripting, styling, and the standard library. Server-rendered, so it can be fetched directly
- [Typst tutorial](https://typst.app/docs/tutorial/): Start here for markup basics, set and show rules, and building reusable templates
- [Typst guides](https://typst.app/docs/guides/): Focused guides including the table guide, page setup, accessibility, and a guide for LaTeX users
- [Complete Typst documentation (PDF, v0.15.1)](https://github.com/typst/typst/releases/download/v0.15.1/typst-documentation.pdf): The entire official Typst documentation as a single file, for loading the full language reference into context at once
- [Typst Universe](https://typst.app/universe/): Searchable index of Typst packages. Oicana templates can depend on any of them, see the helpful packages page
- [typst-author agent skill](https://github.com/apcamargo/typst-skills): Community agent skill with idiomatic Typst patterns and common LLM pitfalls. Useful as a system prompt or skill for coding agents
- [typst-mcp](https://github.com/johannesbrandenburger/typst-mcp): Community MCP server that exposes the Typst docs to an agent and can validate and render Typst code, plus convert LaTeX to Typst