{"record":{"id":"80741ae2ac966f83","repo":"vercel/next.js","slug":"fast-refresh-had-to-perform-a-full-reload-filemes","errorCode":null,"errorMessage":"Fast Refresh had to perform a full reload${fileMessage}. Read more: https://nextjs.org/docs/messages/fast-refresh-reload","messagePattern":"Fast Refresh had to perform a full reload(.+?)\\. Read more: https://nextjs\\.org/docs/messages/fast-refresh-reload","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/next/src/server/dev/hot-reloader-webpack.ts","lineNumber":606,"sourceCode":"                    if (modules.length > 0) {\n                      fileMessage = ` when ${modules.join(', ')} changed`\n                    }\n                  } else if (\n                    // Handle known webpack layers\n                    file.startsWith(`(${WEBPACK_LAYERS.pagesDirBrowser})/`)\n                  ) {\n                    const cleanedFilePath = file.slice(\n                      `(${WEBPACK_LAYERS.pagesDirBrowser})/`.length\n                    )\n\n                    fileMessage = ` when ${cleanedFilePath} changed`\n                  } else {\n                    fileMessage = ` when ${file} changed`\n                  }\n                }\n              }\n\n              Log.warn(\n                `Fast Refresh had to perform a full reload${fileMessage}. Read more: https://nextjs.org/docs/messages/fast-refresh-reload`\n              )\n              break\n            }\n            case 'browser-logs': {\n              await receiveBrowserLogsWebpack({\n                entries: payload.entries,\n                router: payload.router,\n                sourceType: payload.sourceType,\n                clientStats: () => this.clientStats,\n                serverStats: () => this.serverStats,\n                edgeServerStats: () => this.edgeServerStats,\n                rootDirectory: this.dir,\n                distDir: this.distDir,\n                config:\n                  (this.config.logging &&\n                    this.config.logging.browserToTerminal) ||\n                  false,","sourceCodeStart":588,"sourceCodeEnd":624,"githubUrl":"https://github.com/vercel/next.js/blob/258b1c1bc05f7099816b88f70b7b3422b24a4b8d/packages/next/src/server/dev/hot-reloader-webpack.ts#L588-L624","documentation":"Dev-server warning in hot-reloader-webpack's onHMR: a hot update touched files outside what Fast Refresh can patch (non-React modules or special webpack layers), so a full reload was required. fileMessage names the changed module(s) — extracted from the update payload or cleaned of layer prefixes — that forced the fallback from incremental hot swap to reload.","triggerScenarios":"Thrown at packages/next/src/server/dev/hot-reloader-webpack.ts:607 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Keep React component files exporting only components so Fast Refresh can hot-update; see the fast-refresh-reload docs."],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"258b1c1bc05f7099816b88f70b7b3422b24a4b8d","analyzedAt":"2026-08-19T02:10:13.922Z","contentChangedAt":"2026-08-19T02:10:13.922Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}