https://github.com/cetz-package/cetz
CeTZ: ein Typst Zeichenpaket - A library for drawing stuff with Typst.
https://github.com/cetz-package/cetz
cetz typst typst-canvas
Last synced: 5 days ago
JSON representation
CeTZ: ein Typst Zeichenpaket - A library for drawing stuff with Typst.
- Host: GitHub
- URL: https://github.com/cetz-package/cetz
- Owner: cetz-package
- License: lgpl-3.0
- Created: 2023-04-15T21:19:07.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-12-31T00:43:54.000Z (17 days ago)
- Last Synced: 2026-01-01T17:58:36.004Z (15 days ago)
- Topics: cetz, typst, typst-canvas
- Language: Typst
- Homepage: https://cetz-package.github.io
- Size: 70.2 MB
- Stars: 1,558
- Watchers: 5
- Forks: 64
- Open Issues: 72
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-typst - CeTZ - CeTZ (CeTZ, ein Typst Zeichenpacket) is a library for drawing with [Typst](https://typst.app) with an API inspired by TikZ and [Processing](https://processing.org/). It comes with modules for drawing plots, graphs and charts. (Templates & Libraries / Graphics)
README
# CeTZ
CeTZ (CeTZ, ein Typst Zeichenpaket) is a library for drawing with [Typst](https://typst.app) with an API inspired by TikZ and [Processing](https://processing.org/).
## Examples
Karl's Picture
Pacioli's construction of the icosahedron
Plate Capacitor
Tree Layout
Periodic Table of Elements
Waves
Torus
*Click on the example image to jump to the code.*
You can explore an example gallery of scientific diagrams at [janosh.github.io/diagrams](https://janosh.github.io/diagrams).
## Usage
For information, see the [API Reference (PDF)](./manual.pdf?raw=true) or the [online manual](https://cetz-package.github.io/docs).
To use this package, simply add the following code to your document:
```typ
#import "@preview/cetz:0.4.2"
#cetz.canvas({
import cetz.draw: *
// Your drawing code goes here
})
```
## CeTZ Libraries
- [cetz-plot - Plotting and Charts Library](https://github.com/cetz-package/cetz-plot)
- [cetz-venn - Simple two- or three-set Venn diagrams](https://github.com/cetz-package/cetz-venn)
## Installing
To install the CeTZ package under [your local typst package dir](https://github.com/typst/packages?tab=readme-ov-file#local-packages) you can use the `install` script from the repository.
```bash
just install
```
The installed version can be imported by prefixing the package name with `@local`.
```typ
#import "@local/cetz:0.4.2"
#cetz.canvas({
import cetz.draw: *
// Your drawing code goes here
})
```
### Just
This project uses [just](https://github.com/casey/just), a handy command runner.
You can run all commands without having `just` installed, just have a look into the `justfile`.
To install `just` on your system, use your systems package manager. On Windows, [Cargo](https://doc.rust-lang.org/cargo/) (`cargo install just`), [Chocolatey](https://chocolatey.org/) (`choco install just`) and [some other sources](https://just.systems/man/en/chapter_4.html) can be used. You need to run it from a `sh` compatible shell on Windows (e.g git-bash).
## Testing
This package comes with some unit tests under the `tests` directory.
To run all tests you can run the `just test` target. You need to have
[`tytanic`](https://github.com/tingerrr/tytanic/) in your `PATH`: `cargo install tytanic`.
## Projects using CeTZ
- [finite](https://github.com/jneug/typst-finite) Finite is a Typst package for rendering finite automata.
- [fletcher](https://github.com/Jollywatt/typst-fletcher) Package for drawing commutative diagrams and figures with arrows.
- [chronos](https://git.kb28.ch/HEL/chronos) Package for drawing sequence diagrams.
- [circuiteria](https://git.kb28.ch/HEL/circuiteria) Package for drawing circuits.
- [zap](https://github.com/l0uisgrange/zap) Package for drawing standard electronic circuits.
- [rivet](https://git.kb28.ch/HEL/rivet-typst) Package for drawing instruction / register diagrams.
- [plotsy-3d](https://github.com/misskacie/plotsy-3d) Package for rendering 3D objects & plots.
- [alchemist](https://github.com/Typsium/alchemist) A package to render skeletal formulae using a human-readable format using cetz.
- [deckz](https://github.com/micheledusi/Deckz) Render Poker-Style playing cards.
- [neural-netz](https://github.com/edgaremy/neural-netz) Visualize neural network architectures.
- [energy-dia](https://github.com/Typsium/energy-dia) Library for creating professional energy diagrams in chemistry and physics.
- [conchord](https://github.com/sitandr/conchord) Package for writing lyrics with chords that generates fretboard diagrams.