Miss any of our Open RFC calls?Watch the recordings here! »

This version has been deprecated

Author message:

Read more: https://gist.github.com/brentvatne/9038b16b4f42a21cea40ad5c35fdb74c


1.0.0 • Public • Published


expo-firebase-crashlytics allows you to monitor native and non-fatal crashes.

Full documentation


Now, you need to install the package from npm registry.

npm install expo-firebase-crashlytics or yarn add expo-firebase-crashlytics



If you're using Cocoapods, add the dependency to your Podfile:

pod 'EXFirebaseCrashlytics', path: '../node_modules/expo-firebase-crashlytics/ios'

and run pod install.


You could also choose install this module manually.

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesexpo-firebase-crashlytics and add EXFirebaseCrashlytics.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libEXFirebaseCrashlytics.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R).

Common Setup

Add the Crashlytics run script

RNFirebase crashlytics build script

  1. Open your project in Xcode and select its project file in the Navigator

  2. Open the Build Phases tab.

  3. Click + Add a new build phase, and select New Run Script Phase.

  4. Add the following line to the Type a script... text box:

  5. XCode 10 only: Add your app's built Info.plist location to the Build Phase's Input Files field:



  1. Append the following lines to android/settings.gradle:

    include ':expo-firebase-crashlytics'
    project(':expo-firebase-crashlytics').projectDir = new File(rootProject.projectDir, '../node_modules/expo-firebase-crashlytics/android')

    and if not already included

    include ':expo-core'
    project(':expo-core').projectDir = new File(rootProject.projectDir, '../node_modules/expo-core/android')
    include ':expo-firebase-app'
    project(':expo-firebase-app').projectDir = new File(rootProject.projectDir, '../node_modules/expo-firebase-app/android')
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:

    api project(':expo-firebase-crashlytics')

    and if not already included

    api project(':expo-core')
    api project(':expo-firebase-app')
  3. Include the module in your expo packages: ./android/app/src/main/java/host/exp/exponent/MainActivity.java

    * At the top of the file.
    * This is automatically imported with Android Studio, but if you are in any other editor you will need to manually import the module.
    import expo.modules.firebase.app.FirebaseAppPackage; // This should be here for all Expo Firebase features. 
    import expo.modules.firebase.fabric.crashlytics.FirebaseCrashlyticsPackage;
    // Later in the file... 
    public List<Package> expoPackages() {
      // Here you can add your own packages. 
      return Arrays.<Package>asList(
        new FirebaseAppPackage(), // This should be here for all Expo Firebase features. 
        new FirebaseCrashlyticsPackage() // Include this. 


import React from 'react';
import { View } from 'react-native';
import firebase from 'expo-firebase-app';
// Include the module before using it.
import 'expo-firebase-crashlytics';
// API can be accessed with: firebase.crashlytics();
export default class DemoView extends React.Component {
  async componentDidMount() {
    // Native crash the app to test.
    try {
      await someAsyncTask();
    } catch ({ message, code }) {
      // Put this in all your try/catch's to log them.
      firebase.crashlytics().recordError(code, message);
  render() {
    return <View />;

Trouble Shooting

You may find that the Crashlytics tab is stuck on the onboarding page in the firebase console. If this happens then make sure your Firebase app id matches Expo bundle ID/Package ID. For instance, if you start testing with host.exp.Exponent then detach, you will need to update the config to reflect your new ID.


npm i [email protected]





Unpacked Size

26.8 kB

Total Files


Last publish


  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar