Under the Code

A unified theory of how computers actually work — five parts, eighteen chapters, ~93,000 words, ~210 inline-SVG figures.

Published at under.atheric.eu.

By Yki Lähteenmäki. Published by Atheric (YTD Holdings Oy, Helsinki).

Repo layout

public/          ← deploy this directory · the only thing the domain serves
  index.html
  part-1.html ... part-5.html
  book.css, book.js
  glossary.html, glossary.json
  og-image.svg, og-image.png
  robots.txt, sitemap.xml, 404.html
scripts/         ← build tooling (not served)
  build-glossary.js
docs/            ← internal design docs (not served)
  plan.txt
  figures.txt
legacy/          ← prior drafts, kept for reference

Develop

# Serve public/ on http://localhost:8000 for local preview
npm run serve

# Re-extract the auto-glossary from the part-N.html files
npm run build:glossary

The book is a static site — no framework, no bundler, no Node runtime in production. Everything is plain HTML + CSS + JS that a browser parses directly.

Deploy

The public/ directory is the publishable artifact. Any of:

Cloudflare Pages / Netlify / Vercel — connect the repo, set publish directory to public/, deploy on push. Zero config.

GitHub Pages — set the publish source to public/ (or move contents to docs/ if your fork prefers that convention).

rsync / scp to a VPS — rsync -av --delete public/ user@host:/var/www/under.atheric.eu/. Point nginx at the deployed directory.

Generate a launch-grade og-image.png

The committed og-image.png was generated by macOS qlmanage and may not render Google Fonts (Playfair, DM Mono) cleanly. For a launch-grade raster, regenerate from og-image.svg:

brew install librsvg
rsvg-convert -w 1200 -h 630 public/og-image.svg -o public/og-image.png

Or open og-image.svg in a browser at 1200×630 and screenshot.

License

Licensed under CC BY-NC 4.0. You are free to share and adapt the material non-commercially, with attribution. Commercial use requires permission. © 2026 Yki Lähteenmäki / YTD Holdings Oy.

Status

Active — last updated 2026-05-19.