react / react/react-native

Fast Refresh not compatible with React Hooks call chain

Open
#54,507 7 comments 8 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Debugging Issue: Author Provided Repro Needs: React Native Team Attention
Dominant language
C++
Stars
127k
Forks
25.3k
Avg merge
1d 23h
Merged PRs (30d)
4

Description

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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the mandatory reproducer and App.tsx line 18, then reproduce the issue on Android with React Native 0.82.1 while repeatedly commenting and uncommenting the hook. Investigate the Fast Refresh and devServer behavior around the changed hook chain. Done means saving these edits no longer leaves the app unable to run or requiring a restart.

Written by the indexing model from the issue text.

Assessment

Tech stack
react-native, typescript
Domain
developer-experience, mobile
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.