Prerequisites¶

Tool	Why	Check	Install
Git	Source control	`git --version`	git-scm.com
Node.js 22	Matches `.github/workflows/ci.yml`'s `actions/setup-node@v4` (`node-version: 22`) - `package.json` has no `engines` field, so CI's version is the closest thing to an official requirement	`node --version`	nodejs.org or `winget install OpenJS.NodeJS.LTS`
npm	This monorepo uses npm workspaces natively - no Yarn/pnpm anywhere in the repo	`npm --version`	Ships with Node
Wrangler	Cloudflare's CLI - local dev server, D1/R2 access, deploys	Already a `devDependency` (`^4.32.0`) - use via `npx wrangler` or `npm run dev:api`, no separate global install needed	—
Python 3.x	Builds/serves this documentation portal only - not needed for the application itself	`python --version`	See MkDocs environment below

Node version¶

node --version
# Confirm v22.x - if you have nvm: nvm use 22

No .nvmrc is committed - this is inferred from CI, not an explicit repository requirement. Anything that satisfies each app's own vite/typescript/react version ranges will likely work, but matching CI (Node 22) avoids surprises.

Wrangler authentication (only needed for anything touching real Cloudflare resources)¶

npx wrangler login

Not required for npm run dev:<app> (pure local Vite dev server) or for the local D1 emulator (--local flag, no network). Required for wrangler tail, wrangler d1 ... --remote,

wrangler
deploy

, and any configure:* secret script - see Cloudflare → Wrangler.

MkDocs environment¶

Only needed to build/preview this documentation portal itself:

python -m venv .venv-docs
.\.venv-docs\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -r requirements-docs.txt
mkdocs serve