Templates — Rustume

Rustume renders resumes with Typst — no browser or headless Chrome required. Each template is a self-contained .typ file with a distinct layout and accent color. All templates are available whether resumes are local, synchronized through hosted Rustume Cloud, or synchronized from a self-hosted connected deployment.

Preview gallery

Click a thumbnail to open a larger preview.

Template list

ID	Layout	Accent color
`rhyhorn`	Single-column linear	Olive green`#65a30d`
`azurill`	Sidebar left + main right	Amber`#d97706`
`pikachu`	Sidebar left + main right	Gold`#ca8a04`
`nosepass`	Single-column linear	Blue`#3b82f6`
`bronzor`	Single-column linear	Teal`#0891b2`
`chikorita`	Main left + sidebar right	Green`#16a34a`
`ditto`	Sidebar left + main right	Teal`#0891b2`
`gengar`	Header-in-sidebar + main right	Light teal`#67b8c8`
`glalie`	Header-in-sidebar + main right	Teal`#14b8a6`
`kakuna`	Single-column linear	Tan/brown`#78716c`
`leafish`	Full-width header + two columns	Rose`#9f1239`
`onyx`	Single-column linear	Red`#dc2626`

The default template is rhyhorn. Set metadata.template in your resume JSON to switch templates.

Choosing a template

Single-column templates (rhyhorn, nosepass,bronzor, kakuna, onyx) work well for ATS-friendly, text-dense resumes.

Sidebar templates (azurill, pikachu, ditto,gengar, glalie, chikorita) give visual hierarchy — skills and contact info in the sidebar, experience in the main column.

Two-column (leafish) balances content across equal-width columns below a full-width header.

Previewing templates

In the web editor, open the template picker to see live PNG previews. Via the API:

curl http://localhost:3000/api/templates
curl http://localhost:3000/api/templates/rhyhorn/thumbnail -o preview.png

Via the CLI:

rustume templates           # list all template IDs
rustume templates -v      # include theme colors
rustume preview resume.json -t azurill -o preview.png

Customizing theme colors

Each template has default background, text, and primary (accent) colors. Override them inmetadata.theme:

{
  "metadata": {
    "template": "onyx",
    "theme": {
      "background": "#ffffff",
      "text": "#111827",
      "primary": "#dc2626"
    }
  }
}

The web editor includes a visual theme editor for adjusting colors without editing JSON directly. See also: Quickstart.

Iterating on templates

Typst templates ship embedded in the native CLI and server binary. To iterate on a template without rebuilding Rust, copy the files fromcrates/render/src/typst_engine/templates/ into a working directory and pointRUSTUME_TEMPLATES_DIR at it. Matching <name>.typ files override the embedded copy on each render; other templates still load from the embedded defaults.

mkdir -p ~/rustume-templates
cp crates/render/src/typst_engine/templates/*.typ ~/rustume-templates/
export RUSTUME_TEMPLATES_DIR=~/rustume-templates
# edit ~/rustume-templates/rhyhorn.typ, then re-run preview/PDF — no cargo build needed
rustume preview resume.json -t rhyhorn -o preview.png

The browser WASM build always uses embedded templates only. SeeEnvironment variables for deployment configuration.