browser.js/CONTRIBUTING.md

Development Setup

Node.js 22.18+ and pnpm are required. Everything else goes through ./cv (.\cv.ps1 on Windows, or pnpm cv), which installs dependencies, fetches dreamland at its pinned commit, builds the rust rewriter and only rebuilds what changed.

./cv chrome        # browser.js dev server (chrome + wisp + isolation zone + rspack watch)
./cv dev           # scramjet's own dev server (demo page)
./cv build         # build everything
./cv build chrome  # just the frontend and what it needs
./cv build wasm    # just the rust rewriter
./cv test          # runway tests (args are forwarded, e.g. --headed, --parallel 4)
./cv npm           # release build + pnpm pack of every published package
./cv               # help, including every target and command

The rewriter needs rust nightly plus wasm-bindgen-cli, wasm-opt and wasm-snip; if cargo is installed, cv offers to install the rest for you (--yes skips the prompt).

Useful flags: --why explains why a task runs, --dry shows the plan, --force ignores the change tracking. Each package declares its tasks in a cv.ts next to its package.json; the runner lives in packages/scramjet/packages/cv.