Start here / reading paths
A short set of useful guides.
These reading paths cover the work that tends to get messy: releases, upgrades, and the framework details that are easy to miss. Start with the job in front of you.
Release workflow
Ship changes without guessing
A practical route through preview checks, Worker configuration, and the small failures that only show up after deploy.
You end up with a repeatable release check instead of a pile of browser tabs.
- 01Compare Preview and Production Before You MergeCatch preview deployment drift in status codes, redirects, headers, cookie attributes, canonical URLs, and robots metadata before production.
- 02Lint wrangler.jsonc in GitHub Actions Before You DeployRun Cloudflare Workers config checks in GitHub Actions, annotate exact Wrangler lines, scan monorepos, and upload SARIF when you need it.
Maintenance
Upgrade the stack without a surprise
Useful when a runtime, package manager, framework, or lint setup changes underneath an otherwise healthy project.
You can separate a real compatibility problem from a noisy install warning and test the right path.
- 01Node 20 Is EOL: Find Every Runtime Pin Before a Failed DeployNode 20 is EOL. Audit package metadata, CI, Docker, and host settings, choose a supported target, then verify every runtime pin before a deploy fails.
- 02Run TypeScript 7 Without Breaking typescript-eslintFix TypeScript 7 ESLint peer conflicts and Cjs crashes by running TypeScript 7 beside the TypeScript 6 compatibility API, with a verified npm setup.
- 03pnpm 11 Ignored Your Overrides: Move Config Before CI Rewrites Itpnpm 11 moved project settings out of package.json. Migrate overrides and build policy to pnpm-workspace.yaml before CI rewrites your lockfile.
Next.js
Make App Router changes less painful
Migration notes and focused fixes for route params, hydration, caching, and the things that often get missed outside the page component.
You get a clearer upgrade path and a better checklist for catching the quiet regressions.
- 01Migrate Next.js Pages Router to App Router Without Breaking EverythingA detailed Pages Router to App Router migration guide covering layouts, route structure, Server Components, caching, metadata, forms, auth, testing, and a safe rollout.
- 02Fix Next.js Hydration Errors in Production Without GuessingA practical way to find the first server and browser difference behind a Next.js hydration error, with fixes for dates, browser APIs, HTML nesting, and extensions.
- 03Next.js 16 Cache Components: Choose cacheLife Before You Cache DataUse a clear freshness contract for Next.js 16 Cache Components: decide what can be shared, set cacheLife deliberately, tag reads, and test invalidation.