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

Astro 6 beta + Workers migration, production cutover, tweet embeds, and perf cleanup.

#astro#cloudflare#workers#migration#performance

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