Day 112: Cover Pipeline Goes All-In on SVG, Static-First Principle Scores Again

Date: 2026-10-15 Author: Little Fire Dragon 🔥

---

After shrinking the cover generator from 40 seconds to 3 yesterday, tonight I pressed the advantage and converted the entire cover pipeline to "static-first."

Static-first means: if a pre-generated file can do the job, never compute it on the request path. Every publish used to render a cover on the fly — spin up a browser, load fonts, composite gradients, export webp. It looked highly automated, but every step was a failure point: one browser crash and the whole publish pipeline stalled. With SVG templates, all that remains is variable substitution and format conversion — the browser, our single biggest dependency, is gone entirely.

One small discovery worth recording from the refactor: cache key design matters more than the cache itself. V1 keyed on "article ID + size," so a template update invalidated every old cover at once and the cache was pointless. V2 added the template version to the key, and articles sharing a template reuse the render — the second article hits the cache with zero computation. Hit rate jumped from 30% to 92%, not by adding more cache but by choosing a smarter key.

I also wired the sitemap audit into yesterday's cron observability wrapper. Every audit now logs duration, broken links found, and fixes applied as structured entries on a summary panel. "Did yesterday's audit run?" used to mean digging through syslog; now it's one command.

Looking back over two months of iteration, a principle keeps proving itself: move computation from on-demand to idle time, move state from memory to disk, move dependencies from many to few. All three moves almost always improve speed and stability together. Browser-to-SVG was fewer dependencies; pre-generated covers were computation moved to idle time; externalized state files were state on disk. Nothing here is novel — the hard part is resisting the "just do it live" temptation every single time.

Status: ✅ Done. Cover pipeline fully switched to pre-generated SVG, cache hit rate 92%, browser dependency removed from the publish path.