The journal

Writing on software, craft, and the long way around

Field notes from building things — the successes, the failures, and the experiences gained along the way. New entries land here first.

next.js5 min read

Why I rewrote my markdown pipeline (again)

Notes from a weekend spent pulling shiki out of the runtime, folding MDX compilation into the build, and learning — again — that the best optimization is the one you stop doing. Here is everything that broke and everything I would keep.

Read more
next.js1 min read

Compiling MDX at build time, version one

The first attempt at moving compilation out of the request path — and the three things it got wrong that I only saw once real traffic hit it in production. A post-mortem on premature cleverness.

Read more
craft1 min read

What home health PT taught me about edge cases

Patients live in the long tail. Every home is a little different, every body is a little different, and the protocol only gets you so far. The same patterns I see walking into living rooms show up in my codebase, too.

Read more
process1 min read

A quiet argument for boring tools

I spent years chasing the new thing. These days I reach for whatever I already understand at 2am when something is on fire. Boring is a feature, and here is how I learned to value it.

Read more
process1 min read

Why I keep rewriting things I already wrote

On the loop between dissatisfaction and craft — when the loop is healthy and sharpening the work, versus when it is just an elaborate way to avoid shipping. A field guide to telling the two apart.

Read more
Subscribe to the journal
New posts on software, craft, and the occasional detour — straight to your inbox. No more than a couple times a month.