HMR breaks in Next.js 16.2 when using `manifest.ts`, but reports vary on root cause.
The issue involves Hot Module Replacement (HMR) failing in Next.js 16.2 when a `manifest.ts` file is present. While removing `manifest.ts` resolves the issue for some, others report HMR issues persist even without it. The inconsistency in reproduction and unclear root cause make this a medium-difficulty issue.
https://github.com/abhishekmardiya/hmr-cache-breakage-reproduction.git
Using a manifest.ts file in Next.js 16.2 causes Hot Module Replacement (HMR) to stop working correctly.
After making code changes:
Cmd + Shift + R) does not reflect the latest changesThe only way to see updates is by deleting the .next build folder, after which the changes appear correctly.
manifest.ts file (App Router setup)next dev)Reproduction Video: A screen recording demonstrating the issue can be found here: https://jumpshare.com/s/5HjDdFRVysckgw20tfko
.next and restartingPlatform: darwin
Arch: arm64
Version: Darwin Kernel Version 25.4.0: Thu Mar 19 19:33:09 PDT 2026; root:xnu-12377.101.15~1/RELEASE_ARM64_T8112
Available memory (MB): 16384
Available CPU cores: 8
Binaries:
Node: 24.14.1
npm: 11.11.0
Yarn: N/A
pnpm: N/A
Relevant Packages:
next: 16.2.1 // Latest available version is detected (16.2.1).
eslint-config-next: N/A
react: 19.2.4
react-dom: 19.2.4
typescript: 5.9.3
Next.js Config:
output: N/A
Not sure
next dev (local)
This issue did not occur before Next.js 16.2
manifest.ts restores normal HMR behaviorClaim this issue to let others know you're working on it. You'll earn 20 points when you complete it!