Journal
Thinking out loud about craft, code, and systems.
A place to think out loud — about craft, code, and the systems we build. Updated when I have something worth saying.
-
What Lighthouse's Agentic Browsing Audit Actually Checks
Lighthouse 13.3 added a category that grades your site for AI agents, not humans — llms.txt, WebMCP, the accessibility tree, and layout stability. Here's what each check wants, and which ones are worth your time today.
· engineering · seo8 min read -
Deploying an Astro Site to Cloudflare Pages
From git push to a site on the edge — connecting the repo, Workers-with-static-assets vs classic Pages, wrangler.toml as the source of truth, env vars, and caching with a _headers file.
· engineering · astro · tutorial5 min read -
Generating Open Graph Images with Satori and Sharp
How to mint a custom social-share card for every page at build time — JSX to SVG to PNG, no headless browser. The exact setup running on this site.
· engineering · astro · tutorial9 min read -
Self-Hosting Fonts in Astro with Fontsource
Why loading from fonts.googleapis.com costs you a render round-trip and leaks visitor IPs — and how @fontsource fixes both with a one-line import and zero config.
· engineering · astro · tutorial5 min read -
Astro Content Collections with Zod
Turn a folder of Markdown into a typed, validated, queryable API — schema definition, the date-coercion gotcha, drafts, and how a bad post fails the build instead of shipping broken.
· engineering · astro · tutorial6 min read -
How to Build a Portfolio Website with Astro
A practical, end-to-end Astro tutorial — from project setup to Cloudflare deploy — using the real patterns that built this site, not theoretical best practices.
· engineering · astro · tutorial11 min read -
On Clarity as a Design Tool
The best products aren't the ones with the most features — they're the ones where nothing is in the way. Notes on clarity as a design discipline.
· design · craft3 min read -
Welcome to the Journal
A place to think out loud — on craft, code, and the systems we build. Not a blog. More like a workbench, where ideas come to be sharpened or set aside.
· meta · writing2 min read
Where to next
The thinking behind the writing — six ideas I keep coming back to.