React Native 0.87 · 0.88 · Expo SDK 58
Will your libraries build on React Native 0.88?
React Native 0.88 has no breaking changes of its own, but 0.87 had two that break libraries. Anyone coming from 0.86 or earlier, including every Expo SDK 57 app moving to SDK 58, meets both. We checked the 590 most downloaded React Native libraries with native code.
What breaks
iOS: React headers without React/. 0.87 ships its iOS headers as XCFrameworks, so a library that writes #import "RCTBridge.h" instead of #import <React/RCTBridge.h> stops the build with "file not found". We compiled every React Native 0.87.1 header both ways to know exactly which imports fail: details and a workaround.
JavaScript: APIs removed in 0.87. InteractionManager and the StatusBar methods setBackgroundColor, setTranslucent and setNetworkActivityIndicatorVisible are gone: development builds throw, release builds crash on the call (fix for InteractionManager). Calls behind a version check, in comments or in web-only files are not counted.
Libraries that break (18)
Sorted by weekly downloads. Status checked on 18 October 2026; if a fix has shipped since, update the library.
| Library | Weekly downloads | Problem | Status |
|---|---|---|---|
@react-native-menu/menu2.0.0 | 329,306 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request |
react-native-date-picker5.0.13 | 277,694 | iOS build stops: "RCTComponent.h" not found | Fix proposed in a pull request |
react-native-ios-context-menu3.2.1 | 176,424 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request |
react-native-ios-utilities5.2.0 | 172,720 | iOS build stops: "RCTBridge.h" not found | Also fails for other reasons (removed legacy-architecture APIs, Swift errors) |
react-native-bottom-tabs1.4.0 | 78,775 | iOS build stops: "RCTConversions.h" not found | Fixed on main, in the next release |
react-native-svg-charts5.4.0 | 62,854 | Crashes when it calls InteractionManager, removed in 0.87 | No fix; marked unmaintained |
react-native-rate1.2.12 | 28,952 | iOS build stops: "RCTBridgeModule.h" not found | No fix yet; no release since 2024 |
@giphy/react-native-sdk6.0.3 | 28,189 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request |
react-native-agora4.6.4 | 22,310 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request (tested) |
react-native-emoji-popup0.3.3 | 17,724 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request (tested) |
react-native-screen-corner-radius0.2.3 | 7,572 | iOS build stops: "RCTBridgeModule.h" not found | Fix proposed in a pull request (tested) |
@bsky.app/react-native-uitextview2.7.1 | 7,472 | iOS build stops: "RCTBridge.h" not found | Fixed on main, in the next release |
@danielsaraldi/react-native-blur-view3.1.0 | 6,783 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request (tested) |
react-native-external-display0.6.6 | 5,409 | iOS build stops: "RCTSurfaceTouchHandler.h" not found | No fix yet; marked unmaintained |
@shopify/react-native-performance4.1.2 | 3,404 | Crashes when it calls InteractionManager, removed in 0.87 | No fix; repository archived |
react-native-auto-skeleton0.1.33 | 3,143 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request (tested) |
@react-native-community/audio-toolkit2.0.3 | 2,667 | iOS build stops: "RCTUtils.h" not found | No fix yet; marked unmaintained |
react-native-multiple-modals3.5.0 | 1,880 | iOS build stops: "RCTBridge.h" not found | Fix proposed in a pull request (tested) |
What this does not check
Android builds (0.87 also moves to Android Gradle Plugin 9), runtime behavior and anything outside these two changes. A library that passes here can still need an update for other reasons; a library listed here certainly does. The scan reads each library's published iOS and JavaScript sources from npm; nothing was executed except our own test builds.
Check the libraries your app uses
npx nativekeelNativeKeel reads the iOS code of your installed libraries and reports the ones that will stop the build on 0.87, before you upgrade. Free and open source, runs on your machine.
NativeKeelMore React Native fixes