https://github.com/loqusion/typix
Deterministic Typst compilation with Nix
https://github.com/loqusion/typix
nix typst
Last synced: 30 days ago
JSON representation
Deterministic Typst compilation with Nix
- Host: GitHub
- URL: https://github.com/loqusion/typix
- Owner: loqusion
- License: mit
- Created: 2023-12-24T03:37:43.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-07T08:51:26.000Z (about 1 month ago)
- Last Synced: 2026-02-07T18:15:29.231Z (about 1 month ago)
- Topics: nix, typst
- Language: Nix
- Homepage: https://loqusion.github.io/typix/
- Size: 737 KB
- Stars: 293
- Watchers: 3
- Forks: 12
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-typst - Typix - Deterministic Typst compilation with Nix (Integrations & Tools / Programming)
- best-of-nix - GitHub - 23% open · ⏱️ 22.10.2025) (Development)
README
Typix
Typix aims to make it easier to use [Nix](https://nixos.org/) in
[Typst](https://github.com/typst/typst) projects.
- **Dependency management**: supports arbitrary dependencies including fonts,
images, and data
- **Reproducible**: via a hermetically sealed build environment
- **Extensible**: full support for [Typst packages](https://loqusion.github.io/typix/recipes/using-typst-packages.html)
## Features
- Automatically fetch dependencies and compile in a single command (`nix run
.#build`)
- Watch input files and recompile on changes (`nix run .#watch`)
- Set up a shell environment with all dependencies made available via
environment variables and symlinks
- Extensible via
[`mkTypstDerivation`](https://loqusion.github.io/typix/api/derivations/mk-typst-derivation.html)
- Support for dependencies such as [fonts](https://typst.app/docs/reference/text/text/#parameters-font),
[images](https://typst.app/docs/reference/visualize/image/), and [data](https://typst.app/docs/reference/data-loading/)
- [Typst packages](https://loqusion.github.io/typix/recipes/using-typst-packages.html)
fetched from the official Typst packages CDN
## Getting Started
After [installing Nix](https://github.com/DeterminateSystems/nix-installer) and
[enabling
flakes](https://nixos.wiki/wiki/Flakes#Enable_flakes_permanently_in_NixOS), you
can initialize a flake from the default template:
```bash
nix flake init --refresh -t github:loqusion/typix
```
> Alternatively, you can use a template demonstrating [Typst packages](https://loqusion.github.io/typix/recipes/using-typst-packages.html)
> usage:
>
> ```bash
> nix flake init --refresh -t 'github:loqusion/typix#with-typst-packages'
> ```
Here are some commands you can run from any template:
- `nix run .#watch` — watch the input files and recompile on changes
- `nix run .#build` — compile and copy the output to the current directory
---
For more information, check out [the docs](https://loqusion.github.io/typix/).