Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/harrisrobin/react-native-checklist

๐Ÿ“ From idea to app store. A recommended check list for shipping react-native apps.
https://github.com/harrisrobin/react-native-checklist

checklist react-native react-native-tutorial

Last synced: 3 months ago
JSON representation

๐Ÿ“ From idea to app store. A recommended check list for shipping react-native apps.

Awesome Lists containing this project

README

        




Markdownify


React Native Checklist


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](https://www.youtube.com/watch?v=W8X7t1qlT_w) talk.

***Disclaimer: This is still a work in progress. If you notice any mistakes, PRs are very appreciated.***

## Table of content
- [Prerequisites](#installation)
- [App Store](#app-store-and-google-play)
- [Init App](#init-app)
- [Starters](#starters)
- [Development Strategy Tips](#development-strategy-tips)
- [Focus on one, check both](#focus-on-one-check-both)
- [App Icons & Splash-screen](#app-icons-and-splash-screen)
- [Automatic](#generate-app-icons-&-splash-screen-automatically)
- [Manual](#generate-app-icons-&-splash-screen-manually)
- [Rename App](#rename)
- [Automatic](#rename-app-automatically)
- [Manual](#rename-app-manually)
- [CI](#ci)
- [Comparison Table](#ci-comparison-table)
- [Handle Offline](#handle-offline)
- @TODO
- [Certificates](#Certificates)
- @TODO
- [Use Fastlane Precheck](#use-fastlane-precheck)
- [Review Apple's Common App Rejections](#common-app-rejection)

## Prerequisites
### App Store and Google Play

#### iOS
If you are a company, you will need a [D-U-N-S number](https://developer.apple.com/support/D-U-N-S/).

Check whether you have a D-U-N-S number [here](https://developer.apple.com/enroll/duns-lookup/#/search) . If you don't have one, you will be given the option to apply.

Otherwise, you can sign up as an individual.

#### Android
Google is simpler, however you should still know if you are enrolling as a company or individual.

Sign up ๐Ÿ‘‰ [Google Play](https://play.google.com/apps/publish/signup/).

## Init App
### Starters
There are many boilerplates/starter kits for react-native out there. I highly recommend using [create-react-native-app](https://github.com/react-community/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.

#### [ignite ๐Ÿ”—](https://github.com/infinitered/ignite)
#### [pepperoni-app-kit ๐Ÿ”—](https://github.com/futurice/pepperoni-app-kit)

## Development Strategy Tips

### Focus on one, check both.
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.

## App Icons and Splash-screen
### Generate App Icon & Splash-screen Automatically
***๐Ÿ’ป๐Ÿ“ฒ (Recommended)***

Generating app icons and a splash-screen doesn't have to be hard. Simply install [generator-rn-toolbox](https://github.com/bamlab/generator-rn-toolbox/blob/master/generators/assets/README.md) and follow the instructions to get them for both iOS and Android.

### Generate App Icon & Splash-screen Manually
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:

[Original answer](https://stackoverflow.com/a/34333915/6401805)

#### iOS
* In iOS, set `AppIcon` in `Images.xcassets`
* Add 9 different size icons:
* 29pt
* 29pt*2
* 29pt*3
* 40pt*2
* 40pt*3
* 57pt
* 57pt*2
* 60pt*2
* 60pt*3.

#### Android
* Put ic_launcher.png to folder ``[PrjDir]/android/app/src/main/res/minmap-*`.
* 72*72 `ic_launcher.png` to `mipmap-hdpi`.
* 48*48 `ic_launcher.png` to `mipmap-mdpi`.
* 96*96 `ic_launcher.png` to `mipmap-xhdpi`
* 144*144 `ic_launcher.png` to `mipmap-xxhdpi`

## Rename
### Rename App Automatically
Use [react-native-rename](https://github.com/junedomingo/react-native-rename) to automatically rename your react-native app fro iOS and Android

### Rename App Manually Manual
Renaming a react-native app manually is simple.
#### iOS
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.
![display name](assets/images/cbfbundledisplayname-ss.png)

#### Android
The app name on android comes from AndroidManifest.xml. Check the label attribute of ``

This value is typically referenced as a named variable, defined in strings.xml
![app name](assets/images/app_name-ss.png)

## CI

### CI Comparison Table
#### Legend

โœ… : Officially supported.

โŒ : Not supported.

๐Ÿ”Œ : Community supported or left to developer to integrate



BB logo


VS code mobile center



Feature
Buddy Build
VS Mobile Center




Crash Reports
โœ…
โœ…


Bug Reports
โœ…
โŒ


Instant Replay
โœ…
โŒ


Analytics
โŒ
โœ…


Deploy to store
โœ…
โœ…

## Certificates
// @TODO

## Use Fastlane Precheck

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 ๐Ÿš€

[๐Ÿ‘‰ ๐Ÿ‘‰Precheck๐Ÿ‘ˆ ๐Ÿ‘ˆ](https://github.com/fastlane/fastlane/tree/master/precheck)

## Common App Rejection

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.

๐Ÿ‘‰ ๐Ÿ‘‰ [Apple Common Rejection ๐Ÿ‘ˆ ๐Ÿ‘ˆ](https://developer.apple.com/app-store/review/rejections/)