Ream Field Notes

Two years of measurements and mistakes from building a post-quantum Ethereum consensus client. A chaptered field report from ReamLabs.

Built the same way as whir-intro: Vite + React + TypeScript, one chapter per route, deployed to GitHub Pages.

Development

npm install
npm run dev      # http://localhost:5173
npm run build    # -> dist/

Deploying

Pushing to main builds and publishes to GitHub Pages via .github/workflows/deploy.yml. The Vite base is /ream-field-notes/ — change it in vite.config.ts if the repo is named differently, and update pathSegmentsToKeep in public/404.html if the path depth changes.

Structure

src/
  chapters.ts            chapter registry (id, label, number)
  chapters/C*.tsx        one component per chapter
  components/Layout.tsx  rail nav + prev/next
  App.tsx                routing
  index.css              design tokens and prose styles

Content

Prose is the write-up in ream-study-group. Figures come from public sources — meeting notes, dev notes, repositories and devnet metrics.