React Native Firebase Starter
A basic react native app with
react-native-firebase pre-integrated to get you started quickly.
DEPRECATED: This is for RNFB v5 only. For v6 onwards please follow the new projects guide.
If you're only developing for one platform you can ignore the steps below that are tagged with the platform you don't require.
1) Clone & Install Dependencies
git clone https://github.com/invertase/react-native-firebase-starter.git
cd react-native-firebase-starter- cd into your newly created project directory.
- 1.3) Install NPM packages with your package manager of choice - i.e run
2) Rename Project
You will need to be running Node version 7.6 or greater for the rename functionality to work
npm run rename- you'll be prompted to enter a project name and company name
- 2.2) Note down the package name value - you'll need this when setting up your Firebase project
3) [iOS] Install Pods
RN < 0.60.0
cd iosand run
pod install- if you don't have CocoaPods you can follow these instructions to install it.
Google Services files (plist & JSON)
- 4.1) [iOS] Follow the
add firebase to your appinstructions here to generate your
GoogleService-Info.plistfile if you haven't done so already - use the package name generated previously as your
iOS bundle ID.
- 4.2) [iOS] Place this file in the
ios/directory of your project.
- Once added to the directory, add the file to your Xcode project using 'File > Add Files to "[YOUR APP NAME]"…' and selecting the plist file.
- 4.3) [Android] Follow the
manually add firebaseto your app instructions here to generate your
google-services.jsonfile if you haven't done so already - use the package name generated previously as your
Android package name.
- 4.4) [Android] Place this file in the
android/app/directory of your project.
5) AdMob Setup (Or Removal)
- 5.1) React Native Firebase Starter kit comes with AdMob pre-install. The default Sample AdMob App ID is used in both the
info.plist[iOS] and the
AndroidManifest.xml[Android] files. If you don't want to use AdMob, just remove it. If you do, be sure to update your ID!
- 5.2) [iOS] Remove or change in
info.plistby editing the
- 5.3) [Android] Remove or change in
AndroidManifest.xmlby modifying the content of
<meta-data />tag within the
- 5.4) More instrucation can be found here.
6) Start your app
- 6.1) Start the react native packager, run
yarn run startor
npm startfrom the root of your project.
- 6.2) [iOS] Build and run the iOS app, run
npm run iosor
yarn run iosfrom the root of your project. The first build will take some time. This will automatically start up a simulator also for you on a successful build if one wasn't already started.
- 6.3) [Android] If you haven't already got an android device attached/emulator running then you'll need to get one running (make sure the emulator is with Google Play / APIs). When ready run
npm run androidor
yarn run androidfrom the root of your project.
If all has gone well you'll see an initial screen like the one below.