Reference
Web build and environment
Exact current command and environment reference for the Pinega Web workspace. For an end-to-end task procedure, use the corresponding how-to pages.
Toolchain
| Surface | Current contract |
|---|---|
| Node.js | >=26.0.0; CI pins 26.7.0 |
| Package manager | npm with committed package-lock.json |
| Playwright | 1.62.1 |
| Browser container | mcr.microsoft.com/playwright:v1.62.1-noble when a matching container is required |
| Build target | ES2022 static multi-page output |
Package scripts
| Command | Purpose |
|---|---|
npm run tokens:check | Verify generated Strata token adapters are current. |
npm run typecheck | Strict TypeScript check without emission. |
npm run test:unit | Design and Web architecture/content contracts. |
npm run build | Generate the static site and discovery artefacts. |
npm run check:build | Validate generated output and budgets. |
npm run serve | Serve web/dist at the configured local address. |
npm run test:browser | Chromium/Firefox/WebKit browser and accessibility suite. |
npm run test:visual | Chromium desktop visual-regression baselines. |
Generated outputs
web/dist/— static site.site-manifest.json— public/content route metadata projection.content/documentation-manifest.json— documentation-only search/readiness projection.sitemap.xmlandrobots.txt— discovery files derived from registry flags.assets/— bundled CSS/JavaScript and Web Awesome assets.
Build budgets
The current build check enforces aggregate JavaScript and CSS budgets. Treat the values in web/scripts/check-build.mjs as authoritative because they are executable CI policy, not prose-only targets.