Debugging
-
Infinite Re-Renders: Reading React's Error Like a Pro
Why React throws 'Maximum update depth exceeded', the five loops that cause it, and how to find the real culprit when the stack trace points nowhere.
-
"It Doesn't Work": Turning Vague Bug Reports Into Reproductions
How to reproduce a bug from a user report that says almost nothing: five questions worth asking, ten that waste time, and how to stop needing to ask.
-
Hydration Mismatches in Next.js: Causes Ranked by Frequency
The five most common causes of hydration mismatches in Next.js, ranked by how often they actually happen in production, with a working fix for each.
-
Race Conditions in Frontend Code: Yes, You Have Them
Frontend race conditions explained: stale responses overwriting fresh state, double submits, and effect cleanup — with AbortController fixes that hold up.
-
ChunkLoadError: Your Deploy Broke Everyone's Open Tabs
Why ChunkLoadError spikes after every deploy, how stale HTML references dead asset hashes, and three fixes: reload prompts, cache headers, kept assets.
-
The Dark Mode Flash: Small Bug, Big Rage
Why your site flashes the wrong theme on load, and the inline script fix that actually stops it — plus cookies vs localStorage for SSR frameworks.
-
Bugs That Only Happen to One User
How to debug a user specific issue: the five-part taxonomy — data shape, permissions, local state, extensions, locale — and a bisection sequence.
-
The White Screen of Death in Production React
What to check when your React app renders a blank white page in production: error boundaries, chunk loads, hydration crashes, and stale deploys.
-
"Works on My Machine": a Field Manual for Unreproducible Bugs
A taxonomy of bugs you cannot reproduce from production — state, timing, environment, and history dependent — and the capture strategy that cracks each one.
-
CORS Errors That Only Happen in Production
Why CORS errors appear only in production: preflight caching, credentials plus wildcard origins, proxies stripping headers, and the curl commands to debug it.
-
Safari-Only Bugs: a Debugging Guide for the WebKit-Weary
A field guide to bugs that only reproduce in Safari: date parsing, ITP storage limits, 100vh on iOS, IndexedDB in private mode, and the bfcache.