Fast Refresh not compatible with React Hooks call chain

[NiuGuohui]

Description

During the development process, when adding or deleting hooks, the devServer was not compatible with the destructive modifications to the hook chain. Instead, it directly caused React Native to report an error, making the application unable to run anymore and requiring a restart.

Android Platform

React has detected a change in the order of Hooks called by App. This will lead to bugs and errors if not fixed. For more information, read the Rules of Hooks: https://react.dev/link/rules-of-hooks

   Previous render            Next render
   ------------------------------------------------------
1. useSyncExternalStore       useSyncExternalStore
2. undefined                  useState
   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 Error Stack:
    at App (App.tsx:18:30)

Error: Rendered more hooks than during the previous render.
    at updateWorkInProgressHook (ReactFabric-dev.js:4039:22)
    at updateReducer (ReactFabric-dev.js:4158:42)
    at useState (ReactFabric-dev.js:15273:31)
    at anonymous (react.development.js:1222:42)
    at App (App.tsx:18:30)

Steps to reproduce

• clone this repo and run dev
• open App.tsx
• Comment out line 18. (code: const breakChain = useState(null);)
• save changes
• app was report an error
• You can try to comment this line of code repeatedly to repeat the bug

React Native Version

0.82.1

Affected Platforms

Runtime - Android

Output of npx @react-native-community/cli info

System:
  OS: macOS 26.0.1
  CPU: (10) arm64 Apple M1 Max
  Memory: 2.05 GB / 64.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 22.21.1
    path: /Users/ollie/.nvm/versions/node/v22.21.1/bin/node
  Yarn:
    version: 1.22.22
    path: /Users/ollie/.nvm/versions/node/v22.21.1/bin/yarn
  npm:
    version: 10.9.4
    path: /Users/ollie/.nvm/versions/node/v22.21.1/bin/npm
  Watchman: Not Found
Managers:
  CocoaPods: Not Found
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 25.0
      - iOS 26.0
      - macOS 26.0
      - tvOS 26.0
      - visionOS 26.0
      - watchOS 26.0
  Android SDK: Not Found
IDEs:
  Android Studio: 2025.1 AI-251.27812.49.2514.14217341
  Xcode:
    version: 26.0.1/17A400
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.17
    path: /Users/ollie/.jenv/shims/javac
  Ruby:
    version: 2.6.10
    path: /usr/bin/ruby
npmPackages:
  "@react-native-community/cli":
    installed: 20.0.0
    wanted: 20.0.0
  react:
    installed: 19.1.1
    wanted: 19.1.1
  react-native:
    installed: 0.82.1
    wanted: 0.82.1
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: true
iOS:
  hermesEnabled: Not found
  newArchEnabled: false

Stacktrace or Logs

React has detected a change in the order of Hooks called by App. This will lead to bugs and errors if not fixed. For more information, read the Rules of Hooks: https://react.dev/link/rules-of-hooks

   Previous render            Next render
   ------------------------------------------------------
1. useSyncExternalStore       useSyncExternalStore
2. undefined                  useState
   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 Error Stack:
    at App (App.tsx:18:30)

MANDATORY Reproducer

https://github.com/NiuGuohui/ReactNativeFastRefreshBug

Screenshots and Videos

No response

[NiuGuohui]

Could someone please answer this question?

[Thotaharshavardhani]

Hi @NiuGuohui , I was able to reproduce a hooks order mismatch, but in my run the error reported “Rendered fewer hooks than expected” instead of “Rendered more hooks than during the previous render” as you mentioned — it still indicates a hooks order conflict right?

[NiuGuohui]

@Thotaharshavardhani Yes, essentially, both of these error reports are caused by the destruction of the component's hook chain after React hot updates.

[cortinico]

@devanshsaini11 were you able to reproduce locally?

[devanshsaini11]

Hi @cortinico
@Thotaharshavardhani was able to reproduce this locally

[NiuGuohui]

@cortinico Is this issue expected to be fixed in version 0.83? This issue greatly affects the development experience.

[ArekChr]

This patch should help

diff --git a/node_modules/react-refresh/cjs/react-refresh-runtime.development.js b/node_modules/react-refresh/cjs/react-refresh-runtime.development.js
index 2b5a3aa..a40bc4e 100644
--- a/node_modules/react-refresh/cjs/react-refresh-runtime.development.js
+++ b/node_modules/react-refresh/cjs/react-refresh-runtime.development.js
@@ -194,7 +194,9 @@ function performReactRefresh() {
       updatedFamiliesByType.set(nextType, family);
       family.current = nextType; // Determine whether this should be a re-render or a re-mount.
 
-      if (canPreserveStateBetween(prevType, nextType)) {
+      var shouldPreserveState = typeof navigator !== 'undefined' && navigator.product === 'ReactNative' ? false : canPreserveStateBetween(prevType, nextType);
+
+      if (shouldPreserveState) {
         updatedFamilies.add(family);
       } else {
         staleFamilies.add(family);