🔥 [🐛] iOS build fails: cannot find 'RCTPromiseRejectBlock' in scope in RNFBFirestoreCommon.h (v24 + Expo SDK 55 + use_frameworks!:static)

[cathandnya]

Issue

On iOS, building an Expo SDK 55 / React Native 0.83.4 app that uses @react-native-firebase/firestore@24.0.0 with use_frameworks!: :static fails with:

node_modules/@react-native-firebase/firestore/ios/RNFBFirestore/RNFBFirestoreCommon.h:40:42:
  error: cannot find 'RCTPromiseRejectBlock' in scope
+ (void)promiseRejectFirestoreException:(RCTPromiseRejectBlock)reject error:(NSError *)error;
                                         ^

Similar errors are also raised in RNFBFirestoreCollectionModule.h and the other Firestore headers that expose methods taking RCTPromiseRejectBlock / RCTResponseSenderBlock.

Root cause

Two separate issues in the shipped iOS sources of @react-native-firebase/firestore@24.0.0:

1. Header import order. In every .h under ios/RNFBFirestore/, #import <Firebase/Firebase.h> is placed before #import <React/RCTBridgeModule.h>:

   // RNFBFirestoreCommon.h (current)
   #import <Firebase/Firebase.h>
   #import <React/RCTBridgeModule.h>

   With Expo's default use_frameworks!: :static + Xcode 26, resolving Firebase first seems to prevent React/RCTBridgeModule.h from contributing its block typedefs into scope, so RCTPromiseRejectBlock / RCTResponseSenderBlock are not visible to later declarations in the same file.

2. Missing import in .m sources. Several implementation files call RCTPromiseRejectBlock / RCTResponseSenderBlock but never import <React/RCTBridgeModule.h> directly — they were relying on the header chain picking it up. Affected files:

   • RNFBFirestoreCollectionModule.m
   • RNFBFirestoreCommon.m
   • RNFBFirestoreDocumentModule.m
   • RNFBFirestoreModule.m
   • RNFBFirestoreTransactionModule.m

Why this is not #8883

#8883 covers RN 0.84's pre-compiled rncore colliding with RNFB modulemaps across all RNFB pods (Auth / Messaging / Firestore etc.). This project runs RN 0.83.4, where RCT_USE_PREBUILT_RNCORE is not set and the pre-compiled default is off. Also only @react-native-firebase/firestore failed to compile — @react-native-firebase/app and @react-native-firebase/auth built without any patch. The workaround for #8883 (Podfile preinstall hook to force-static RNFB, or RCT_USE_PREBUILT_RNCORE=0) does not address the import declarations in Firestore sources.

Steps to reproduce

1. Create an Expo SDK 55 app (RN 0.83.4) with use_frameworks!: :static, Xcode 26 / iOS 15.1 deployment target.
2. Install @react-native-firebase/app@^24, @react-native-firebase/auth@^24, @react-native-firebase/firestore@^24.
3. npx expo prebuild --clean && npx expo run:ios.
4. Build fails at RNFBFirestoreCommon.h:40 with cannot find 'RCTPromiseRejectBlock' in scope.

Workaround applied (patch-package style)

Two edits across the Firestore iOS sources:

a) Reorder .h imports so React comes before Firebase

-#import <Firebase/Firebase.h>
-#import <React/RCTBridgeModule.h>
+#import <React/RCTBridgeModule.h>
+#import <Firebase/Firebase.h>

Applied to every file under ios/RNFBFirestore/ that imports both (RNFBFirestoreCommon.h, RNFBFirestoreCollectionModule.h, RNFBFirestoreDocumentModule.h, RNFBFirestoreModule.h, RNFBFirestoreQuery.h, RNFBFirestoreSerialize.h, RNFBFirestoreTransactionModule.h).

b) Add <React/RCTBridgeModule.h> to each .m that uses RCTPromiseRejectBlock / RCTResponseSenderBlock

+#import <React/RCTBridgeModule.h>
 #import <RNFBApp/RNFBRCTEventEmitter.h>

Applied to the five .m files listed above.

After these two edits, npx expo run:ios succeeds and Firestore reads/writes (including emulator-based E2E) pass.

---

Project Files

Javascript

Click To Expand

package.json (excerpt):

```json
{
"dependencies": {
"expo": "~55.0.15",
"react": "19.2.0",
"react-native": "0.83.4",
"@react-native-firebase/app": "24.0.0",
"@react-native-firebase/auth": "24.0.0",
"@react-native-firebase/firestore": "24.0.0"
}
}
```

iOS

Click To Expand

ios/Podfile.properties.json:

```json
{
"expo.jsEngine": "hermes",
"ios.deploymentTarget": "15.1",
"ios.useFrameworks": "static"
}
```

Podfile itself is generated by Expo prebuild and is not manually customized.

---

Environment

• Platform: iOS (not tested on Android; Android builds are green with the same package versions in our project)
• react-native-firebase version: 24.0.0 for app, auth, firestore
• Firebase module(s) with the issue: firestore (auth and app build fine without any patch)
• TypeScript: Y, ~5.9.2
• React Native: 0.83.4 (Expo SDK 55)
• Xcode: 26.0.1 on macOS 26.4
• iOS deployment target: 15.1
• use_frameworks!: :static (via expo-build-properties)
• RCT_USE_PREBUILT_RNCORE not set (RN 0.83 default)

`react-native info` is tricky to produce from a fully-Expo project; happy to supply a sample repo if useful.

---

Thanks for maintaining this library. Let me know if you'd like a PR that just reorders the imports and adds the missing <React/RCTBridgeModule.h> in the five .m sources — the change is mechanical and non-breaking on older RN versions.

[russellwheatley]

Hey @cathandnya - thank you for such a detailed issue report! We can get this looked at and confirmed (if possible, hoping Xcode 26.1 isn't a requirement), and have a fix for the next release 🙏

[russellwheatley]

Hey @cathandnya - I built an expo build harness to test RNFB packages: #8994

Initially, I was seeing the same build errors as you've shown here, but once I updated my app.config.js (expo config), as described here: #8657 (comment)

I was able to build the app. Could you try it out and let me know if this solves your issue?

``

[pawan-procam]

I am also getting this when updated to react native 0.84.1. sharing the pod file and packages version which I am using.

` def node_require(script)

Resolve script with node to allow for hoisting

require Pod::Executable.execute_command('node', ['-p',
"require.resolve(
'#{script}',
{paths: [process.argv[1]]},
)", dir]).strip
end

node_require('react-native/scripts/react_native_pods.rb')
node_require('react-native-permissions/scripts/setup.rb')
setup_permissions([
'AppTrackingTransparency',

'Camera',

'Notifications',
'PhotoLibrary',
'PhotoLibraryAddOnly',

])
platform :ios, min_ios_version_supported

use_frameworks!
prepare_react_native_project!

linkage = ENV['USE_FRAMEWORKS']
if linkage != nil
Pod::UI.puts "Configuring Pod with #{linkage}ally linked Frameworks".green
use_frameworks! :linkage => linkage.to_sym
end

abstract_target 'hdorEventsCommonPods' do
rn_maps_path = '../node_modules/react-native-maps'
pod 'react-native-maps/Google', :path => rn_maps_path
config = use_native_modules!
pod 'Firebase', :modular_headers => true
pod 'FirebaseCoreInternal', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
pod 'FirebaseMessaging', :modular_headers => true
pod 'FirebaseAnalytics', :modular_headers => true
pod 'GoogleUtilities', :modular_headers => true
use_frameworks! :linkage => :static
$RNFirebaseAsStaticFramework = true
use_react_native!(
:path => config[:reactNativePath],

:app_path => "#{Pod::Config.instance.installation_root}/.."

)

$RNGoogleMobileAdsAsStaticFramework = true
target 'hdorEvents' do

pod 'Firebase/Messaging'

end

target 'hdorEvents In' do

pod 'Firebase/Messaging'

end

target 'hdorEvents Other' do

pod 'Firebase/Messaging'

end

target 'NotificationService' do

use_frameworks! :linkage => :static

pod 'WEServiceExtension'
end

target 'ContentExtension' do
use_frameworks! :linkage => :static
pod 'WEContentExtension'
end

post_install do |installer|

react_native_post_install(
  installer,
  config[:reactNativePath],
  :mac_catalyst_enabled => false,

)
installer.pods_project.targets.each do |target|
 target.build_configurations.each do |config|
   config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.1'
   config.build_settings['APPLICATION_EXTENSION_API_ONLY'] = 'No'
   config.build_settings['CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES'] = 'YES'
  end
 end

end
end
`
basically I have upgraded the application. am I missing any configuration

Package.json file what I have is
@react-native-firebase/analytics": "^24.0.0",
"@react-native-firebase/app": "^24.0.0",
"@react-native-firebase/crashlytics": "^24.0.0",
"@react-native-firebase/messaging": "^24.0.0",

Thank you for any help in Advance!

[github-actions]

Hello 👋, to help manage issues we automatically close stale issues.

This issue has been automatically marked as stale because it has not had activity for quite some time.Has this issue been fixed, or does it still require attention?

This issue will be closed in 15 days if no further activity occurs.

Thank you for your contributions.

[ccorneliusHsv]

I don't believe this is stale. I have not seen a fix for this yet.