architecture

Why I Skipped the CMS I evaluated Decap, Directus, Strapi, Sanity, and Contentful before deciding that none of them were worth the cost for a content site run by one person.

Documentation That Scales: Constitution, Contracts, and Runbooks How I structured documentation so a team of one (plus AI agents) can make consistent decisions fast, without the docs becoming a liability.

Fixing Navigation and Analytics: When Your Data Lies About User Behavior A behind-the-scenes update on fixing shadow-DOM navigation edge cases, restoring back/forward swaps, and making analytics actually reflect what readers do.

HAL: Build-Time Link Rewriting That Makes Navigation Feel Instant How a simple build-time pass gives you SPA-speed navigation on a static site - no router library, no framework runtime, no ongoing cost.

Web Components + HTMX: A Lean Architecture for Content Sites That Ship How I use native Custom Elements and HTMX to build a site that feels like an app, costs nothing to host, and doesn't require a framework upgrade every 18 months.

The Static Site Playbook: Shipping a Content Product on a Near-Zero Budget How I built a production content site with Markdown, a build script, and a 35KB JS budget - and why the boring choices are the ones that compound.

How This Site Works: Architecture for a One-Person Team The technical architecture behind a fast, SEO-friendly content site built by one person. SSG, Web Components, HTMX, and the business logic behind each choice.

Less JavaScript, More Leverage: Why I Ship With a 35KB Budget Cutting JavaScript isn't a purity contest - it's a business decision that compounds in speed, cost, reliability, and team velocity.