Buglyst Blog
Learn to debug under pressure.
Playbooks for fast pattern recognition, guides for the full investigation, and articles for the engineering judgment around the edges.
17 playbooks · 509 guides · 95 articles · 12 linked practice labs ·skip to practice
Fast pattern recognition for the production failures engineers see most often.
0 playbooks in Debugging Craft
No playbooks found
Nothing matches “”. Try a broader term.
Structured investigations for the failure modes engineers meet in real systems.
React Query Not Refreshing Stale Data Despite Invalidations
Diagnose and resolve cases where React Query fails to update stale data, even when invalidations or refetches are expected to trigger.
“Module Not Supported” Errors in Next.js Edge Runtime
A real-world guide to diagnosing and fixing 'module not supported' errors when deploying Next.js projects to the Edge Runtime.
React Portal Allows Click Events to Bubble Outside Intended DOM
When using React portals, click or key events can bubble up to unexpected ancestors, triggering handlers outside their intended boundaries.
Vue Reactive Property Not Updating in Template
Diagnose and resolve cases where Vue's reactive data fails to reflect changes in the UI, including edge cases beyond the classic pitfalls.
Diagnosing Nuxt Hydration Mismatch Errors in Production
Hydration mismatch errors in Nuxt apps break SSR interactivity and can be tough to pinpoint. This guide walks through investigating, reproducing, and fixing these.
Why Your Vue Composition API ref Isn’t Reactive
Vue’s Composition API refs sometimes fail to trigger reactivity. This guide covers subtle causes, practical debugging, and real-world fixes for non-reactive refs.
Long-form thinking on debugging habits, observability, and the systems around the bug.
Debugging Timezone Date Bugs: A Case Study in UTC vs. Local Time
A practical walkthrough of a timestamp bug that broke a billing system, with reproducible code and debugging tactics.
Floating Point Arithmetic Errors: A Debugging Postmortem
How a $0.0000000000000004 error silently corrupted a financial system, and the debugging techniques that caught it.
Why JSON.parse() Throws and How to Catch It: A Field Guide to Parsing Failures
JSON.parse() seems simple until it throws. Here's a practical guide to the most common — and most maddening — parsing failures I've encountered, with exact error messages and fixes.
Blameless Postmortems: How We Fixed Root Causes Without Firing Anyone
A practical guide to running postmortems that focus on systemic failures, not individual mistakes. Includes a real incident breakdown from a production database outage.
Pair Debugging: How to Debug Together Without Killing Each Other
Pair debugging sounds great on paper. In practice, it's easy to step on each other's toes, go silent, or fight over the keyboard. Here's how to make it work.
Debugging with AI Tools: What Worked and What Didn't in Production
After a year of using GPT-4, Copilot, and Claude to hunt production bugs, here's what actually helped — and what sent me down dead ends.