A check list to refer to before starting a react-native project. All credit goes to Chris Ball as this is heavily based on his Chain React 2017 talk.
Disclaimer: This is still a work in progress. If you notice any mistakes, PRs are very appreciated.
- Prerequisites
- Init App
- Development Strategy Tips
- App Icons & Splash-screen
- Rename App
- CI
- Handle Offline
- @TODO
- Certificates
- @TODO
- Use Fastlane Precheck
- Review Apple's Common App Rejections
If you are a company, you will need a D-U-N-S number.
Check whether you have a D-U-N-S number here . If you don't have one, you will be given the option to apply.
Otherwise, you can sign up as an individual.
Google is simpler, however you should still know if you are enrolling as a company or individual.
Sign up 👉 Google Play.
There are many boilerplates/starter kits for react-native out there. I highly recommend using create-react-native-app as a starting point, however if you do not mind learning the boilerplates, you will find a list of good starters below.
Even if you choose to focus on one platform at first, it is recommended that you always check both, especially if you are installing a lot of third-party libraries. React Native is constantly changing and the libraries you are using probably cannot keep up with all the breaking changes being introduced. If you want to avoid making bad decisions and identifying potential road blocks early, make sure you always check both platforms.
Even better, focus on Android and check iOS. This is because Android is the platform most likely to make you run into issues.
💻📲 (Recommended)
Generating app icons and a splash-screen doesn't have to be hard. Simply install generator-rn-toolbox and follow the instructions to get them for both iOS and Android.
If you do not go with the automatic way, you will need to generate your app icons in the following sizes for each respective format:
- In iOS, set
AppIconinImages.xcassets - Add 9 different size icons:
- 29pt
- 29pt*2
- 29pt*3
- 40pt*2
- 40pt*3
- 57pt
- 57pt*2
- 60pt*2
- 60pt*3.
- Put ic_launcher.png to folder ``[PrjDir]/android/app/src/main/res/minmap-*`.
- 72*72
ic_launcher.pngtomipmap-hdpi. - 48*48
ic_launcher.pngtomipmap-mdpi. - 96*96
ic_launcher.pngtomipmap-xhdpi - 144*144
ic_launcher.pngtomipmap-xxhdpi
- 72*72
Use react-native-rename to automatically rename your react-native app fro iOS and Android
Renaming a react-native app manually is simple.
The app name displayed on the iPhone home screen comes from the CFBundleDisplayName (or "Bundle display name") as the human-readable string in Xcode) entry of your iOS app's info.plist.
The app name on android comes from AndroidManifest.xml. Check the label attribute of <application>
This value is typically referenced as a named variable, defined in strings.xml
✅ : Officially supported.
❌ : Not supported.
🔌 : Community supported or left to developer to integrate
| Feature | Buddy Build | VS Mobile Center |
|---|---|---|
| Crash Reports | ✅ | ✅ |
| Bug Reports | ✅ | ❌ |
| Instant Replay | ✅ | ❌ |
| Analytics | ❌ | ✅ |
| Deploy to store | ✅ | ✅ |
// @TODO
Make sure to run fastlane's precheck before submitting your app to Apple's app store. From their repo:
Apple rejects builds for many avoidable metadata issues like including swear words 😮, other companies’ trademarks, or even mentioning an iOS bug 🐛. fastlane precheck takes a lot of the guess work out by scanning your app’s details in iTunes Connect for avoidable problems. fastlane precheck helps you get your app through app review without rejections so you can ship faster 🚀
Make sure to read over Apple's common app rejection before submitting to the app store. These are the most common issues that apple rejects apps for, so save yourself the trouble and make sure your app won't be rejected for obvious reasons.