# CLAUDE: `webapp/scripts/`

## Purpose
- Node-based helpers for building, running, and maintaining the webapp (e.g., dev server orchestration, build pipelines, localization tooling).
- Invoked via `npm`/`make` targets—direct execution should be rare.

## Key Scripts
- `dev-server.mjs` – webpack-dev-server bootstrap; shares config with `make dev`.
- `run.mjs`, `build.mjs`, `dist` helpers – orchestrate multi-workspace builds and env wiring.
- `gen_lang_imports.mjs` – regenerates locale import lists.
- `update-versions.sh` - updates version of published platform packages.

## Guidelines
- Scripts should be idempotent and safe to run on CI and macOS/Linux dev machines.
- Prefer ES modules + top-level `await` already used in existing scripts.
- Keep configuration (ports, paths) sourced from `config.mk` or env vars instead of hard-coding.
- Log actionable errors; exit with non-zero codes so CI fails fast.
- When script behavior changes, update associated `Makefile` targets and `webapp/CLAUDE.md` command docs.

## References
- `config.mk`, root `Makefile`, and workspace `package.json` scripts to understand entry points.
- `webapp/STYLE_GUIDE.md → Automated style checking` for how scripts integrate with lint/test tooling.