{"id":13368604,"url":"https://github.com/firebase/FirebaseUI-Android","last_synced_at":"2025-03-12T20:31:07.828Z","repository":{"id":34843735,"uuid":"38835213","full_name":"firebase/FirebaseUI-Android","owner":"firebase","description":"Optimized UI components for Firebase","archived":false,"fork":false,"pushed_at":"2025-03-11T11:09:20.000Z","size":28510,"stargazers_count":4665,"open_issues_count":126,"forks_count":1842,"subscribers_count":301,"default_branch":"master","last_synced_at":"2025-03-11T12:23:21.988Z","etag":null,"topics":["android","firebase","ui"],"latest_commit_sha":null,"homepage":"https://firebaseopensource.com/projects/firebase/firebaseui-android/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firebase.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-07-09T17:31:09.000Z","updated_at":"2025-03-05T15:13:13.000Z","dependencies_parsed_at":"2023-01-15T09:45:15.155Z","dependency_job_id":"fa829722-490f-4467-a8b3-5e2c0ba4172c","html_url":"https://github.com/firebase/FirebaseUI-Android","commit_stats":{"total_commits":1261,"total_committers":109,"mean_commits":"11.568807339449542","dds":0.662172878667724,"last_synced_commit":"5b6c9f01f5a674d754d8e9b1242197fe040086e7"},"previous_names":[],"tags_count":65,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firebase%2FFirebaseUI-Android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firebase%2FFirebaseUI-Android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firebase%2FFirebaseUI-Android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firebase%2FFirebaseUI-Android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firebase","download_url":"https://codeload.github.com/firebase/FirebaseUI-Android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243290816,"owners_count":20267788,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","firebase","ui"],"created_at":"2024-07-30T01:01:02.760Z","updated_at":"2025-03-12T20:31:07.793Z","avatar_url":"https://github.com/firebase.png","language":"Java","readme":"# FirebaseUI for Android — UI Bindings for Firebase\n\n[![FirebaseOpensource.com](https://img.shields.io/badge/Docs-firebaseopensource.com-orange.svg)](\nhttps://firebaseopensource.com/projects/firebase/firebaseui-android\n)\n[![Actions Status][gh-actions-badge]][gh-actions]\n\nFirebaseUI is an open-source library for Android that allows you to\nquickly connect common UI elements to [Firebase](https://firebase.google.com) APIs.\n\nA compatible FirebaseUI client is also available for [iOS](https://github.com/firebase/firebaseui-ios).\n\n## Table of contents\n\n1. [Usage](#usage)\n1. [Installation](#installation)\n   1. [Upgrading](#upgrading)\n1. [Dependencies](#dependencies)\n   1. [Compatibility](#compatibility-with-firebase--google-play-services-libraries)\n   1. [Upgrading dependencies](#upgrading-dependencies)\n1. [Sample App](#sample-app)\n1. [Snapshot Builds](#snapshot-builds)\n1. [Contributing](#contributing)\n   1. [Installing](#installing-locally)\n   1. [License agreements](#contributor-license-agreements)\n   1. [Process](#contribution-process)\n\n## Usage\n\nFirebaseUI has separate modules for using Firebase Realtime Database, Cloud Firestore,\nFirebase Auth, and Cloud Storage. To get started, see the individual instructions for each module:\n\n* [FirebaseUI Auth](auth/README.md)\n* [FirebaseUI Firestore](firestore/README.md)\n* [FirebaseUI Database](database/README.md)\n* [FirebaseUI Storage](storage/README.md)\n\n## Installation\n\nFirebaseUI is published as a collection of libraries separated by the\nFirebase API they target. Each FirebaseUI library has a transitive\ndependency on the appropriate Firebase SDK so there is no need to include\nthose separately in your app.\n\nIn your `app/build.gradle` file add a dependency on one of the FirebaseUI\nlibraries.\n\n```groovy\ndependencies {\n    // FirebaseUI for Firebase Realtime Database\n    implementation 'com.firebaseui:firebase-ui-database:8.0.2'\n\n    // FirebaseUI for Cloud Firestore\n    implementation 'com.firebaseui:firebase-ui-firestore:8.0.2'\n\n    // FirebaseUI for Firebase Auth\n    implementation 'com.firebaseui:firebase-ui-auth:8.0.2'\n\n    // FirebaseUI for Cloud Storage\n    implementation 'com.firebaseui:firebase-ui-storage:8.0.2'\n}\n```\n\nIf you're including the `firebase-ui-auth` dependency, there's a little\n[more setup](auth/README.md#configuration) required.\n\nAfter the project is synchronized, we're ready to start using Firebase functionality in our app.\n\n### Upgrading\n\nIf you are using an old version of FirebaseUI and upgrading, please see the appropriate\nmigration guide:\n\n* [Upgrade from 7.2.0 to 8.x.x](./docs/upgrade-to-8.0.md)\n* [Upgrade from 6.4.0 to 7.x.x](./docs/upgrade-to-7.0.md)\n* [Upgrade from 5.1.0 to 6.x.x](./docs/upgrade-to-6.0.md)\n* [Upgrade from 4.3.2 to 5.x.x](./docs/upgrade-to-5.0.md)\n* [Upgrade from 3.3.1 to 4.x.x](./docs/upgrade-to-4.0.md)\n* [Upgrade from 2.3.0 to 3.x.x](./docs/upgrade-to-3.0.md)\n* [Upgrade from 1.2.0 to 2.x.x](./docs/upgrade-to-2.0.md)\n\n## Dependencies\n\n### Compatibility with Firebase / Google Play Services libraries\n\nFirebaseUI libraries have the following transitive dependencies on the Firebase SDK:\n```\nfirebase-ui-auth\n|--- com.google.firebase:firebase-auth\n|--- com.google.android.gms:play-services-auth\n\nfirebase-ui-database\n|--- com.google.firebase:firebase-database\n\nfirebase-ui-firestore\n|--- com.google.firebase:firebase-firestore\n\nfirebase-ui-storage\n|--- com.google.firebase:firebase-storage\n```\n\nYou can see the specific dependencies associated with each release on the \n[Releases page](https://github.com/firebase/FirebaseUI-Android/releases).\n\n### Upgrading dependencies\n\nIf you would like to use a newer version of one of FirebaseUI's transitive dependencies, such\nas Firebase, Play services, or the Android support libraries, you need to add explicit\n`implementation` declarations in your `build.gradle` for all of FirebaseUI's dependencies at the version\nyou want to use. Here are some examples listing all of the critical dependencies:\n\n#### Auth\n\n```groovy\nimplementation \"com.google.firebase:firebase-auth:$X.Y.Z\"\nimplementation \"com.google.android.gms:play-services-auth:$X.Y.Z\"\n\nimplementation \"androidx.lifecycle:lifecycle-extensions:$X.Y.Z\"\nimplementation \"androidx.browser:browser:$X.Y.Z\"\nimplementation \"androidx.cardview:cardview:$X.Y.Z\"\nimplementation \"androidx.constraintlayout:constraintlayout:$X.Y.Z\"\nimplementation \"androidx.legacy:legacy-support-v4:$X.Y.Z\"\nimplementation \"com.google.android.material:material:$X.Y.Z\"\n```\n\n#### Firestore\n\n```groovy\nimplementation \"com.google.firebase:firebase-firestore:$X.Y.Z\"\n\nimplementation \"androidx.legacy:legacy-support-v4:$X.Y.Z\"\nimplementation \"androidx.recyclerview:recyclerview:$X.Y.Z\"\n```\n\n#### Realtime Database\n\n```groovy\nimplementation \"com.google.firebase:firebase-database:$X.Y.Z\"\n\nimplementation \"androidx.legacy:legacy-support-v4:$X.Y.Z\"\nimplementation \"androidx.recyclerview:recyclerview:$X.Y.Z\"\n```\n\n#### Storage\n\n```groovy\nimplementation \"com.google.firebase:firebase-storage:$X.Y.Z\"\n\nimplementation \"androidx.legacy:legacy-support-v4:$X.Y.Z\"\n```\n\n\n## Sample app\n\nThere is a sample app in the [`app/`](app) directory that demonstrates most\nof the features of FirebaseUI. Load the project in Android Studio and\nrun it on your Android device to see a demonstration.\n\nBefore you can run the sample app, you must create a project in\nthe Firebase console. Add an Android app to the project, and copy\nthe generated google-services.json file into the `app/` directory.\nAlso enable [anonymous authentication](https://firebase.google.com/docs/auth/android/anonymous-auth)\nfor the Firebase project, since some components of the sample app\nrequires it.\n\nIf you encounter a version incompatibility error between Android Studio\nand Gradle while trying to run the sample app, try disabling the Instant\nRun feature of Android Studio. Alternatively, update Android Studio and\nGradle to their latest versions.\n\nA note on importing the project using Android Studio: Using 'Project from \nVersion Control' will not automatically link the project with Gradle \n(issue [#1349](https://github.com/firebase/FirebaseUI-Android/issues/1349)). \nWhen doing so and opening any `build.gradle.kts` file, an error shows up: \n`Project 'FirebaseUI-Android' isn't linked with Gradle`. To resolve this \nissue, please `git checkout` the project manually and import with `Import \nfrom external model`.\n\n## Snapshot builds\n\nLike to live on the cutting edge?  Want to try the next release of FirebaseUI before anyone else?\nFirebaseUI hosts \"snapshot\" builds on oss.jfrog.org.\n\nJust add the following to your `build.gradle`:\n\n```groovy\nrepositories {\n  maven { url \"https://oss.jfrog.org/artifactory/oss-snapshot-local\" }\n}\n```\n\nThen you can depend on snapshot versions:\n\n```groovy\nimplementation 'com.firebaseui:firebase-ui-auth:$X.Y.Z-SNAPSHOT'\n```\n\nYou can see which `SNAPSHOT` builds are avaiable here:\nhttps://oss.jfrog.org/webapp/#/artifacts/browse/tree/General/oss-snapshot-local/com/firebaseui\n\nSnapshot builds come with absolutely no guarantees and we will close any issues asking to troubleshoot\na snapshot report unless they identify a bug that should block the release launch. Experiment\nat your own risk!\n\n## Contributing\n\n### Installing locally\n\nYou can download FirebaseUI and install it locally by cloning this\nrepository and running:\n\n```sh\n./gradlew :library:prepareArtifacts publishToMavenLocal\n```\n\n### Contributor License Agreements\n\nWe'd love to accept your sample apps and patches! Before we can take them, we\nhave to jump a couple of legal hurdles.\n\nPlease fill out either the individual or corporate Contributor License Agreement\n(CLA).\n\n* If you are an individual writing original source code and you're sure you\n  own the intellectual property, then you'll need to sign an\n  [individual CLA](https://developers.google.com/open-source/cla/individual).\n* If you work for a company that wants to allow you to contribute your work,\n  then you'll need to sign a\n  [corporate CLA](https://developers.google.com/open-source/cla/corporate).\n\nFollow either of the two links above to access the appropriate CLA and\ninstructions for how to sign and return it. Once we receive it, we'll be able to\naccept your pull requests.\n\n### Contribution process\n\n1. Submit an issue describing your proposed change to the repo in question.\n1. The repo owner will respond to your issue promptly.\n1. If your proposed change is accepted, and you haven't already done so, sign a\n   Contributor License Agreement (see details above).\n1. Fork the desired repo, develop, and then test your code changes **on the latest dev branch**.\n1. Ensure that your code adheres to the existing style of the library to which\n   you are contributing.\n1. Ensure that your code has an appropriate set of unit tests which all pass.\n1. Submit a pull request targeting the latest dev branch.\n\n[gh-actions]: https://github.com/firebase/FirebaseUI-Android/actions\n[gh-actions-badge]: https://github.com/firebase/FirebaseUI-Android/workflows/Android%20CI/badge.svg\n","funding_links":[],"categories":["Java","Firebase Tools \u0026 Frameworks","Tools","Helpers"],"sub_categories":["Firebase Courses \u0026 Training","VS Code Extensions for Developer Productivity","Reference","Mesh networks"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirebase%2FFirebaseUI-Android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirebase%2FFirebaseUI-Android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirebase%2FFirebaseUI-Android/lists"}