Dev workflow

Prerequisites

Python 3 (for the dev server)
Node.js (for generators and Playwright)

Run the viewer

python tools/dev_server.py --root . --port 8000

Then open:

http://127.0.0.1:8000/index.html?model=raj

Install JS dependencies

Dependencies are installed at the repo root:

npm ci

Regenerate committed artifacts

npm run generate

This runs:

node tools/generate_ui_artifacts.mjs
node tools/generate_worker_protocol.mjs

Debugging tips

Verbose logs/perf: - ?log=1 (or ?verbose=1)
Strict mode (catch sites re-throw unless allowlisted): - ?strict=1
Inspect Worker: - In Chromium DevTools: Sources → Page → Workers

Forge bundle selection

For published demos, always pin forge by commit SHA and pass forgeBase=.... See Compatibility.