Version 24 includes breaking changes for Firestore TypeScript types and Cloud Functions native integration. Review the sections below for the modules you use.
Version 24 introduces withConverter functionality from Firebase JS SDK. Due to the differences in types between references and queries in namespace vs modular API, and the namespaced APIs deprecation cycle being effectively complete with the API set for removal, we have adopted the modular API typing in general for firestore APIs.
Reference and query types have been updated to support input of two generic types (AppModelType, DbModelType).
Additionally, to match the JS SDK, they are now exported separately at the root, instead of through FirebaseFirestoreTypes.
Most commonly these types will be affected: CollectionReference, DocumentReference, DocumentSnapshot, QueryDocumentSnapshot, QuerySnapshot, Query.
// Previously
import { doc, getFirestore, onSnapshot, FirebaseFirestoreTypes } from '@react-native-firebase/firestore';
onSnapshot(doc(getFirestore(), 'foo', 'foo'), {
next: (snapshot: FirebaseFirestoreTypes.DocumentSnapshot) => {
console.log(snapshot.get('foo'));
},
});// Now
import { doc, getFirestore, onSnapshot, DocumentSnapshot } from '@react-native-firebase/firestore';
onSnapshot(doc(getFirestore(), 'foo', 'foo'), {
next: (snapshot: DocumentSnapshot) => {
console.log(snapshot.get('foo'));
},
});PR: #8603 / v24.0.0 (#8799 streaming callables)
From v24 onward, @react-native-firebase/functions is implemented as a TurboModule and requires React Native's New Architecture. The legacy bridge module was removed.
| You use… | Action |
|---|---|
@react-native-firebase/functions on New Architecture | No change required |
@react-native-firebase/functions on the legacy architecture | Enable New Architecture, or stay on v23 if you cannot migrate yet |
| Other RN Firebase modules only | Functions is the first module with a hard requirement; @react-native-firebase/app prints a deprecation warning on legacy architecture builds |
React Native CLI (Android) — set in android/gradle.properties:
newArchEnabled=trueReact Native CLI (iOS) — New Architecture is enabled when RCT_NEW_ARCH_ENABLED=1 during pod install (React Native sets this from newArchEnabled on recent templates). Follow the React Native New Architecture guide for your RN version.
Expo — enable in your app config (Expo SDK 52+):
{
"expo": {
"newArchEnabled": true
}
}Rebuild native projects after changing this (pod install, clean Android build).
- Android: the Functions Gradle script fails the build with
New Architecture support is required for @react-native-firebase/functions. - iOS:
pod installfails withRNFBFunctions requires New Architecture. Enable New Architecture to use this module.
The JavaScript API (functions(), httpsCallable, modular helpers) is unchanged. v24 also adds httpsCallable().stream() support, which relies on the TurboModule implementation.
Other React Native Firebase modules still run on legacy architecture in v24, but old architecture support is deprecated project-wide and will be required for additional modules in future releases.

Core / App