Core concepts
A project holds your document’s files
Section titled “A project holds your document’s files”A project contains Typst source (.typ files) and any images, bibliography files, or other assets your document uses. A dashboard folder organizes projects; a directory inside a project organizes its files.
The main file is the entry point used to compile the document. It is often main.typ. Opening another source file for editing does not necessarily make that file the entry point.
Use #include "chapter.typ" to bring another file’s content into the main document. Use #import to load reusable definitions, such as functions from a package.
Source, preview, and export
Section titled “Source, preview, and export”- Source is the editable Typst text.
- Preview is the typeset result shown in Tylor.
- PDF export is a downloadable document for readers.
- Project ZIP contains editable files for backup or transfer.
After a compilation error, the preview can still show the last successful result. Always resolve errors before treating the preview or an export as your final document.
Saving and history are different
Section titled “Saving and history are different”Automatic saving records your current work. History records checkpoints you can inspect or restore. A downloaded backup gives you a separate copy outside the workspace.
In account mode, a change can be saved on your device while still waiting to reach the server. See saving and offline use.
Packages provide reusable code
Section titled “Packages provide reusable code”Typst Universe packages use @preview/name:version. Your own packages use @local/name:version.
A document may have an independent package snapshot under This project. That snapshot takes precedence over a matching version in My library. This lets a personal copy keep the package versions it needs.
Local and account workspaces
Section titled “Local and account workspaces”| Capability | Local mode | Account with server |
|---|---|---|
| Edit and preview documents | Yes | Yes |
| Download PDF and project ZIP | Yes | Yes |
| Store projects | This browser | Server, with local saving for supported edits |
| Share and review together | No | Subject to permissions |
| Use server AI and Git tools | No | Subject to configuration |
Local projects are not a cross-device backup. Server-backed features also require the relevant service to be available.