.env.example

# deckwright environment. Copy to .env (bin/setup does this for you).
#
# pf-core reads a number of env vars (API keys, LOG_LEVEL, the resolve_* knobs);
# see pf-core's docs/config.md and docs/env.md for the full reference. Add this
# project's own settings below as you declare them on Config in src/deckwright/config.py.

# LOG_LEVEL=INFO

# --- deckwright rendering ---
# Slide rasterization (deckwright.services.render): LibreOffice + Poppler.
# DECKWRIGHT_SOFFICE=soffice
# DECKWRIGHT_PDFTOPPM=pdftoppm
# DECKWRIGHT_RENDER_DPI=110
# HTML-card screenshots (deckwright.services.htmlshot). Defaults to the first
# Chrome/Chromium/Edge found; set explicitly if autodetect misses it.
# DECKWRIGHT_CHROME=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
# DECKWRIGHT_SHOT_SCALE=2
# Chrome's sandbox is ON by default because a card's HTML can carry script.
# Set this in a container that denies unprivileged user namespaces.
# DECKWRIGHT_CHROME_NO_SANDBOX=1
# DECKWRIGHT_SHOT_TIMEOUT_S=60
# Render canvas height in CSS px. A card taller than this is clipped by the
# browser; deckwright detects that and fails the build telling you to raise it.
# DECKWRIGHT_SHOT_CANVAS_H=4000

# --- deckwright QA ---
# QA text extraction (deckwright.qa.textflow): Poppler's pdftotext.
# DECKWRIGHT_PDFTOTEXT=pdftotext
# DECKWRIGHT_PDFTOTEXT_TIMEOUT_S=60
# The fonts a render embedded (deckwright.qa.rendered_fonts): Poppler's pdffonts.
# DECKWRIGHT_PDFFONTS=pdffonts
# DECKWRIGHT_PDFFONTS_TIMEOUT_S=60
# Most shapes one beat of a staged build may reveal before qa warns (deckwright.qa.motion).
# DECKWRIGHT_MAX_BEAT_SHAPES=6

# --- deckwright fonts ---
# Font availability (deckwright.theme.fonts): fontconfig's fc-list, used by
# doctor's fonts row and QA's font-substituted check. Absent = the check is
# silent. macOS: brew install fontconfig.
# DECKWRIGHT_FC_LIST=fc-list
# DECKWRIGHT_FC_LIST_TIMEOUT_S=20

# --- deckwright build ---
# Both default to paths relative to the CWD; override when running the CLI
# from outside the repo root. This directory holds brand templates and the
# themes bound to them, side by side. A theme name not found there falls back
# to the packaged built-ins, so `theme: base` resolves anywhere.
# DECKWRIGHT_THEME_DIR=templates
# DECKWRIGHT_CACHE_DIR=.deckwright-cache  # also holds rendered panel PNGs
# Glyph directory searched before the theme's own icons: and the built-in set.
# DECKWRIGHT_ICON_DIR=