Skip to main content

The App module is available by default once you have installed the React Native Firebase library by following the Getting Started documentation. The App module currently provides the following functionality:

Secondary Apps

Unlike the Firebase Web SDK, there is no need to manually call the initializeApp method with your project credentials. The native Android & iOS SDKs automatically connect to your Firebase project using the credentials provided during the Getting Started installation steps. The app module does however provide support for manually initializing secondary Firebase app instances.

Currently, the native Firebase SDKs only provide functionality for creating secondary apps on the following services:

Initializing secondary apps​

The module exposes an initializeApp method which accepts arguments containing the credentials and options for your secondary apps:

import firebase from '@react-native-firebase/app';

// Your secondary Firebase project credentials...
const credentials = {
  clientId: '',
  appId: '',
  apiKey: '',
  databaseURL: '',
  storageBucket: '',
  messagingSenderId: '',
  projectId: '',
};

const config = {
  name: 'SECONDARY_APP',
};

await firebase.initializeApp(credentials, config);

Note that if you use multiple platforms, you will need to use the credentials relevant to that platform:

import firebase from '@react-native-firebase/app';
import { Platform } from 'react-native';

// Your secondary Firebase project credentials for Android...
const androidCredentials = {
  clientId: '',
  appId: '',
  apiKey: '',
  databaseURL: '',
  storageBucket: '',
  messagingSenderId: '',
  projectId: '',
};

// Your secondary Firebase project credentials for iOS...
const iosCredentials = {
  clientId: '',
  appId: '',
  apiKey: '',
  databaseURL: '',
  storageBucket: '',
  messagingSenderId: '',
  projectId: '',
};

// Select the relevant credentials
const credentials = Platform.select({
  android: androidCredentials,
  ios: iosCredentials,
});

const config = {
  name: 'SECONDARY_APP',
};

await firebase.initializeApp(credentials, config);

Once created, you can confirm the app instance has been created by accessing the apps property on the module:

const apps = firebase.apps;

apps.forEach(app => {
  console.log('App name: ', app.name);
});

Switching app instance​

You can switch app instances at any time whilst developing by calling the app method with the name of the secondary app:

import firebase from '@react-native-firebase/app';
import '@react-native-firebase/auth';

// Example using auth
firebase.app('SECONDARY_APP').auth().currentUser;

Or pass the secondary app instance you created above directly to the desired module, for example:

import firebase from '@react-native-firebase/app';
import auth from '@react-native-firebase/auth';

// create secondary app as described above
const secondaryApp = await firebase.initializeApp(credentials, config);

// Example using auth with passing the secondary app instance
auth(secondaryApp).currentUser;

Deleting instances​

You can delete any secondary instances by calling the delete method on the instance:

await firebase.app('SECONDARY_APP').delete();