Skip to content
🎁 A bare-bones react native app with react-native-firebase pre-integrated so you can get started quickly.
JavaScript Objective-C Java Ruby Python
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.opensource Create project.json Aug 25, 2018
__tests__ v5.3.0 (#105) Apr 9, 2019
android fix: include debug.keystore from facebook/react-native@d550256 Sep 15, 2019
assets Upgrade to react-native-firebase v5.0.0 and react-native 0.57.1 (#61) Oct 11, 2018
bin v5.3.0 - fix android package rename Apr 10, 2019
ios fix extra space Sep 13, 2019
.buckconfig Upgrade to RN 0.49.3, React 16.0.0-beta.5, RNFirebase 3.0.4 Oct 19, 2017
.editorconfig misc project files Jul 13, 2018
.flowconfig update all pacages and react native version Sep 8, 2019
.gitattributes Upgrade to RN 0.49.3, React 16.0.0-beta.5, RNFirebase 3.0.4 Oct 19, 2017
.gitignore fix: include debug.keystore from facebook/react-native@d550256 Sep 15, 2019
.prettierrc.js update all pacages and react native version Sep 8, 2019
.watchmanconfig Upgrade to RN 0.49.3, React 16.0.0-beta.5, RNFirebase 3.0.4 Oct 19, 2017
App.js v5.5.4 react-native-firebase update - Pods, Android versions+gradle Jun 28, 2019
LICENSE Update LICENSE Dec 23, 2018
README.md update iOS podfile Sep 10, 2019
app.json Upgrade to RN 0.49.3, React 16.0.0-beta.5, RNFirebase 3.0.4 Oct 19, 2017
babel.config.js v5.3.0 (#105) Apr 9, 2019
index.js v5.3.0 (#105) Apr 9, 2019
metro.config.js v5.3.0 (#105) Apr 9, 2019
package.json update firebase pods iOS add firebase bom Android and update readme Sep 10, 2019
yarn.lock update firebase pods iOS add firebase bom Android and update readme Sep 10, 2019

README.md

React Native Firebase Starter

Backers on Open Collective Sponsors on Open Collective npm version NPM downloads Chat Twitter Follow


A basic react native app with react-native-firebase pre-integrated to get you started quickly.


Getting Started

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

  • 1.1) git clone https://github.com/invertase/react-native-firebase-starter.git
  • 1.2) 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 yarn or npm install

2) Rename Project

You will need to be running Node version 7.6 or greater for the rename functionality to work

  • 2.1) 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

  • 3.1) cd ios and run pod install - if you don't have CocoaPods you can follow these instructions to install it.

4) Add Google Services files (plist & JSON)

  • 4.1) [iOS] Follow the add firebase to your app instructions here to generate your GoogleService-Info.plist file 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 firebase to your app instructions here to generate your google-services.json file 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.plist by editing the GADApplicationIdentifier key string.
  • 5.3) [Android] Remove or change in AndroidManifest.xml by modifying the content of <meta-data /> tag within the <application /> tag.
  • 5.4) More instrucation can be found here.

6) Start your app

  • 6.1) Start the react native packager, run yarn run start or npm start from the root of your project.
  • 6.2) [iOS] Build and run the iOS app, run npm run ios or yarn run ios from 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 android or yarn run android from the root of your project.

If all has gone well you'll see an initial screen like the one below.

Screenshots

preview

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! πŸ™ [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

License

You can’t perform that action at this time.