Typstatic

A programmatic static site generator

The drawing ‘Perspective of the Regular Bodies: III’ by Wentzel Jamnitzer (1568) Page status: budding
Contents

Typstatic is pre-alpha!
Everything changes all the time, everything breaks all the time, and most of the time nobody tells you anything about that. Just like life.
Be patient: it’s in development (2026-08) even if this website is very fragmentary, often broken, and sometimes misleading because it presents out-of-date information.
When Typstatic is ready for public use it will be announced on the forum and this message will be removed.

Typst is a typesetting system that allows interweaving text and code in a manner that allows great flexibility in document production.

Typstatic is a static site generator that is fully written in Typst and takes Typst files as its input (i.e. the site’s content). It allows you not only to write complex (as well as simple…) websites, tailored to your needs and preferences, but also doing so while taking full advantage of Typst’s advance features, like programmatic production of output and a plethora of ready-made packages. For more information about the project, see the meta page; for related tools, see the dedicated page.

Get started by reading the manual. Everything is plainly explained there.

Quick start

Install Typst (and optionally JustJust is just for ease of use. You can run the commands from justfile manually, or use make if you don’t have just installed on your system.).
Create a new site using the template (typst init @preview/typstatic:0.1.0) and change directory to the newly-created directory (cd typstatic).
Launch a local server with just or make.
Open http://127.0.0.1:3000 in your browser.If another address is shown after serving at (for example, if port 3000 is occupied), use it instead.
Start editing the files. When you save a file the browser immediately reflects the change
Publish by syncing the output directory (/tmp/typstatic/ by default) to your web server.

Features

Write your pages in Typst. Everything is scriptable, including page content, and you can benefit from Typst’s vast package repository.
Produce HTML and PDF files from the same source files.
Create versatile websites — blogs, wikis, digital gardens, microsites, etc. — without any compromise.
Enjoy interconnectivity and taxonomy through internal links, backlinks and tags.
Celebrate linguistic diversity with integrated multilingual site support.
Much more (feature list), and more to come (roadmap).

Demo

The very website you read right now has been generated by Typstatic, so you’ve already seen a demo! It’s source files are available on the Git repositories. Since PDF files can be produced from the same source files, have a look at this PDF file which contains all of the pages on this website, as if they make a book.

If you are looking for something more minimal, here is a mock website that demonstrates the system’s abilities concisely, without a lot of text:

A live demo of the default theme, tufte-css. See also the PDF file produced using the corresponding paged theme, tufte-memo.
A live demo of an extremely minimalist theme with almost no CSS styling, no-styling. See also the PDF file produced using the corresponding paged theme, typst-defaults.
Source files (changing themes is easy and involves changing one line of configuration).

Past, present and future versions

For version history so far, see the changelog.

The current version is 0.1.0 (first public release).

If you are interested in what’s planned, see the roadmap. If you wish to implement features from the roadmap and send a patch this is very kind of you, but I’d recommend dropping me a message in order to make sure I’m not working on them already.

Showcase

Except for the website you are reading right now, there are no other websites that use Typstatic at the moment, at least none that I know of.I (Eîar, who made Typstatic) plan to convert my website, which currently is generated using Pollen. In fact, this is my main motivation behind making Typstatic in the first place… If you made something with Typstatic, no matter how small or large, please contact me and I’d be happy to add a link to it here