For AI agents: the documentation index is at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
Verification
Verification
Tiers
| Tier | Command | Run when |
|---|---|---|
| Narrow | npm --workspace static-to-variable run test -- <file> or uv run pytest -q <file> | During an edit loop |
| Node | npm run verify:node | TypeScript, CLI, config, or web changes |
| Python | npm run verify:python | Engine, schema, or font-pipeline changes |
| Commit | npm run verify | Before every commit |
| Full | npm run verify:full | Before pushing changes that affect builds or releases |
CI deliberately runs the Node and Python halves in parallel, using the same component commands as local verification. Its e2e job adds packaged-CLI, minimal-font, invalid-config, doctor, and bundled-engine assertions.
Worktrees
Run both installers inside each worktree:
npm ci
uv syncDo not symlink .venv between worktrees. variable-gen is installed editable, so uv rewrites the environment's source path to the checkout most recently synced. Parallel agents sharing that environment can silently execute another branch and also spend time repeatedly uninstalling and reinstalling the package. uv's download cache is already shared safely.
Use npm run test -- --force when you specifically need an uncached Turbo test run. Normal cached runs are valid for identical inputs, but replayed logs may contain a path from the worktree that originally populated the cache.
Published with Edda