Company

For the people building

Clone it, run the gates, read the reasoning. The system explains itself.

Quickstart

From clone to a running site, in the order that matters. Quoted from QUICKSTART.md at the repo root.

  1. 1. Install

    npm install
cd website && npm install

  2. 2. Verify tokens (order matters)

    npm run tokens:build
npm run tokens:test

  3. 3. Regenerate identity

    node brand/logo/scripts/generate-mark.mjs
node brand/logo/scripts/validate-svg.mjs
node brand/logo/export.mjs

  4. 4. Run the website

    cd website
npm run lint
npm run typecheck
npm run build
npm run dev

Gates

Every gate that runs in CI, runnable locally with the same command.

GateCommandChecks
tokens:testnpm run tokens:test9-test suite incl. machine-verified WCAG contrast matrix, both themes
validate-svgnode brand/logo/scripts/validate-svg.mjsSVG masters are well-formed and match construction geometry
check-linksnode tokens/scripts/check-links.mjswikilink + relative-link integrity across every vault markdown file
lintnpm run lintESLint (next/core-web-vitals + typescript), zero errors
typechecknpm run typechecktsc --noEmit, strict mode
buildnpm run buildproduction static export to website/out/

Repository

Continue: Everything, in one place