NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #946 most downloaded on pub.dev
Flutter plugin for Firebase Database, a cloud-hosted NoSQL database with realtime data syncing across Android and iOS clients, and offline access.
Last release 22 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
222 releases · first in 2017
Update a dependency to the latest release.
Update a dependency to the latest release.
Update a dependency to the latest release.
One column per quarter.
FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184).
REFACTOR(platform_interface): replace Flutter UI and foundation imports with package:meta (#18604).
FIX: Fix MissingPluginException caused by malformed EventChannel name. (#7859).
MissingPluginException caused by malformed EventChannel name. (#7859).MissingPluginException caused by malformed EventChannel name. (#7859). (b69be414)FIX: bump Android compileSdkVersion to 31 (#7726).
compileSdkVersion to 31 (#7726).NSNull should be converted to nil on iOS/macOS (#7810).setUserProperty should now accept null as a valid value on Android (#7735).REFACTOR: fix all unnecessary_import analyzer issues introduced with Flutter 2.8.
unnecessary_import analyzer issues introduced with Flutter 2.8.FIX: ensure setDefaultEventParameters() API throws stating not supported on web. (#7522).
setDefaultEventParameters() API throws stating not supported on web. (#7522).DOCS(auth): clarify behavior of password reset email with email enumeration protection enabled (#18296).
FIX: use jsify() with event parameters for logEvent() so they are sent (#7509).
jsify() with event parameters for logEvent() so they are sent (#7509).databaseURL can sometimes be ignored (fixes #7502) (#7510).path getter for Query (fixes #7495).setPersistenceEnabled to reflect updated return type (fixes #7496) (#7501).Bump platform interface a major version due to pigeon dependency update
Bump platform interface a major version due to pigeon dependency update
REFACTOR: move all packages to workspace (#18182). (6cdfcb10)
FIX: update core, auth and app-check logic so internal resources on method channels are properly disposed (#18268). (a0de4ed8)
FEAT(auth,android): add revokeAccessToken support for Android (#18206) (#18207). (7e0a2227)
Note: This release has breaking changes.
Realtime Database has been fully reworked to bring the plugin inline with the federated plugin setup, a more familiar API, better documentation and many more unit and end-to-end tests.
General
Map with int keys would crash.FirebaseDatabase
FirebaseDatabase() has now been deprecated in favor of FirebaseDatabase.instanceFor().reference() has now been deprecated in favor of ref().ref(), which allows you to provide an optional path to any database node rather than calling child().useDatabaseEmulator().refFromURL().setPersistenceEnabled() is now synchronous.setPersistenceCacheSizeBytes() is now synchronous.setLoggingEnabled() is now synchronous.DatabaseReference
parent is now a getter (inline with the JavaScript API).root is now a getter (inline with the JavaScript API).set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.setWithPriority().applyLocally property on runTransaction.Query
once() now accepts an optional DatabaseEventType (rather than just subscribing to the value).limitToFirst() now asserts the value is positive.limitToLast() now asserts the value is positive.OnDisconnect
set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.setWithPriority().Event
Event class returned from database queries has been renamed to DatabaseEvent.NEW: DatabaseEvent (old Event)
DatabaseEventType is now returned on the event.previousChildKey is now returned on the event (previously called previousSiblingKey).NEW: DatabaseEventType
DatabaseEventType is now returned from a DatabaseEvent.DataSnapshot
.priority getter.hasChild().child()..children getter.
snapshot.value are no longer pre-sorted when using order queries, use .children
if you need to iterate over your value keys in order.TransactionResult
DatabaseError, instead handle errors of a transaction via a Future completion error.NEW: Transaction
Transaction.success(value) return this from inside your TransactionHandler to indicate a successful execution.Transaction.abort() return this from inside your TransactionHandler to indicate that the transaction should be aborted.TransactionHandler
Transaction either via Transaction.success() or Transaction.abort().DatabaseError
DatabaseError class has been removed. Errors are now returned as a FirebaseException inline with the other plugins.FIX: ignore emulator already set error on web (hot restart issue) (#7483).
DEPRECATED: FirebaseDatabase() has now been deprecated in favor of FirebaseDatabase.instanceFor().
Realtime Database has been fully reworked to bring the plugin inline with the federated plugin setup, a more familiar API, better documentation and many more unit and end-to-end tests.
General
Fixed an issue where providing a Map with int keys would crash.
FirebaseDatabase
DEPRECATED: FirebaseDatabase() has now been deprecated in favor of FirebaseDatabase.instanceFor().
DEPRECATED: reference() has now been deprecated in favor of ref().
NEW: Added support for ref(), which allows you to provide an optional path to any database node rather than calling child().
NEW: Add emulator support via useDatabaseEmulator().
NEW: Add support for refFromURL().
BREAKING: setPersistenceEnabled() is now synchronous.
BREAKING: setPersistenceCacheSizeBytes() is now synchronous.
BREAKING: setLoggingEnabled() is now synchronous.
DatabaseReference
BREAKING: parent is now a getter (inline with the JavaScript API).
BREAKING: root is now a getter (inline with the JavaScript API).
BREAKING: set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.
NEW: Added support for setWithPriority().
NEW: Added support for locally applying transaction results via the applyLocally property on runTransaction.
Query
NEW: once() now accepts an optional DatabaseEventType (rather than just subscribing to the value).
BREAKING: limitToFirst() now asserts the value is positive.
BREAKING: limitToLast() now asserts the value is positive.
OnDisconnect
set() now accepts an Object? value (rather than dynamic) and no longer accepts a priority.setWithPriority().Event
BREAKING: The Event class returned from database queries has been renamed to DatabaseEvent.
NEW: DatabaseEvent (old Event)
The DatabaseEventType is now returned on the event.
The previousChildKey is now returned on the event (previously called previousSiblingKey).
NEW: DatabaseEventType
A DatabaseEventType is now returned from a DatabaseEvent.
DataSnapshot
NEW: Added support for accessing the priority via the .priority getter.
NEW: Added support for determining whether the snapshot has a child via hasChild().
NEW: Added support for accessing a snapshot child node via child().
NEW: Added support for iterating the child nodes of the snapshot via the .children getter.
snapshot.value are no longer pre-sorted when using order queries, use .children
if you need to iterate over your value keys in order.TransactionResult
BREAKING: The result of a transaction no longer returns a DatabaseError, instead handle errors of a transaction via a Future completion error.
NEW: Transaction
Transaction.success(value) return this from inside your TransactionHandler to indicate a successful execution.Transaction.abort() return this from inside your TransactionHandler to indicate that the transaction should be aborted.TransactionHandler
Transaction either via Transaction.success() or Transaction.abort().DatabaseError
BREAKING: The DatabaseError class has been removed. Errors are now returned as a FirebaseException inline with the other plugins.
FEAT: automatically inject Firebase JS SDKs (#7359).
FEAT(appcheck): rCE provider api update (#18505).
FirebaseApp instances from Dart (#6549).Update a dependency to the latest release.
REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
List values would error on transaction result (#7001).Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v6.7.0cloud_firestore_platform_interface - v8.0.4cloud_firestore_web - v5.7.0cloud_functions_platform_interface - v6.0.4firebase_ai - v3.14.0firebase_auth - v6.5.5firebase_core - v4.12.0cloud_functions - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Packages 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 - v6.3.4cloud_functions_web - v5.1.10firebase_data_connect - v0.3.0+6_flutterfire_internals - v1.3.74firebase_analytics - v12.4.4firebase_analytics_platform_interface - v6.0.4firebase_analytics_web - v0.6.1+10firebase_app_check - v0.4.5+1firebase_app_check_platform_interface - v0.4.1+1firebase_app_check_web - v0.2.5+1firebase_app_installations - v0.4.2+5firebase_app_installations_platform_interface - v0.1.4+73firebase_app_installations_web - v0.1.7+10firebase_auth_platform_interface - v9.0.4firebase_auth_web - v6.2.4firebase_crashlytics - v5.2.5firebase_crashlytics_platform_interface - v3.8.25firebase_database - v12.4.5firebase_database_platform_interface - v0.4.0+4firebase_database_web - v0.2.7+11firebase_in_app_messaging - v0.9.2+5firebase_in_app_messaging_platform_interface - v0.2.5+25firebase_messaging - v16.4.2firebase_messaging_platform_interface - v4.9.1firebase_messaging_web - v4.2.2firebase_ml_model_downloader - v0.4.2+5firebase_ml_model_downloader_platform_interface - v0.1.5+25firebase_performance - v0.11.4+4firebase_performance_platform_interface - v0.2.0+4firebase_performance_web - v0.1.8+10firebase_remote_config - v6.5.4firebase_remote_config_platform_interface - v3.0.4firebase_remote_config_web - v1.10.11firebase_storage - v13.4.4firebase_storage_platform_interface - v6.0.4firebase_storage_web - v3.11.10Note: This release has breaking changes.
REFACTOR: firebase_database_platform_interface (#6668).
Update a dependency to the latest release.
FEAT: support for Firestore Pipelines (#18183).
CHORE: rm deprecated jcenter repository (#6431).
Update a dependency to the latest release.
FEAT(appcheck): appcheck reCAPTCHA mobile support (gradually rolling out) (#18261).
Bump platform interface a major version due to pigeon dependency update
FIX: podspec osx version checking script should use a version range instead of a single fixed version.
REFACTOR: move packages/firebase_database to packages/firebase_database/firebase_database (#5887).
packages/firebase_database to packages/firebase_database/firebase_database (#5887).FIX: return ordered data (#5765).
> Note: This release has breaking changes.
Note: This release has breaking changes.
FIX(firestore,android): avoid ConcurrentModificationException by collecting Firestore instances before termination (#17956).
DOCS: remove incorrect ARCHS in ios examples (#5450).
FIX(functions,web): fix a crash that could happen with the Int64 type (#18066).
firebase_core.Bump platform interface a major version due to pigeon dependency update
Note: This release has breaking changes.
BREAKING FEAT(firestore): remove deprecated functions (#17559).
FEAT: bump Firebase iOS SDK to 12.8.0 (#17947).
com.android.tools.build & 'com.google.gms:google-services versions (#4269).FEAT: bump Firebase iOS SDK to 12.6.0 (#17857).
compileSdkVersion to 29 in preparation for upcoming Play Store requirement.Packages with breaking changes:
getToken method (#18290). (b37722db)Packages with breaking changes:
Packages with other changes:
firebase_core - v4.9.0firebase_core_platform_interface - v7.0.1firebase_core_web - v3.7.0_flutterfire_internals - v1.3.71cloud_firestore - v6.4.1cloud_firestore_platform_interface - v8.0.1cloud_firestore_web - v5.4.1cloud_functions - v6.3.1cloud_functions_platform_interface - v6.0.1cloud_functions_web - v5.1.7firebase_ai - v3.12.1firebase_analytics - v12.4.1firebase_analytics_platform_interface - v6.0.1firebase_analytics_web - v0.6.1+7firebase_app_check - v0.4.4+1firebase_app_check_platform_interface - v0.4.0+1firebase_app_check_web - v0.2.4+2firebase_app_installations - v0.4.2+2firebase_app_installations_platform_interface - v0.1.4+70firebase_app_installations_web - v0.1.7+7firebase_auth - v6.5.1firebase_auth_platform_interface - v9.0.1firebase_auth_web - v6.2.1firebase_crashlytics - v5.2.2firebase_crashlytics_platform_interface - v3.8.22firebase_data_connect - v0.3.0+2firebase_database - v12.4.1firebase_database_platform_interface - v0.4.0+1firebase_database_web - v0.2.7+8firebase_in_app_messaging - v0.9.2+2firebase_in_app_messaging_platform_interface - v0.2.5+22firebase_messaging - v16.2.2firebase_messaging_platform_interface - v4.7.11firebase_messaging_web - v4.1.7firebase_ml_model_downloader - v0.4.2+2firebase_ml_model_downloader_platform_interface - v0.1.5+22firebase_performance - v0.11.4+1firebase_performance_platform_interface - v0.2.0+1firebase_performance_web - v0.1.8+7firebase_remote_config - v6.5.1firebase_remote_config_platform_interface - v3.0.1firebase_remote_config_web - v1.10.8firebase_storage - v13.4.1firebase_storage_platform_interface - v6.0.1firebase_storage_web - v3.11.7Packages 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.
_flutterfire_internals - v1.3.71cloud_firestore - v6.4.1cloud_firestore_platform_interface - v8.0.1cloud_firestore_web - v5.4.1cloud_functions - v6.3.1cloud_functions_platform_interface - v6.0.1cloud_functions_web - v5.1.7firebase_ai - v3.12.1firebase_analytics - v12.4.1firebase_analytics_platform_interface - v6.0.1firebase_analytics_web - v0.6.1+7firebase_app_check - v0.4.4+1firebase_app_check_platform_interface - v0.4.0+1firebase_app_check_web - v0.2.4+2firebase_app_installations - v0.4.2+2firebase_app_installations_platform_interface - v0.1.4+70firebase_app_installations_web - v0.1.7+7firebase_auth - v6.5.1firebase_auth_platform_interface - v9.0.1firebase_auth_web - v6.2.1firebase_crashlytics - v5.2.2firebase_crashlytics_platform_interface - v3.8.22firebase_data_connect - v0.3.0+2firebase_database - v12.4.1firebase_database_platform_interface - v0.4.0+1firebase_database_web - v0.2.7+8firebase_in_app_messaging - v0.9.2+2firebase_in_app_messaging_platform_interface - v0.2.5+22firebase_messaging - v16.2.2firebase_messaging_platform_interface - v4.7.11firebase_messaging_web - v4.1.7firebase_ml_model_downloader - v0.4.2+2firebase_ml_model_downloader_platform_interface - v0.1.5+22firebase_performance - v0.11.4+1firebase_performance_platform_interface - v0.2.0+1firebase_performance_web - v0.1.8+7firebase_remote_config - v6.5.1firebase_remote_config_platform_interface - v3.0.1firebase_remote_config_web - v1.10.8firebase_storage - v13.4.1firebase_storage_platform_interface - v6.0.1firebase_storage_web - v3.11.7Packages with breaking changes:
Packages with breaking changes:
Packages with other changes:
cloud_firestore - v3.4.0cloud_firestore_platform_interface - v5.7.0cloud_firestore_web - v2.8.0firebase_analytics - v9.2.1firebase_analytics_platform_interface - v3.2.1firebase_analytics_web - v0.4.1+1firebase_auth - v3.5.0firebase_auth_platform_interface - v6.4.0firebase_auth_web - v4.1.0firebase_core - v1.20.0firebase_core_platform_interface - v4.5.0firebase_messaging_platform_interface - v4.1.0firebase_messaging_web - v3.1.0flutterfire_ui - v0.4.3cloud_firestore_odm - v1.0.0-dev.22cloud_firestore_odm_generator - v1.0.0-dev.22firebase_in_app_messaging - v0.6.0+20firebase_in_app_messaging_platform_interface - v0.2.1+12firebase_crashlytics - v2.8.6firebase_crashlytics_platform_interface - v3.2.12firebase_remote_config - v2.0.13firebase_database_web - v0.2.1+1firebase_remote_config_platform_interface - v1.1.12firebase_database_platform_interface - v0.2.1+12firebase_database - v9.0.20firebase_remote_config_web - v1.1.1firebase_app_installations_web - v0.1.1+1firebase_dynamic_links - v4.3.3firebase_dynamic_links_platform_interface - v0.2.3+8firebase_app_installations_platform_interface - v0.1.1+12firebase_app_installations - v0.1.1+3firebase_messaging - v12.0.1firebase_ml_model_downloader - v0.1.1+3firebase_ml_model_downloader_platform_interface - v0.1.1+12firebase_app_check_platform_interface - v0.0.4+12firebase_app_check - v0.0.6+18firebase_app_check_web - v0.0.6+1cloud_functions_web - v4.3.1cloud_functions - v3.3.3firebase_storage_platform_interface - v4.1.12firebase_storage_web - v3.3.1cloud_functions_platform_interface - v5.1.12firebase_performance_platform_interface - v0.1.1+12firebase_performance - v0.8.2+1firebase_storage - v10.3.3firebase_performance_web - v0.1.1+1firebase_core_web - v1.7.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.
cloud_firestore_odm - v1.0.0-dev.22cloud_firestore_odm_generator - v1.0.0-dev.22firebase_in_app_messaging - v0.6.0+20firebase_in_app_messaging_platform_interface - v0.2.1+12firebase_crashlytics - v2.8.6firebase_crashlytics_platform_interface - v3.2.12firebase_remote_config - v2.0.13firebase_database_web - v0.2.1+1firebase_remote_config_platform_interface - v1.1.12firebase_database_platform_interface - v0.2.1+12firebase_database - v9.0.20firebase_remote_config_web - v1.1.1firebase_app_installations_web - v0.1.1+1firebase_dynamic_links - v4.3.3firebase_dynamic_links_platform_interface - v0.2.3+8firebase_app_installations_platform_interface - v0.1.1+12firebase_app_installations - v0.1.1+3firebase_messaging - v12.0.1firebase_ml_model_downloader - v0.1.1+3firebase_ml_model_downloader_platform_interface - v0.1.1+12firebase_app_check_platform_interface - v0.0.4+12firebase_app_check - v0.0.6+18firebase_app_check_web - v0.0.6+1cloud_functions_web - v4.3.1cloud_functions - v3.3.3firebase_storage_platform_interface - v4.1.12firebase_storage_web - v3.3.1cloud_functions_platform_interface - v5.1.12firebase_performance_platform_interface - v0.1.1+12firebase_performance - v0.8.2+1firebase_storage - v10.3.3firebase_performance_web - v0.1.1+1firebase_core_web - v1.7.1REFACTOR(messaging,web): convert classes to extension types for improved interop (#17820).
ServerValue.increment(delta) (#3109).BREAKING REFACTOR(firebaseai): Removed deprecated Imagen methods and types due to Imagen models being shut down (#18577).
firebase_core.firebase_core.Nothing published for this version
Update lower bound of dart dependency to 2.0.0.
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.5DOCS: update firestore dartpad example.
FIX(auth,windows): fix a crash that could happen when using sendEmailVerification or sendPasswordResetEmail (#12946).
author: field from pubspec.yamlFEAT: bump Firebase JS SDK to 12.2.1 (#17678).
Updated README instructions for contributing for consistency with other Flutterfire plugins.
REFACTOR(platform_interface): replace Flutter UI and foundation imports with package:meta (#18604).
FIX(remote_config): restores the Apple error mapping and accepts both throttling status spellings (#18458).
TestWidgetsFlutterBinding.ensureInitialized.REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
FIX: fix aggregated count to use the current query and not only the collection on Web (#9824).
REFACTOR: add verify to QueryPlatform and change internal verifyToken API to verify (#9711).
Add missing template type parameter to invokeMethod calls.
invokeMethod calls.Bump platform interface a major version due to pigeon dependency update
Provide a toString implementation for DatabaseError.
toString implementation for DatabaseError.FIX: currentUser is now populated right at the start of the application without needing to wait for authStateChange (#10028).
getDictionaryFromError always returns non nil result even when the parameter is nil.- Remove categories.
Fixing DatabaseReference.set unhandled exception which happened when a successful operation was performed.
FIX: add missing default_package entry for web in pubspec.yaml (#8139).
default_package entry for web in pubspec.yaml (#8139). (5e6b570f)Your coding agent can read these notes before it upgrades. Set up the MCP server →