Production troubleshooting

Production bugs,
decoded.

Root causes, fixes and in-browser tools for the failures that only show up after you ship — Next.js, Supabase, PostgreSQL and TypeScript.

Sources linkedChecked against official docsTools run in your tab

Just Published

Our three most recent articles. No curve, no algorithm — just dates.

TypeScript

Fix ESLint: Module.createRequire is not a function

Reproduced on Node 10 vs Node 18 with the same node_modules: the crash is the Node runtime executing ESLint, not Parcel or a broken module resolution.

8 min read
TypeScript

Fix "X is not a constructor" from a plain require()

Why adding a property to exports and then requiring it without destructuring hands you an object instead of a constructor, reproduced on current Node.js.

7 min read
TypeScript

Fix tar EPERM: operation not permitted, futime

Reproduce the ownership mismatch behind the warning, see how a current npm install actually fails, and fix the layer that creates it.

9 min read

More production fixes

All articles
TypeScript

Tailwind upgrade: Could not load the configuration file

Reproduced on Windows 11 with a virtual drive: the exact failing version, why @next still breaks today, and the command that migrates a v3 project cleanly.

7 min read
Next.js

Fix: useRouter query undefined on first render

Why Next.js hydrates a dynamic Pages Router page with an empty query object, how router.isReady fixes it, and why the App Router does not have this exact problem.

7 min read
TypeScript

Fix Failed to replace env in config: NPM_TOKEN

Separate an npmrc parsing failure from registry authentication, with reproduced npm and Yarn Classic controls and a secret-safe CI fix.

8 min read
TypeScript

Fix Vite: Preprocessor dependency "sass" not found

Separate a missing Sass compiler from a webpack loader, an omitted build dependency and a Tailwind integration error before changing your configuration.

8 min read
TypeScript

Fix pnpm ERR_PNPM_LINKING_FAILED on Windows

Find the process or path preventing a pnpm rename, distinguish a locked package from a version regression, and retain the dependency resolution.

9 min read
TypeScript

Fix pnpm ERR_PNPM_OUTDATED_LOCKFILE in CI

Find the mismatched workspace importer, align the pnpm version, and prove the repaired lockfile installs without changing a byte.

8 min read
TypeScript

Fix Vite React error #130: react-multi-carousel

A current client bundle reproduces the carousel import failure before hosting, then renders successfully after changing only the component value.

8 min read
Next.js

Fix TransformStream is not defined in Jest

Separate an old Node limitation from a missing Jest global, then verify the stream reads, writes and closes without replacing the Worker runtime.

8 min read
TypeScript

Fix slow Tailwind v3 in Vite: remove catch-all safelists

Separate oversized generated CSS from plugin cost, with a single-change compiler reproduction and an Autoprefixer negative control.

8 min read
Newsletter

One email a month. No fluff.

Mostly RLS gotchas, Next.js cache debugging notes, and the one Supabase setting that bit me last month. Written like a friend would tell you, not like a marketing team.

  • Real production lessons, not tutorials
  • New post highlights with key takeaways
  • Unsubscribe in one click. No tracking.

Free forever. Your email stays with me.