// DOCS

Overview

What this documentation is and how it is organized.

This is the engineering documentation for voegele.dev — the site you are reading from, and the projects behind it. It is written from the inside: how things are actually built, why the decisions were made, and where the interesting trade-offs live.

It is split into two parts:

  • The Site — a handbook for this portfolio as an engineering artifact: architecture, the performance model, the liquid-glass system, the interactive canvas pieces, motion, and SEO.
  • Projects — reference notes on the things I have built: FormulaGod, GetMoneyMap, and the planned homelab.

The one principle

Everything here obeys a single rule: nothing animates while nothing is happening. Every effect on this site is interaction- or scroll-driven, and the expensive ones physically stop — they cancel their own animation frame — the moment they settle. No perpetual loops, no battery tax for reading a page. If you take one idea away from these docs, that is the one.

Narrative vs reference

These docs are reference material. The story-shaped version — debugging tales, build write-ups — lives in Writing. Where a post goes deeper on something here, it is linked inline.