Expo

Get Started
API Reference

FirebaseCore

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

Platform Compatibility

Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb

Installation

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';

Type: string | void

Name of the default Firebase app (e.g. [DEFAULT]).

In Expo Go, a Firebase App is created for each project that is loaded, and a unique name for each project is returned.

Type: FirebaseOptions | void

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
iOSGoogleService-Info.plistios.googleServicesFile
Androidgoogle-services.jsonandroid.googleServicesFile
Web-web.config.firebase

Example

console.log(FirebaseCore.DEFAULT_APP_OPTIONS);
{
  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
}

Type: FirebaseOptions | void

The default Firebase options as defined in web.config.firebase in app.json.

NameTypeDescription
apiKey
(optional)
stringFirebase API key.
appId
(optional)
stringUnique identifier of the Firebase app.
authDomain
(optional)
string-
databaseURL
(optional)
stringFirebase database URL.
measurementId
(optional)
string-
messagingSenderId
(optional)
string-
projectId
(optional)
stringUnique identifier of the Firebase project.
storageBucket
(optional)
stringGoogle Cloud Storage bucket name.
trackingId
(optional)
stringTracking identifier for Google Analytics.