How I Built dout.dev (and why I did not use a framework like a normal person)
What the stack is, exactly (TL;DR: files + Node + blood)
Series
How I made it
A series of posts about How I made it.
Posts
Posts in this series
-
-
CMS and Markdown Processing (Or: How I Learned to Stop Worrying and Love the Flat File)
The useful distinction
-
Rebuilding dout.dev With an AI Copilot: Less Boilerplate, Same Amount of Existential Dread
The honest framing
-
Why I Skipped Astro, Eleventy and Next.js (And Built My Own SSG Like a Goddamn Caveman)
The default answer and why I ignored it
-
Custom SSG Pipeline: From Markdown to Static HTML (Without Losing Your Mind)
The pipeline, in one picture (because I know you're skimming)
-
Template Engine and Template Structure (Or: Why I Didn't Use Handlebars Like a Normal Person)
Three constraints that shaped the grammar (because constraints are good, actually)
-
Archives, Tags, Months, and Series (Or: How I Learned to Stop Worrying and Love Pagination)
Three ways to slice the same posts (because one axis is never enough)
-
Progressive Enhancement as Contract (Yes, It Works Without JS. No, I'm Not Kidding.)
The contract (read this part)
-
Design Tokens Before Pages (Yes, I Wrote the CSS Before the First Line of HTML)
The mistake I kept making (repeat after me: tokens first)
-
Build Assets Pipeline (Or: How I Turned a Simple Blog Into an Image Processing Factory)
The goal (four non-negotiable constraints)
-
Feeds and Sitemaps at Build Time (RSS Is Dead, Long Live RSS. Also JSON Feed.)
The distribution minimum (three files, that's it)
-
OG Images at Build Time (Or: How I Stopped Worrying and Learned to Love Sharp)
The problem and the usual solutions (none of which I wanted)
-
SEO Metadata Without Rituals (Or: I Read 47 SEO Blog Posts So You Don't Have To)
The short version (TL;DR for the impatient)
-
Quality Gate: Linting, Formatting, and Verify (Or: How I Stopped Shipping Broken HTML)
Why the gate exists (because you will ship shit if you don't)
-
CI/CD Around GitHub Pages (Or: How I Got Deploy Previews Without Paying Netlify)
The gap GitHub Pages leaves open (it's not that bad)
-
Vibe Coding With Rigor (Or: How to Use AI Without Your Codebase Turning Into a Dumpster Fire)
The term I am reclaiming (because "vibe coding" got a bad rap)
-
Modern CSS Is Enough (Container Queries, Nesting, `:has()` - No Framework Required)
The short version (for the impatient)
-
WCAG 2.2 AA Without ARIA-Spam (Landmarks, Heading Order, Skip-Links - That's 80% of It)
The unpopular opinion (brace yourself)
-
How PixHighlighter Is Built (Or: I Wrote a Syntax Highlighter Because Prism Was Too Bloaty)
The contract stays plain (because HTML should be readable)
-
Why DisplayPreferencesPopover Exists (Accessibility Is Not a Checklist, It's User Preferences)
Accessibility is not one feature (it's ALL of them)
-
Client-Side Search on a Static Dataset (No Server, No Algolia, No Bullshit)
The constraint (no backend, no excuses)
-
A Custom Element for Syntax Highlight: Why I Wrote `pix-highlighter`
The stack I did not want
-
Accessible Scrollspy and Outline Without contenteditable (Yes, It Can Be Done)
The feature and its trap
-
Honest Lazy Loading: IntersectionObserver vs Native loading=lazy (The Real Difference)
The two tools, in one paragraph
-
A Pragmatic Service Worker: Cache Strategy, Offline, No Abuse (80 Lines, No Drama)
The case against most service workers