React Native Firebase Starter
A basic react native app with
react-native-firebase pre-integrated to get you started quickly.
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
- 1.4) [iOS]
cd iosand run
pod install- if you don't have CocoaPods you can follow these instructions to install it.
- 1.5) [Android] No additional steps for android here.
2) Rename Project
You will need to be running Node version 7.6 or greater for the rename functionality to work
- 2.0) [iOS]
cd ..to return to the root directory of the project
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
Google Services files (plist & JSON)
- 3.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.
- 3.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.
- 3.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.
- 3.4) [Android] Place this file in the
android/app/directory of your project.
4) Start your app
- 4.1) Start the react native packager, run
yarn run startor
npm startfrom the root of your project.
- 4.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.
- 4.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.