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
ornpm install
- 1.4) [iOS]
cd ios
and runpod 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 verison 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
Google Services
files (plist & JSON)
3) Add - 3.1) [iOS] Follow the
add firebase to your app
instructions here to generate yourGoogleService-Info.plist
file if you haven't done so already - use the package name generated previously as youriOS bundle ID
. - 3.2) [iOS] Place this file in the
ios/
directory of your project. - 3.3) [Android] Follow the
manually add firebase
to your app instructions here to generate yourgoogle-services.json
file if you haven't done so already - use the package name generated previously as yourAndroid package name
. - 3.4) 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 start
ornpm run start
from the root of your project. - 4.2) [iOS] Build and run the iOS app, run
react-native 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
react-native run-android
from the root of your project.
If all has gone well you'll see an initial screen like the one below.
Screenshots
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
- See LICENSE