Colophon

A living log of building this site.

In books, a colophon lists how it was made. Most website colophons are static "built with" pages. This one's different—a stream of build decisions, debugging sessions, and lessons learned as I work on the site.

March 2026

Link preview tooltips now prefetch metadata before you hover, eliminating the visible flash between domain fallback and rich preview. Uses ForesightJS proximity detection to prefetch on cursor approach.

#ux#performance#web-components

Link preview tooltips now verify that the URL being previewed actually appears on the referring page, and preview images render through proper DOM construction instead of string injection.

#ux#link-previews#quality

Upgraded beautiful-mermaid to 1.1.3, fixed XY chart bar rounding, made the diagram modal edge-to-edge, and unified drag handle indicators across code panel and modal.

#diagrams#css#ui-polish

Added build-time llms.txt generation, a shared metadata resolver for consistent page titles and descriptions, reusable JSON-LD schema components, and a validation script that checks SEO health across the built sitemap.

#seo#schema#metadata#llms#infrastructure

The site felt chonky. Traced it from view transition jank on mobile through modal lag and same-page nav bugs to the real culprit: the critical CSS integration was async-loading stylesheets, causing massive layout shift on every page load.

#performance#cls#css#view-transitions#debugging

Swapped every cover image on the site from Recraft v3 to v4. Same palette, same style prompt, better compositions. The prompt generation pipeline got an overhaul too.

#ai#images#fal#recraft

Discovered web-haptics, a zero-dep wrapper around the Vibration API (with a clever iOS fallback). A handful of prompts later, every interactive element on the site has tactile feedback on mobile.

#mobile#ux#web-components#vibration-api