React-native-template-re-route NPM

re-start :globe_with_meridians: :iphone: :computer:

Aim of the project

Target multiple platforms (Android, iOS, Web, WindowsUWP and ElectronmacOS, Linux, Windows) with react native' APIs and a single codebase.
Follow best practices while doing the above.
Cut out the time and effort it takes to setup the project (based on create-react-app).
Achieve write once run everywhere with react-native (though react strictly says 'Learn once use anywhere').
Mitigate git cloning or manual upgrading of boiler plates, which is possible because this project is a react-native template. :tada:

Structure of the project

This project comprises of several templates that are curated keeping in mind the various use cases of initiating a new project. Based on your requirements and preferences, you can choose a templates that suits your you case the best.

Template Name	Description	Version
`re-base`	The most basic version that runs on all platforms
`re-dux`	`re-base` with redux wired out of the box
`re-route`	`re-base` with react-router wired out of the box
`re-start`	`re-base` combined with redux and react-router

Usage

Pre-requisites

Node.js & npm
react-native CLI (npm install -g react-native-cli)

Install

Create a new react-native project using react-native-cli and specify re-base as a template:
```
react-native init <Your Project Name> --template re-base
```
React Native don't support templates inheritance. If you want to use a derived template like re-dux or re-route, install them directly on top of the just created project. You'll probably get a warning about the project already exists, just say it yes to overwrite the needed files.
```
react-native init <Your Project Name> --template re-dux
react-native init <Your Project Name> --template re-route
react-native init <Your Project Name> --template re-start
```
re-start template depend of both re-route and re-dux, be sure to install them first in that order.
Since react-native-template doesn't support adding custom scripts to package.json, exec ./finishInstall.js to finish the project configuration.
Your project should now be ready to build apps for the different platforms.

Run the project on a specific platform

Android/iOS

npm/yarn run android
npm/yarn run ios

In case of problems, this tutorial will help you to configure your environment.

Desktop (Electron)

npm/yarn run electron

Web

npm/yarn run web

Windows

npm/yarn run windows

Windows platforms needs to have installed the Windows 10 SDK Build 14393 to be able to be build. A certificate is needed to sign the binary, follow the instructions to create or update the sign certificate. After that, a pop-up window would appear during the first time you exec the build process asking to install the certificate you've just created, just accept it.

Build for production

Android

npm/yarn run android:release

Electron

npm/yarn run electron:release

If you are running this on Linux or OSX, this will need you have wine 1.6 installed in your system because setting the Windows app icon makes usage internally of the node-rcedit package.