Fast Refresh not compatible with React Hooks call chain
Nobody has claimed this yet.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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