karrierblatt

Bilingual (de/en), YAML-driven CV generation with three renderers: modern, tabular, and ats.

Features

• Single source of truth in template/cv.yaml.
• Three templates selected via meta.template:
  • modern: themed layouts via meta.theme.
  • tabular: DIN 5008-style label/value layout with optional meta.accent_color.
  • ats: linear, parser-friendly layout for Applicant Tracking Systems.
• Built-in theme registry with 14 modern themes: sidebar-classic, sidebar-right, top-header, timeline, executive, compact, accent-band, dark, nordic, newspaper, minimal, neon, academic, folio.
• Bilingual field handling with fallback between language keys (de/en) using loc() and loc-list().
• Optional per-token color overrides through meta.colors (accent, sidebar-bg, page-bg, text-main, text-muted, text-light, on-dark, on-dark-dim, row-alt, border).

Prerequisites

• Typst CLI 0.11 or newer.
• Recommended fonts (used by templates/palettes):
  • body fallback: Libertinus Serif, Georgia, Times New Roman
  • ATS font order: Times New Roman, Libertinus Serif, Georgia

Installation

1. Clone the repository.
2. Enter the project directory.
3. Compile once to validate setup:

typst compile --root . template/main.typ

This generates template/main.pdf.

Configuration

All configuration is in template/cv.yaml.

• There is currently no .env.example and no required environment variable setup.
• Main meta keys:
  • template: modern | tabular | ats (default in template/main.typ: modern)
  • language: de | en (default in template/main.typ: de)
  • theme: modern themes only (default in src/modern.typ: sidebar-classic)
  • accent_color: tabular accent color (default in src/tabular.typ: "#2563EB")
  • colors: optional palette token overrides for modern themes

Detailed references:

• Getting started
• YAML reference
• Templates
• Themes
• Color overrides

Usage

Arguments

template/main.typ imports ../lib.typ, so --root . should point to the repository root.

Command	Arguments	Description
typst compile	--root . template/main.typ [output.pdf]	Build PDF once
typst watch	--root . template/main.typ [output.pdf]	Rebuild automatically on changes

lib.typ exports:

• render-modern
• render-tabular
• render-ats

Examples

Compile with current template/cv.yaml:

typst compile --root . template/main.typ

Live preview while editing:

typst watch --root . template/main.typ

Switch to ATS output in template/cv.yaml:

meta:
  template: ats
  language: en

Switch to tabular with custom accent:

meta:
  template: tabular
  language: de
  accent_color: "#1E3A5F"

Use a modern theme and override specific colors:

meta:
  template: modern
  theme: folio
  colors:
    accent: "#6D597A"
    page-bg: "#FFFCFA"

Contributing

See ./CONTRIBUTING.md.

License

MIT (license = "MIT" in typst.toml). See ./docs/LICENSE.md.