# firebase/flutterfire architecture

> Architecture diagram of the GitHub repository firebase/flutterfire, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/firebase/flutterfire
- Repository: https://github.com/firebase/flutterfire

## Overview

FlutterFire is a monorepo of Flutter plugins that expose Firebase products to Flutter applications. The principal workflow is an app invoking a service plugin, which bridges calls and results to the corresponding Firebase service; native platform implementations and generated message codecs form the internal adapter layer. Firestore additionally supports document/query operations, live snapshot streams, transactions, and pipeline queries. The graph preserves the README’s named product capabilities where source paths appear in the supplied tree; detailed internal call links are limited to relationships visible in excerpts or the README.

Main entry points: [`packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java`](https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java) (Cloud Firestore), [`packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/streamhandler/QuerySnapshotsStreamHandler.java`](https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/streamhandler/QuerySnapshotsStreamHandler.java) (Snapshot streams), [`packages/firebase_database/firebase_database/windows/firebase_database_plugin.cpp`](https://github.com/firebase/flutterfire/blob/main/packages/firebase_database/firebase_database/windows/firebase_database_plugin.cpp) (Realtime Database), [`packages/firebase_storage/firebase_storage/android/src/main/kotlin/io/flutter/plugins/firebase/storage/FlutterFirebaseStoragePlugin.kt`](https://github.com/firebase/flutterfire/blob/main/packages/firebase_storage/firebase_storage/android/src/main/kotlin/io/flutter/plugins/firebase/storage/FlutterFirebaseStoragePlugin.kt) (Cloud Storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Shared foundations"]
  node_core_plugin["Firebase Core"]
end

subgraph group_data["Data services"]
  node_firestore_plugin["Cloud Firestore"]
  node_firestore_queries["Queries and writes"]
  node_firestore_streams["Snapshot streams"]
  node_firestore_transactions["Transactions"]
  node_firestore_pipeline["Pipeline queries"]
  node_realtime_db["Realtime Database"]
  node_storage["Cloud Storage"]
end

subgraph group_identity["Identity and protection"]
  node_auth["Authentication"]
  node_app_check["App Check"]
  node_installations["App Installations"]
end

subgraph group_engagement["Engagement and insights"]
  node_analytics["Analytics"]
  node_messaging["Cloud Messaging"]
  node_crashlytics["Crashlytics"]
  node_in_app_messaging["In-App Messaging"]
  node_performance["Performance Monitoring"]
end

subgraph group_compute["Compute and extensions"]
  node_functions["Cloud Functions"]
  node_firebase_ai["Firebase AI"]
  node_data_connect["Data Connect"]
  node_remote_config["Remote Config<br/>[Package.swift]"]
  node_model_downloader["ML Model Downloader<br/>[Package.swift]"]
end

node_flutter_app(("Flutter app"))
node_firebase["Firebase services"]

node_flutter_app -->|"uses plugins"| node_core_plugin
node_flutter_app -->|"uses plugins"| node_firestore_plugin
node_flutter_app -->|"uses plugins"| node_realtime_db
node_flutter_app -->|"uses plugins"| node_storage
node_flutter_app -->|"uses plugins"| node_auth
node_flutter_app -->|"uses plugins"| node_app_check
node_flutter_app -->|"uses plugins"| node_installations
node_flutter_app -->|"uses plugins"| node_analytics
node_flutter_app -->|"uses plugins"| node_messaging
node_flutter_app -->|"uses plugins"| node_functions
node_flutter_app -->|"uses plugins"| node_firebase_ai
node_flutter_app -->|"uses plugins"| node_data_connect
node_flutter_app -->|"uses plugins"| node_crashlytics
node_flutter_app -->|"uses plugins"| node_in_app_messaging
node_flutter_app -->|"uses plugins"| node_performance
node_flutter_app -->|"uses plugins"| node_remote_config
node_flutter_app -->|"uses plugins"| node_model_downloader
node_firestore_plugin -->|"bridges to"| node_firebase
node_realtime_db -->|"bridges to"| node_firebase
node_storage -->|"bridges to"| node_firebase
node_auth -->|"bridges to"| node_firebase
node_app_check -->|"bridges to"| node_firebase
node_installations -->|"bridges to"| node_firebase
node_analytics -->|"bridges to"| node_firebase
node_messaging -->|"bridges to"| node_firebase
node_functions -->|"bridges to"| node_firebase
node_firebase_ai -->|"bridges to"| node_firebase
node_data_connect -->|"bridges to"| node_firebase
node_crashlytics -->|"bridges to"| node_firebase
node_in_app_messaging -->|"bridges to"| node_firebase
node_performance -->|"bridges to"| node_firebase
node_remote_config -->|"bridges to"| node_firebase
node_model_downloader -->|"bridges to"| node_firebase
node_firestore_plugin -->|"handles"| node_firestore_queries
node_firestore_plugin -->|"registers streams"| node_firestore_streams
node_firestore_plugin -->|"handles"| node_firestore_transactions
node_firestore_plugin -.->|"parses pipelines"| node_firestore_pipeline
node_firestore_streams -->|"listens to query"| node_firestore_queries

click node_core_plugin "https://github.com/firebase/flutterfire/tree/main/packages/firebase_core"
click node_firestore_plugin "https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java"
click node_firestore_queries "https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java"
click node_firestore_streams "https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/streamhandler/QuerySnapshotsStreamHandler.java"
click node_firestore_pipeline "https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/utils/PipelineParser.java"
click node_realtime_db "https://github.com/firebase/flutterfire/blob/main/packages/firebase_database/firebase_database/windows/firebase_database_plugin.cpp"
click node_storage "https://github.com/firebase/flutterfire/blob/main/packages/firebase_storage/firebase_storage/android/src/main/kotlin/io/flutter/plugins/firebase/storage/FlutterFirebaseStoragePlugin.kt"
click node_auth "https://github.com/firebase/flutterfire/blob/main/packages/firebase_auth/firebase_auth/android/src/main/kotlin/io/flutter/plugins/firebase/auth/FlutterFirebaseAuthPlugin.kt"
click node_app_check "https://github.com/firebase/flutterfire/blob/main/packages/firebase_app_check/firebase_app_check/android/src/main/kotlin/io/flutter/plugins/firebase/appcheck/FirebaseAppCheckPlugin.kt"
click node_installations "https://github.com/firebase/flutterfire/blob/main/packages/firebase_app_installations/firebase_app_installations/android/src/main/kotlin/io/flutter/plugins/firebase/installations/firebase_app_installations/FirebaseInstallationsPlugin.kt"
click node_analytics "https://github.com/firebase/flutterfire/blob/main/packages/firebase_analytics/firebase_analytics/android/src/main/kotlin/io/flutter/plugins/firebase/analytics/FlutterFirebaseAnalyticsPlugin.kt"
click node_messaging "https://github.com/firebase/flutterfire/blob/main/packages/firebase_messaging/firebase_messaging/android/src/main/java/io/flutter/plugins/firebase/messaging/FlutterFirebaseMessagingService.java"
click node_functions "https://github.com/firebase/flutterfire/blob/main/packages/cloud_functions/cloud_functions/android/src/main/kotlin/io/flutter/plugins/firebase/functions/FlutterFirebaseFunctionsPlugin.kt"
click node_firebase_ai "https://github.com/firebase/flutterfire/blob/main/packages/firebase_ai/firebase_ai/android/src/main/kotlin/io/flutter/plugins/firebase/ai/FirebaseAIPlugin.kt"
click node_data_connect "https://github.com/firebase/flutterfire/blob/main/packages/firebase_data_connect/firebase_data_connect/protos/connector_service.proto"
click node_crashlytics "https://github.com/firebase/flutterfire/blob/main/packages/firebase_crashlytics/firebase_crashlytics/ios/firebase_crashlytics/Sources/firebase_crashlytics/FirebaseCrashlyticsMessages.g.swift"
click node_in_app_messaging "https://github.com/firebase/flutterfire/blob/main/packages/firebase_in_app_messaging/firebase_in_app_messaging/ios/firebase_in_app_messaging/Sources/firebase_in_app_messaging/FirebaseInAppMessagingMessages.g.swift"
click node_performance "https://github.com/firebase/flutterfire/blob/main/packages/firebase_performance/firebase_performance/ios/firebase_performance/Sources/firebase_performance/FirebasePerformanceMessages.g.swift"
click node_remote_config "https://github.com/firebase/flutterfire/blob/main/packages/firebase_remote_config/firebase_remote_config/macos/firebase_remote_config/Package.swift"
click node_model_downloader "https://github.com/firebase/flutterfire/blob/main/packages/firebase_ml_model_downloader/firebase_ml_model_downloader/ios/firebase_ml_model_downloader/Package.swift"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_core_plugin toneBlue
class node_firestore_plugin,node_firestore_queries,node_firestore_streams,node_firestore_transactions,node_firestore_pipeline,node_realtime_db,node_storage toneAmber
class node_auth,node_app_check,node_installations toneMint
class node_analytics,node_messaging,node_crashlytics,node_in_app_messaging,node_performance toneRose
class node_functions,node_firebase_ai,node_data_connect,node_remote_config,node_model_downloader,node_flutter_app,node_firebase toneIndigo
```

## Components

### Shared foundations

- [Firebase Core](https://github.com/firebase/flutterfire/tree/main/packages/firebase_core): `packages/firebase_core`

### Data services

- [Cloud Firestore](https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java): `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java`
- [Queries and writes](https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java): `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java`
- [Snapshot streams](https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/streamhandler/QuerySnapshotsStreamHandler.java): `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/streamhandler/QuerySnapshotsStreamHandler.java`
- **Transactions**
- [Pipeline queries](https://github.com/firebase/flutterfire/blob/main/packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/utils/PipelineParser.java): `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/utils/PipelineParser.java`
- [Realtime Database](https://github.com/firebase/flutterfire/blob/main/packages/firebase_database/firebase_database/windows/firebase_database_plugin.cpp): `packages/firebase_database/firebase_database/windows/firebase_database_plugin.cpp`
- [Cloud Storage](https://github.com/firebase/flutterfire/blob/main/packages/firebase_storage/firebase_storage/android/src/main/kotlin/io/flutter/plugins/firebase/storage/FlutterFirebaseStoragePlugin.kt): `packages/firebase_storage/firebase_storage/android/src/main/kotlin/io/flutter/plugins/firebase/storage/FlutterFirebaseStoragePlugin.kt`

### Identity and protection

- [Authentication](https://github.com/firebase/flutterfire/blob/main/packages/firebase_auth/firebase_auth/android/src/main/kotlin/io/flutter/plugins/firebase/auth/FlutterFirebaseAuthPlugin.kt): `packages/firebase_auth/firebase_auth/android/src/main/kotlin/io/flutter/plugins/firebase/auth/FlutterFirebaseAuthPlugin.kt`
- [App Check](https://github.com/firebase/flutterfire/blob/main/packages/firebase_app_check/firebase_app_check/android/src/main/kotlin/io/flutter/plugins/firebase/appcheck/FirebaseAppCheckPlugin.kt): `packages/firebase_app_check/firebase_app_check/android/src/main/kotlin/io/flutter/plugins/firebase/appcheck/FirebaseAppCheckPlugin.kt`
- [App Installations](https://github.com/firebase/flutterfire/blob/main/packages/firebase_app_installations/firebase_app_installations/android/src/main/kotlin/io/flutter/plugins/firebase/installations/firebase_app_installations/FirebaseInstallationsPlugin.kt): `packages/firebase_app_installations/firebase_app_installations/android/src/main/kotlin/io/flutter/plugins/firebase/installations/firebase_app_installations/FirebaseInstallationsPlugin.kt`

### Engagement and insights

- [Analytics](https://github.com/firebase/flutterfire/blob/main/packages/firebase_analytics/firebase_analytics/android/src/main/kotlin/io/flutter/plugins/firebase/analytics/FlutterFirebaseAnalyticsPlugin.kt): `packages/firebase_analytics/firebase_analytics/android/src/main/kotlin/io/flutter/plugins/firebase/analytics/FlutterFirebaseAnalyticsPlugin.kt`
- [Cloud Messaging](https://github.com/firebase/flutterfire/blob/main/packages/firebase_messaging/firebase_messaging/android/src/main/java/io/flutter/plugins/firebase/messaging/FlutterFirebaseMessagingService.java): `packages/firebase_messaging/firebase_messaging/android/src/main/java/io/flutter/plugins/firebase/messaging/FlutterFirebaseMessagingService.java`
- [Crashlytics](https://github.com/firebase/flutterfire/blob/main/packages/firebase_crashlytics/firebase_crashlytics/ios/firebase_crashlytics/Sources/firebase_crashlytics/FirebaseCrashlyticsMessages.g.swift): `packages/firebase_crashlytics/firebase_crashlytics/ios/firebase_crashlytics/Sources/firebase_crashlytics/FirebaseCrashlyticsMessages.g.swift`
- [In-App Messaging](https://github.com/firebase/flutterfire/blob/main/packages/firebase_in_app_messaging/firebase_in_app_messaging/ios/firebase_in_app_messaging/Sources/firebase_in_app_messaging/FirebaseInAppMessagingMessages.g.swift): `packages/firebase_in_app_messaging/firebase_in_app_messaging/ios/firebase_in_app_messaging/Sources/firebase_in_app_messaging/FirebaseInAppMessagingMessages.g.swift`
- [Performance Monitoring](https://github.com/firebase/flutterfire/blob/main/packages/firebase_performance/firebase_performance/ios/firebase_performance/Sources/firebase_performance/FirebasePerformanceMessages.g.swift): `packages/firebase_performance/firebase_performance/ios/firebase_performance/Sources/firebase_performance/FirebasePerformanceMessages.g.swift`

### Compute and extensions

- [Cloud Functions](https://github.com/firebase/flutterfire/blob/main/packages/cloud_functions/cloud_functions/android/src/main/kotlin/io/flutter/plugins/firebase/functions/FlutterFirebaseFunctionsPlugin.kt): `packages/cloud_functions/cloud_functions/android/src/main/kotlin/io/flutter/plugins/firebase/functions/FlutterFirebaseFunctionsPlugin.kt`
- [Firebase AI](https://github.com/firebase/flutterfire/blob/main/packages/firebase_ai/firebase_ai/android/src/main/kotlin/io/flutter/plugins/firebase/ai/FirebaseAIPlugin.kt): `packages/firebase_ai/firebase_ai/android/src/main/kotlin/io/flutter/plugins/firebase/ai/FirebaseAIPlugin.kt`
- [Data Connect](https://github.com/firebase/flutterfire/blob/main/packages/firebase_data_connect/firebase_data_connect/protos/connector_service.proto): `packages/firebase_data_connect/firebase_data_connect/protos/connector_service.proto`
- [Remote Config](https://github.com/firebase/flutterfire/blob/main/packages/firebase_remote_config/firebase_remote_config/macos/firebase_remote_config/Package.swift): `packages/firebase_remote_config/firebase_remote_config/macos/firebase_remote_config/Package.swift`
- [ML Model Downloader](https://github.com/firebase/flutterfire/blob/main/packages/firebase_ml_model_downloader/firebase_ml_model_downloader/ios/firebase_ml_model_downloader/Package.swift): `packages/firebase_ml_model_downloader/firebase_ml_model_downloader/ios/firebase_ml_model_downloader/Package.swift`

### Other components

- **Flutter app**
- **Firebase services**

## Connections

- Flutter app → Firebase Core: uses plugins (evidence: `README.md`)
- Flutter app → Cloud Firestore: uses plugins (evidence: `README.md`)
- Flutter app → Realtime Database: uses plugins (evidence: `README.md`)
- Flutter app → Cloud Storage: uses plugins (evidence: `README.md`)
- Flutter app → Authentication: uses plugins (evidence: `README.md`)
- Flutter app → App Check: uses plugins (evidence: `README.md`)
- Flutter app → App Installations: uses plugins (evidence: `README.md`)
- Flutter app → Analytics: uses plugins (evidence: `README.md`)
- Flutter app → Cloud Messaging: uses plugins (evidence: `README.md`)
- Flutter app → Cloud Functions: uses plugins (evidence: `README.md`)
- Flutter app → Firebase AI: uses plugins (evidence: `README.md`)
- Flutter app → Data Connect: uses plugins (evidence: `README.md`)
- Flutter app → Crashlytics: uses plugins (evidence: `README.md`)
- Flutter app → In-App Messaging: uses plugins (evidence: `README.md`)
- Flutter app → Performance Monitoring: uses plugins (evidence: `README.md`)
- Flutter app → Remote Config: uses plugins (evidence: `README.md`)
- Flutter app → ML Model Downloader: uses plugins (evidence: `README.md`)
- Cloud Firestore → Firebase services: bridges to (evidence: `README.md`)
- Realtime Database → Firebase services: bridges to (evidence: `README.md`)
- Cloud Storage → Firebase services: bridges to (evidence: `README.md`)
- Authentication → Firebase services: bridges to (evidence: `README.md`)
- App Check → Firebase services: bridges to (evidence: `README.md`)
- App Installations → Firebase services: bridges to (evidence: `README.md`)
- Analytics → Firebase services: bridges to (evidence: `README.md`)
- Cloud Messaging → Firebase services: bridges to (evidence: `README.md`)
- Cloud Functions → Firebase services: bridges to (evidence: `README.md`)
- Firebase AI → Firebase services: bridges to (evidence: `README.md`)
- Data Connect → Firebase services: bridges to (evidence: `README.md`)
- Crashlytics → Firebase services: bridges to (evidence: `README.md`)
- In-App Messaging → Firebase services: bridges to (evidence: `README.md`)
- Performance Monitoring → Firebase services: bridges to (evidence: `README.md`)
- Remote Config → Firebase services: bridges to (evidence: `README.md`)
- ML Model Downloader → Firebase services: bridges to (evidence: `README.md`)
- Cloud Firestore → Queries and writes: handles (evidence: `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java`)
- Cloud Firestore → Snapshot streams: registers streams (evidence: `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java`)
- Cloud Firestore → Transactions: handles (evidence: `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java`)
- Cloud Firestore → Pipeline queries: parses pipelines (evidence: `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/FlutterFirebaseFirestorePlugin.java`)
- Snapshot streams → Queries and writes: listens to query (evidence: `packages/cloud_firestore/cloud_firestore/android/src/main/java/io/flutter/plugins/firebase/firestore/streamhandler/QuerySnapshotsStreamHandler.java`)
