c3duan/react-native-firebase-starter

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.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
1.4) [iOS] cd ios and 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.

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
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.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.
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 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.
3.4) [Android] Place this file in the android/app/ directory of your project.

4.1) Start the react native packager, run yarn run start or npm start from the root of your project.
4.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.
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 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.

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

Thank you to all our backers! 🙏 [Become a backer]