To use a local checkout of the template’s repository as a package (e.g. while contributing or to get the bleeding-edge version), follow these steps to install it into your local Typst package directory.

mise-en-place is an optional but recommended prerequisite here. It can be used to install both the template and Typst itself. However, assuming Typst is installed, each task is a plain shell script, so you can also run the bash mise/tasks/… form directly.

Inside your clone of the repository, run either of the following:

# copy — changes require re-installation (recommended for stability)
mise run install # or bash mise/tasks/install/_default

# symlink — changes apply immediately (recommended during development)
mise run install:editable # or bash mise/tasks/install/editable

When installed this way, imports use @local/kinetic-kit:0.2.1 in place of @preview/kinetic-kit:0.2.1.

The repository also bundles the Libertinus fonts. Install them into your user font directory with

mise run install:fonts # or bash mise/tasks/install/fonts

You can fully customize the title page if you need something other than the default. The title-page parameter accepts content, or a function the template calls with the details it already knows:

#import "@preview/kinetic-kit:0.2.1": thesis

#let your-custom-title-page(
  title,
  author-firstname: "",
  author-surname: "",
  format: "a5",
  lang: "de",
  ..rest,
) = align(center)[
  #v(2cm)
  #text(size: 20pt, weight: "bold")[#title]
  #v(1cm)
  #author-firstname #author-surname
]

#show: thesis.with(
  title: [Titel der Masterarbeit],
  author-firstname: "Max",
  author-surname: "Mustermann",
  title-page: your-custom-title-page,
)

The template supplies title, author-firstname, author-surname, format and lang, so they stay in step with the PDF metadata — pre-binding them with .with() has no effect. Take only what you need and let ..rest absorb the others. Page geometry, and the suppressed header, footer and page number, are applied for you; a set page of your own overrides them.

Pass title-page: none to omit the page entirely, or doctoral-title-page (exported at the top level) to build the default page yourself:

#import "@preview/kinetic-kit:0.2.1": doctoral-title-page, thesis

#show: thesis.with(
  title: [Titel der Dissertation],
  title-page: doctoral-title-page.with(status-approved: true, exam-date: "12. Mai 2026"),
)

Typst’s built-in outline is styled, named and bookmarked for you, so the table of contents and the back-matter list pages are ordinary outline(..) calls placed in the front-matter / back-matter content of thesis().

#show: thesis.with(
  front-matter: [
    #outline()
  ],
  back-matter: [
    #outline(target: figure.where(kind: image))
    #outline(target: figure.where(kind: table))
    // A kind the template has no word for names itself:
    #outline(title: [Algorithmenverzeichnis], target: figure.where(kind: "algorithm"))
    #bibliography("refs.bib", style: "ieee")
  ],
)

Omit title on a list page and the template supplies the localized name — Abbildungsverzeichnis / List of Figures and so on for image, table and raw. Pass one to override it, or title: none for no heading at all. Omitting it for a kind the template cannot name is a compile error rather than a page headed Inhaltsverzeichnis.

The bibliography is titled the same way: Literaturverzeichnis in German, where Typst’s own default is Bibliografie.

Unlike Typst’s built-in behaviour, a list page (except the table of contents) gets a heading that is outlined and bookmarked, so it appears in the table of contents and in the PDF bookmarks.

The kit-style namespace exposes the template’s visual constants so custom figures and diagrams can match the document’s typography and color palette exactly.

#import "@preview/kinetic-kit:0.2.1": kit-style

// kit-style.fonts                 — (serif, sans, mono) font family arrays
// kit-style.font-sizes-by-format  — dict keyed by format: font sizes per format
// kit-style.leading               — paragraph line spacing (0.75em)
// kit-style.colors                — KIT color palette (green, blue, red, …)

#figure(
  {
    set text(font: kit-style.fonts.sans, size: kit-style.font-sizes-by-format.at("a5").small)
    rect(
      fill: kit-style.colors.green15,
      stroke: kit-style.colors.green,
      width: 6cm, height: 3cm,
    )
  },
  caption: [A custom figure using template styles.],
)

Typst gives every figure kind its own counter and supplement, but only styles the ones it knows: image, table and raw (code listings). The template carries strings for exactly those three. Anything else is your document’s vocabulary, so you declare it.

Declaring a kind. Give it a supplement, either one value or one per language:

#show: thesis.with(
  figure-kinds: (
    (kind: "algorithm", supplement: (de: [Algorithmus], en: [Algorithm])),
    (kind: "theorem",   supplement: [Theorem]),
  ),
)

Then tag the figure:

#figure(
  algorithm-body,
  caption: [This is an algorithm.],
  kind: "algorithm",
)

List pages. Put an outline call in back-matter for each kind you want listed, in whatever order you want them — the built-in image/table/raw included:

back-matter: [
  #outline(target: figure.where(kind: image))
  #outline(target: figure.where(kind: table))
  #outline(title: [List of Algorithms], target: figure.where(kind: "algorithm"))
],

A declared kind needs a title of its own; the template only names image, table and raw.

Set draft: true to show an “ENTWURF” (German) or “DRAFT” (English) watermark on every page. Pass draft-info for an additional version string:

#show: thesis.with(
  // ...
  draft:      true,
  draft-info: sys.inputs.at("git-sha", default: none),
)

Compile with the SHA injected:

typst compile --input git-sha=$(git rev-parse --short HEAD) main.typ

Set draft: false before submission.

Use the glossarium package for automatic first-use expansion.

Important: #show: make-glossary must appear before #show: thesis.with(...). Forgetting this causes silent failure — abbreviations will not expand.

#import "@preview/kinetic-kit:0.2.1": thesis
#import "@preview/glossarium:0.5.10": make-glossary, register-glossary, print-glossary

#let abbrevs = (
  (key: "ml",  short: "ML",  long: "Machine Learning"),
  (key: "cnn", short: "CNN", long: "Convolutional Neural Network"),
)

// Must come before #show: thesis.with(...)
#show: make-glossary
#register-glossary(abbrevs)

#show: thesis.with(
  // ...
  front-matter: [
    = List of Abbreviations
    #print-glossary(abbrevs)

    #outline()
  ],
)

// @ml expands to "Machine Learning (ML)" on first use, "ML" thereafter.

For a nicer two-column grid layout (bold abbreviation on the left, long form on the right) instead of the default print-glossary output, see the custom abbrevs-glossary() helper in examples/content/abbreviations.typ.

Use the drafting package to add margin notes during writing. Tie is-draft to both the watermark and note visibility so they are toggled in one place:

#import "@preview/kinetic-kit:0.2.1": thesis
#import "@preview/drafting:0.2.2": set-margin-note-defaults, margin-note

#let is-draft = true
#set-margin-note-defaults(hidden: not is-draft)

#show: thesis.with(
  // ...
  draft: is-draft,
)

// In your text:
#margin-note[Revisit this paragraph.]

Set is-draft = false before final compilation to hide all margin notes and remove the watermark.