README

[!WARNING]
 CocoaPods: New versions of the Firebase Apple SDK will no longer be
 published to CocoaPods after October 2026. Existing CocoaPods versions
 will remain available and installations will remain functional. See the
 migration guide
 for more information.

 [!TIP]
 Preview Release: Firebase AI Logic's Gemini Foundation Models framework
 adapter is now available in preview. Get started by visiting the
 documentation.

 Firebase Apple Open Source Development

This repository contains the source code for all Apple platform Firebase
libraries except FirebaseAnalytics.

Firebase is an app development platform with libraries, services, and tools to
help you build, grow, and monetize your app. Learn more about Firebase at the
official Firebase website.

 Supported Firebase Products

The following products are open-source and included in this repository:

   Firebase AI Logic (FirebaseAI)
   App Check (FirebaseAppCheck)
   App Distribution (FirebaseAppDistribution)
   Authentication (FirebaseAuth)
   Cloud Firestore (FirebaseFirestore)
   Cloud Functions (FirebaseFunctions)
   Cloud Messaging (FirebaseMessaging)
   Crashlytics (FirebaseCrashlytics)
   In-App Messaging (FirebaseInAppMessaging)
   Performance Monitoring (FirebasePerformance)
   Realtime Database (FirebaseDatabase)
   Remote Config (FirebaseRemoteConfig)
   Storage (FirebaseStorage)

 [!NOTE]
 Firebase Analytics is not open-source, but its pre-compiled binaries are
 included when installing Firebase via Swift Package Manager or CocoaPods.

 Installation

See the subsections below for details about the different installation methods.
Where available, it's recommended to install libraries with a Swift suffix to
get the best experience when writing your app in Swift.

- Swift Package Manager
- CocoaPods
- Install from GitHub
- Experimental Carthage
- Framework or library

 Swift Package Manager installation

Find instructions for installing using
Swift Package Manager in the
Firebase get started documentation.

 CocoaPods installation

Find instructions for installing with CocoaPods (pod install) in the
Firebase installation options documentation.

Note: To accommodate the read-only announcement from CocoaPods, Firebase
will stop publishing new versions to CocoaPods in October 2026.
Learn more.

 Install from GitHub

You can install from GitHub to access the Firebase repo at other branches, tags,
or commits.

 Background

For instructions and options about overriding pod source locations, see the
Podfile Syntax Reference.

 Access Firebase source snapshots

All official releases are tagged in this repo and available via CocoaPods. To
access a local source snapshot or unreleased branch, use Podfile directives.
Here are some example directives which use FirebaseFirestore as the example
library.

To access FirebaseFirestore via a branch:

ruby
pod 'FirebaseCore', :git = 'https://github.com/firebase/firebase-ios-sdk.git', :branch = 'main'
pod 'FirebaseFirestore', :git = 'https://github.co