Build Log
Every bug caught while building this site, with the symptom, the cause, the fix, and the lesson worth banking. Filter by category, click an entry to study it.
How to read this log.
Why this exists
A bug fixed silently is a lesson left on the floor. This page is a running library of the real engineering issues hit while building this site — so the next time the same shape of problem shows up, the answer is already on the shelf. Every entry has the same four parts:
- Symptom — what you actually saw or experienced. The thing that made you say "wait, that's wrong."
- Cause — what was actually happening underneath. Almost always not what the symptom suggests.
- Fix — the change that resolved it.
- Lesson — the generalizable pattern. The part you bank for next time.
How to add a new entry
Open build-log/build-log.js and append an object to the ENTRIES array at the top of the file. The array is the only source of truth — the page renders from it. Every field is required except severity, which defaults to minor. Date format is MM/DD/YYYY.
Categories used so far
CSS layout — anything Grid, Flexbox, sizing, or visual reflow. JS state — bugs in the data model, render loop, or event wiring. Git workflow — anything about commits, branches, pushes, or what's actually shipped. Deployment — issues that only showed up in production or in the deploy pipeline. Accessibility — keyboard, focus, ARIA, screen-reader behavior. Security — anything where the wrong input could do harm. Performance — render speed, asset size, layout thrash. Tooling — bugs in the local dev loop, preview, or build process. Information architecture — page exists / can it be found / does it link where users expect.