Skip to main content
Every Luria Voice project reads branding settings from _brand/_brand.yml at render time. Changes you make to this file take effect the next time you run quarto render — no restart required. The sections below explain each configuration area and the values you can set.

​
Colors

Define your practice’s primary and secondary palette using hex values. The primary color is used for headings and accents; secondary is used for subheadings and highlight elements.
_brand/_brand.yml
Keep background set to #FFFFFF for clinic-ready print output. Colored backgrounds can cause issues when printing to PDF or when the report is photocopied.

​
Typography

The typography block controls which fonts are loaded, the base body size, and heading weight.
_brand/_brand.yml

​
Preferred fonts

Install Equity B locally for the best typographic results. If the font is not found on your system, Typst falls back gracefully to IBM Plex Serif and then to system fonts. The report will still render — it just won’t use the preferred typeface.

​
Fallback behavior

The Typst show rules in _extensions/neurotyp-adult/typst-show.typ define a font priority list:
  1. Equity B
  2. IBM Plex Sans / IBM Plex Serif
  3. Source Sans 3
  4. System default serif
You do not need to change typst-show.typ to use fallback fonts — Typst selects them automatically when a preferred font is missing.

​
Base size

base-size controls the body text point size. 11pt is the default and is appropriate for standard A4 clinical reports. Increase to 12pt if the report will be read by patients with visual impairments. Place your practice logo in the _brand/ directory and reference it by path.
_brand/_brand.yml
1

Add your logo file

Copy your logo image into the _brand/ directory. PNG format at 300 dpi is recommended for sharp PDF output.
2

Update the path

Set path to the filename of your logo. The path is relative to _brand/.
3

Set descriptive alt text

Update alt with a short description, such as your practice name. This is used for accessibility metadata in the PDF.
4

Render to see the result

Run quarto render template.qmd to apply your logo. It appears in the report header on page 1.
Do not reference images outside the project directory (for example, absolute paths like /Users/you/Desktop/logo.png). Use paths relative to _brand/ so the project remains portable across machines.

​
Full annotated example

The following is a complete _brand/_brand.yml with inline comments explaining each field.
_brand/_brand.yml
Last modified on May 20, 2026