NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #333 most downloaded on pub.dev
Flutter plugin for Cloud Firestore, a cloud-hosted, noSQL database with live synchronization and offline support on Android and iOS.
Last release 17 days ago
14 Sep 2026
Ships on a steady schedule
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
292 releases · first in 2017
FIX: stop FirebaseError appearing in console on hot restart & hot refresh (#9321).
Update a dependency to the latest release.
One column per quarter.
Update a dependency to the latest release.
REFACTOR(firestore): Dart 3 compatibility: change _Updatable to be an actual mixin (#10667).
FIX(firebase_core,web): return empty list from apps getter in WASM mode (#17919).
FIX(core,web): More explicit interop types (#17809).
FIX: allow null values for setDefaultEventParameters() which removes defaults. Permissible on android and iOS. (#9135).
firebase_core_platform_interface version to fix previous release. (bea70ea5)FEAT: bump Firebase JS SDK to 12.3.0 (#17743).
REFACTOR: use firebase.google.com link for homepage in pubspec.yaml (#8724).
Update a dependency to the latest release.
REFACTOR: remove deprecated Tasks.call for android and replace with TaskCompletionSource. (#8522).
Tasks.call for android and replace with TaskCompletionSource. (#8522). (45e27201)Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
REFACTOR: recreate ios, android, web and macOS folders for example app (#8255).
FIX: bump firebase_core_platform_interface version to fix previous release.
firebase_core_platform_interface version to fix previous release. (bea70ea5)Update a dependency to the latest release.
REFACTOR: use "firebase" instead of "FirebaseExtended" as organisation in all links for this repository (#8791).
FIX: Fix Android Firestore transaction crash when running in background caused by null Activity. (#7627).
null Activity. (#7627).Update a dependency to the latest release.
REFACTOR: fix all unnecessary_import analyzer issues introduced with Flutter 2.8.
unnecessary_import analyzer issues introduced with Flutter 2.8.cloud_firestore_odm_generator - v1.0.0-dev.5REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
TARGET_OS_OSX (#7116).DOCS: update firestore dartpad example.
FIX(readme): Update getting started link to reflect latest version (#10700).
FIX(auth,windows): fix a crash that could happen when using sendEmailVerification or sendPasswordResetEmail (#12946).
FEAT: bump Firebase JS SDK to 12.2.1 (#17678).
FirebaseApp instances from Dart (#6549).Bump platform interface a major version due to pigeon dependency update
Note: This release has breaking changes.
minSdk version to 19 as this is required by Firebase Android SDK 29.0.0 (#7298).REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7147).
TARGET_OS_OSX (#7116).FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184).
DocumentReference & withConverter (#7020).withConverter.endBeforeDocument incorrectly behaved as endAtDocument.Query.== throws when using withConverter (#6997).REVERT: Firestore cache snapshot connections with underlying native listener (#6819) (#6974).
FIX: Fixed macOS project not compiling by symlinking missing header file: Crashlytics_Platform.h
Crashlytics_Platform.hFEAT: update dependency constraints to sdk: '>=2.18.0 <4.0.0' flutter: '>=3.3.0' (#10946).
FEAT: upgrade to dart 3 compatible dependencies (#10890).
FEAT(firebase_ai): Add support for Grounding with Google Search (#17468).
FIX(auth,web): fix currentUser being null when using emulator or named instance (#10565).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_functions - v5.6.0cloud_functions_platform_interface - v5.8.0firebase_ai - v2.2.0firebase_core - v3.15.0firebase_core_platform_interface - v5.4.1firebase_core_web - v2.24.0firebase_crashlytics - v4.3.8firebase_storage - v12.4.8firebase_vertexai - v1.8.1cloud_functions_web - v4.11.3firebase_crashlytics_platform_interface - v3.8.8_flutterfire_internals - v1.3.57firebase_in_app_messaging_platform_interface - v0.2.5+8firebase_auth_web - v5.15.1firebase_in_app_messaging - v0.8.1+8firebase_remote_config - v5.4.6firebase_app_installations_web - v0.1.6+14firebase_remote_config_web - v1.8.6firebase_app_installations - v0.3.2+8firebase_auth - v5.6.1firebase_remote_config_platform_interface - v1.5.6firebase_database - v11.3.8cloud_firestore_platform_interface - v6.6.10firebase_auth_platform_interface - v7.7.1firebase_database_platform_interface - v0.2.6+8firebase_app_installations_platform_interface - v0.1.4+56firebase_messaging_web - v3.10.8firebase_analytics - v11.5.1firebase_database_web - v0.2.6+14cloud_firestore_web - v4.4.10firebase_messaging_platform_interface - v4.6.8firebase_data_connect - v0.1.5+2firebase_analytics_platform_interface - v4.4.1firebase_analytics_web - v0.5.10+14firebase_messaging - v15.2.8firebase_ml_model_downloader_platform_interface - v0.1.5+8firebase_dynamic_links - v6.1.8firebase_ml_model_downloader - v0.3.3+6firebase_dynamic_links_platform_interface - v0.2.7+8cloud_firestore - v5.6.10firebase_performance - v0.10.1+8firebase_performance_platform_interface - v0.1.5+8firebase_performance_web - v0.1.7+14firebase_app_check_platform_interface - v0.1.1+8firebase_storage_web - v3.10.15firebase_app_check_web - v0.2.0+12firebase_app_check - v0.3.2+8firebase_storage_platform_interface - v5.2.8Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cloud_functions_web - v4.11.3firebase_crashlytics_platform_interface - v3.8.8_flutterfire_internals - v1.3.57firebase_in_app_messaging_platform_interface - v0.2.5+8firebase_auth_web - v5.15.1firebase_in_app_messaging - v0.8.1+8firebase_remote_config - v5.4.6firebase_app_installations_web - v0.1.6+14firebase_remote_config_web - v1.8.6firebase_app_installations - v0.3.2+8firebase_auth - v5.6.1firebase_remote_config_platform_interface - v1.5.6firebase_database - v11.3.8cloud_firestore_platform_interface - v6.6.10firebase_auth_platform_interface - v7.7.1firebase_database_platform_interface - v0.2.6+8firebase_app_installations_platform_interface - v0.1.4+56firebase_messaging_web - v3.10.8firebase_analytics - v11.5.1firebase_database_web - v0.2.6+14cloud_firestore_web - v4.4.10firebase_messaging_platform_interface - v4.6.8firebase_data_connect - v0.1.5+2firebase_analytics_platform_interface - v4.4.1firebase_analytics_web - v0.5.10+14firebase_messaging - v15.2.8firebase_ml_model_downloader_platform_interface - v0.1.5+8firebase_dynamic_links - v6.1.8firebase_ml_model_downloader - v0.3.3+6firebase_dynamic_links_platform_interface - v0.2.7+8cloud_firestore - v5.6.10firebase_performance - v0.10.1+8firebase_performance_platform_interface - v0.1.5+8firebase_performance_web - v0.1.7+14firebase_app_check_platform_interface - v0.1.1+8firebase_storage_web - v3.10.15firebase_app_check_web - v0.2.0+12firebase_app_check - v0.3.2+8firebase_storage_platform_interface - v5.2.8Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
firebase_ai - v3.1.0firebase_auth - v6.0.1firebase_auth_platform_interface - v8.1.0firebase_vertexai - v2.1.0firebase_data_connect - v0.2.0+1firebase_auth_web - v6.0.1Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
firebase_data_connect - v0.2.0+1firebase_auth_web - v6.0.1loadBundle() & namedQueryGet() (#6037).FEAT(remote-config,windows): add support for windows (#18006).
BREAKING FEAT: bump iOS SDK to version 12.0.0 (#17549).
Note: This release has breaking changes.
FEAT: Add withConverter function to CollectionReference, DocumentReference and Query (#6015). This new method allows interacting with collections/documents in a type-safe way:
final modelsRef = FirebaseFirestore
.instance
.collection('models')
.withConverter<Model>(
fromFirestore: (snapshot, _) => Model.fromJson(snapshot.data()!),
toFirestore: (model, _) => model.toJson(),
);
Future<void> main() async {
// Writes now take a Model as parameter instead of a Map
await modelsRef.add(Model());
final Model model = await modelsRef.doc('123').get().then((s) => s.data());
}
BREAKING REFACTOR: DocumentReference, CollectionReference, Query, DocumentSnapshot,
CollectionSnapshot, QuerySnapshot, QueryDocumentSnapshot, Transaction.get, Transaction.set
and WriteBatch.set now take an extra generic parameter. (#6015).
See the migration guide for more information on how to update your code.
BREAKING FEAT: convert FieldPath parameters from dynamic to Object (#5997).
FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184).
FIX: initialize auth and auth listener in standalone OAuth buttons (#9926).
Update a dependency to the latest release.
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
FIX: cannot store null values in firestore on the web (#5335).
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
firebase_app_check_web - v0.2.0firebase_data_connect - v0.1.2+1firebase_storage - v12.3.4firebase_app_check - v0.3.1+4Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
firebase_app_check - v0.3.1+4Use the Vertex AI in Firebase SDK to call the Vertex AI Gemini API directly from your app. This client SDK is built specifically for use with Flutter
Use the Vertex AI in Firebase SDK to call the Vertex AI Gemini API directly from your app. This client SDK is built specifically for use with Flutter apps, offering security options against unauthorized clients as well as integrations with other Firebase services.
Bump "cloud_firestore" to 1.0.0-1.0.nullsafety.0.
1.0.0-1.0.nullsafety.0.FIX: Fixed crashes due to null Settings (#5031).
Settings (#5031).Update a dependency to the latest release.
> Note: This release has breaking changes.
Note: This release has breaking changes.
Nothing published for this version
> Note: This release has breaking changes.
Note: This release has breaking changes.
> Note: This release has breaking changes.
Note: This release has breaking changes.
FEAT: bump android com.android.tools.build & 'com.google.gms:google-services versions (#4269).
com.android.tools.build & 'com.google.gms:google-services versions (#4269).Update a dependency to the latest release.
FEAT: migrate firebase interop files to local repository (#3973).
compileSdkVersion to 29 in preparation for upcoming Play Store requirement.FirebaseFirestore.enablePersistence now accepts PersistenceSettingsPersistenceSettings classFirebaseFirestore.clearPersistenceFirebaseFirestore.terminateFirebaseFirestore.waitForPendingWritesSetOptions.mergeFieldsGetOptions support for querying against server/cacheQuery.limitToLastFirebaseFirestore.snapshotsInSyncFEAT: bump compileSdkVersion to 29 (#3975).
FIX: remove listener if available (#3452).
updateBlock reference in Firestore docs (#3728).Your coding agent can read these notes before it upgrades. Set up the MCP server →