Get Started
API Reference


expo-firebase-core provides access to the Firebase configuration and performs initialisation of the native Firebase App.

Platform Compatibility

Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb


expo install expo-firebase-core

If you're installing this in a bare React Native app, you should also follow these additional installation instructions.

To use this package, Firebase needs to be configured for your app. Please follow this guide on how to configure native Firebase.
No explicit calls to expo-firebase-core are required to initialize Firebase. This library will auto-initialize the Firebase app when a valid configuration exists.

At the moment, only Firebase Analytics is supported natively. We are working on bringing more native Firebase packages to Expo, stay tuned :)
  • expo-firebase-analytics

import * as FirebaseCore from 'expo-firebase-core';


Name of the default Firebase app (e.g. [DEFAULT]).
On the Expo client a Firebase App is created for each project that is loaded, and a unique name for each project is returned.

Firebase options with which the default app was initialized. If no Google services configuration was provided, undefined is returned.
Depending on the platform, the options are read from the following files and app.json keys.
PlatformFileApp.json key

// {
//   appId: "1:1082251606918:ios:a2800bc715889446e24a07",
//   apiKey: "AIzaXXXXXXXX-xxxxxxxxxxxxxxxxxxx",
//   clientId: "000000000000-0000000000000.apps.googleusercontent.com",
//   trackingId: 12345567890,
//   databaseURL: "https://myexpoapp777.firebaseio.com",
//   storageBucket:  "myexpoapp777.appspot.com",
//   projectId: "myexpoapp777",
//   messagingSenderId:  123454321
// }

The default Firebase options as defined in web.config.firebase in app.json.
This constant is useful when you want to use the Firebase JS SDK on native.