# chriscolombos/firebaseui-android architecture

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

- Interactive diagram: https://gitdiagram.com/chriscolombos/firebaseui-android
- Repository: https://github.com/chriscolombos/firebaseui-android

## Overview

FirebaseUI for Android provides UI bindings for Firebase Auth, Realtime Database, Cloud Firestore, and Cloud Storage. A typical auth flow starts when an app configures AuthUI and launches the provider picker; the selected provider handler performs authentication and returns a result. Database and Firestore modules expose adapters and paging components for UI lists, while Storage provides image-loading integration. The README documents these as separate modules; sampled sources clarify parts of auth and database paging, but not every module’s internal wiring.

Main entry points: [`auth/src/main/java/com/firebase/ui/auth/AuthUI.java`](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/AuthUI.java) (AuthUI API), [`auth/src/main/java/com/firebase/ui/auth/ui/idp/AuthMethodPickerActivity.kt`](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/ui/idp/AuthMethodPickerActivity.kt) (Provider picker), [`auth/src/main/java/com/firebase/ui/auth/data/remote/GenericIdpSignInHandler.java`](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/data/remote/GenericIdpSignInHandler.java) (Provider handlers), [`database/src/main/java/com/firebase/ui/database/FirebaseArray.java`](https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/FirebaseArray.java) (Database snapshots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication"]
  node_authapi["AuthUI API<br/>[AuthUI.java]"]
  node_picker["Provider picker"]
  node_provider["Provider handlers"]
  node_authops["Auth operations"]
  node_email["Email-link sign-in"]
  node_authresult["Auth result models<br/>[IdpResponse.java]"]
end

subgraph group_database["Realtime Database"]
  node_dbadapter["Database adapters"]
  node_dbarray["Database snapshots<br/>[FirebaseArray.java]"]
  node_dbpaging["Database paging"]
  node_dboptions["Paging options"]
end

subgraph group_firestore["Cloud Firestore"]
  node_fsadapter["Firestore adapter"]
  node_fsarray["Firestore snapshots"]
  node_fspaging["Firestore paging"]
  node_fsoptions["Paging options"]
end

subgraph group_storage["Cloud Storage"]
  node_imageloader["Image loader"]
end

subgraph group_common["Shared snapshots"]
  node_snapshotbase["Snapshot primitives"]
end

node_app(("Android app"))
node_firebaseauth["Firebase Auth"]
node_realtimedb[("Realtime Database")]
node_firestore[("Cloud Firestore")]
node_cloudstorage[("Cloud Storage")]

node_app -->|"configures flow"| node_authapi
node_authapi -.->|"launches flow"| node_picker
node_picker -->|"dispatches sign-in"| node_provider
node_provider -->|"authenticates with"| node_firebaseauth
node_provider -->|"delegates upgrade"| node_authops
node_picker -->|"selects email flow"| node_email
node_email -->|"uses auth operations"| node_authops
node_authapi -.->|"returns sign-in result"| node_authresult
node_app -->|"binds list UI"| node_dbadapter
node_dbadapter -.->|"observes snapshots"| node_dbarray
node_dbarray -.->|"reads records"| node_realtimedb
node_dboptions -->|"configures source"| node_dbpaging
node_dbpaging -.->|"pages records"| node_realtimedb
node_app -->|"binds list UI"| node_fsadapter
node_fsadapter -.->|"observes snapshots"| node_fsarray
node_fsarray -.->|"reads documents"| node_firestore
node_app -->|"configures paging"| node_fsoptions
node_fsoptions -.->|"configures source"| node_fspaging
node_fspaging -.->|"pages documents"| node_firestore
node_app -->|"loads images"| node_imageloader
node_imageloader -.->|"fetches images"| node_cloudstorage
node_dbarray -.->|"uses primitives"| node_snapshotbase
node_fsarray -.->|"uses primitives"| node_snapshotbase

click node_authapi "https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/AuthUI.java"
click node_picker "https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/ui/idp/AuthMethodPickerActivity.kt"
click node_provider "https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/data/remote/GenericIdpSignInHandler.java"
click node_authops "https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/util/data/AuthOperationManager.java"
click node_email "https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/viewmodel/email/EmailLinkSignInHandler.java"
click node_authresult "https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/IdpResponse.java"
click node_dbadapter "https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/FirebaseRecyclerAdapter.java"
click node_dbarray "https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/FirebaseArray.java"
click node_dbpaging "https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/paging/DatabasePagingSource.java"
click node_dboptions "https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/paging/DatabasePagingOptions.java"
click node_fsadapter "https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/FirestoreRecyclerAdapter.java"
click node_fsarray "https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/FirestoreArray.java"
click node_fspaging "https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/paging/FirestorePagingSource.java"
click node_fsoptions "https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/paging/FirestorePagingOptions.java"
click node_imageloader "https://github.com/chriscolombos/firebaseui-android/blob/master/storage/src/main/java/com/firebase/ui/storage/images/FirebaseImageLoader.java"
click node_snapshotbase "https://github.com/chriscolombos/firebaseui-android/blob/master/common/src/main/java/com/firebase/ui/common/BaseObservableSnapshotArray.java"

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_authapi,node_picker,node_provider,node_authops,node_email,node_authresult toneBlue
class node_dbadapter,node_dbarray,node_dbpaging,node_dboptions,node_realtimedb,node_firestore,node_cloudstorage toneAmber
class node_fsadapter,node_fsarray,node_fspaging,node_fsoptions toneMint
class node_imageloader toneRose
class node_snapshotbase,node_app,node_firebaseauth toneIndigo
```

## Components

### Authentication

- [AuthUI API](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/AuthUI.java): `auth/src/main/java/com/firebase/ui/auth/AuthUI.java`
- [Provider picker](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/ui/idp/AuthMethodPickerActivity.kt): `auth/src/main/java/com/firebase/ui/auth/ui/idp/AuthMethodPickerActivity.kt`
- [Provider handlers](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/data/remote/GenericIdpSignInHandler.java): `auth/src/main/java/com/firebase/ui/auth/data/remote/GenericIdpSignInHandler.java`
- [Auth operations](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/util/data/AuthOperationManager.java): `auth/src/main/java/com/firebase/ui/auth/util/data/AuthOperationManager.java`
- [Email-link sign-in](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/viewmodel/email/EmailLinkSignInHandler.java): `auth/src/main/java/com/firebase/ui/auth/viewmodel/email/EmailLinkSignInHandler.java`
- [Auth result models](https://github.com/chriscolombos/firebaseui-android/blob/master/auth/src/main/java/com/firebase/ui/auth/IdpResponse.java): `auth/src/main/java/com/firebase/ui/auth/IdpResponse.java`

### Realtime Database

- [Database adapters](https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/FirebaseRecyclerAdapter.java): `database/src/main/java/com/firebase/ui/database/FirebaseRecyclerAdapter.java`
- [Database snapshots](https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/FirebaseArray.java): `database/src/main/java/com/firebase/ui/database/FirebaseArray.java`
- [Database paging](https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/paging/DatabasePagingSource.java): `database/src/main/java/com/firebase/ui/database/paging/DatabasePagingSource.java`
- [Paging options](https://github.com/chriscolombos/firebaseui-android/blob/master/database/src/main/java/com/firebase/ui/database/paging/DatabasePagingOptions.java): `database/src/main/java/com/firebase/ui/database/paging/DatabasePagingOptions.java`

### Cloud Firestore

- [Firestore adapter](https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/FirestoreRecyclerAdapter.java): `firestore/src/main/java/com/firebase/ui/firestore/FirestoreRecyclerAdapter.java`
- [Firestore snapshots](https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/FirestoreArray.java): `firestore/src/main/java/com/firebase/ui/firestore/FirestoreArray.java`
- [Firestore paging](https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/paging/FirestorePagingSource.java): `firestore/src/main/java/com/firebase/ui/firestore/paging/FirestorePagingSource.java`
- [Paging options](https://github.com/chriscolombos/firebaseui-android/blob/master/firestore/src/main/java/com/firebase/ui/firestore/paging/FirestorePagingOptions.java): `firestore/src/main/java/com/firebase/ui/firestore/paging/FirestorePagingOptions.java`

### Cloud Storage

- [Image loader](https://github.com/chriscolombos/firebaseui-android/blob/master/storage/src/main/java/com/firebase/ui/storage/images/FirebaseImageLoader.java): `storage/src/main/java/com/firebase/ui/storage/images/FirebaseImageLoader.java`

### Shared snapshots

- [Snapshot primitives](https://github.com/chriscolombos/firebaseui-android/blob/master/common/src/main/java/com/firebase/ui/common/BaseObservableSnapshotArray.java): `common/src/main/java/com/firebase/ui/common/BaseObservableSnapshotArray.java`

### Other components

- **Android app**
- **Firebase Auth**
- **Realtime Database**
- **Cloud Firestore**
- **Cloud Storage**

## Connections

- Android app → AuthUI API: configures flow (evidence: `README.md`)
- AuthUI API → Provider picker: launches flow (evidence: `auth/src/main/java/com/firebase/ui/auth/AuthUI.java`)
- Provider picker → Provider handlers: dispatches sign-in (evidence: `auth/src/main/java/com/firebase/ui/auth/ui/idp/AuthMethodPickerActivity.kt`)
- Provider handlers → Firebase Auth: authenticates with (evidence: `auth/src/main/java/com/firebase/ui/auth/data/remote/GenericIdpSignInHandler.java`)
- Provider handlers → Auth operations: delegates upgrade (evidence: `auth/src/main/java/com/firebase/ui/auth/data/remote/GenericIdpSignInHandler.java`)
- Provider picker → Email-link sign-in: selects email flow (evidence: `auth/src/main/java/com/firebase/ui/auth/ui/idp/AuthMethodPickerActivity.kt`)
- Email-link sign-in → Auth operations: uses auth operations (evidence: `auth/src/main/java/com/firebase/ui/auth/viewmodel/email/EmailLinkSignInHandler.java`)
- AuthUI API → Auth result models: returns sign-in result (evidence: `auth/src/main/java/com/firebase/ui/auth/IdpResponse.java`)
- Android app → Database adapters: binds list UI (evidence: `README.md`)
- Database adapters → Database snapshots: observes snapshots
- Database snapshots → Realtime Database: reads records
- Paging options → Database paging: configures source (evidence: `database/src/main/java/com/firebase/ui/database/paging/DatabasePagingOptions.java`)
- Database paging → Realtime Database: pages records
- Android app → Firestore adapter: binds list UI (evidence: `README.md`)
- Firestore adapter → Firestore snapshots: observes snapshots
- Firestore snapshots → Cloud Firestore: reads documents
- Android app → Paging options: configures paging (evidence: `README.md`)
- Paging options → Firestore paging: configures source
- Firestore paging → Cloud Firestore: pages documents
- Android app → Image loader: loads images (evidence: `README.md`)
- Image loader → Cloud Storage: fetches images
- Database snapshots → Snapshot primitives: uses primitives
- Firestore snapshots → Snapshot primitives: uses primitives
