How-to

Build and inspect the website

Use this procedure when the goal is a local static build you can inspect. It assumes the programme model is already understood and does not explain architecture that belongs in concept pages.

Install the exact Web dependencies

Enter the Web workspace and install from the committed lockfile without package lifecycle scripts.

Nushell · install

cd web
^npm ci --ignore-scripts

Build the static site

Nushell · build

^npm run build
^npm run check:build

The build validates the versioned content registry, injects documentation navigation/provenance, renders semantic diagrams, writes discovery metadata, and emits the multi-page site under web/dist. The build check then validates required outputs and budgets.

Serve and inspect it

Nushell · local server

^npm run serve

Open http://127.0.0.1:4173. Public routes come from the content registry. The internal component laboratory remains available for contributor review but is excluded from the public navigation and sitemap.

Validate before review

Building is not the release gate. Continue with Run the Web validation gate before treating the result as review-ready.