vip-git / react-native-boilerplate

🚀 Type Based Architecture for developing React Native Apps [Updated 0.57.4]

🚀 React Native Boilerplate - September 2018

React Native Boilerplate is a starting point for React Native application. This project is configured with redux, redux saga and redux persist. Latest version of react-navigation (v2.16) with NavigationService instead of Redux Integration.

Scalability Factor

This Type based Architecture scales smoothly for small - medium apps. If you guys are building a very large application I would suggest using the following feature based architecture which will be more developer friendly with ease of scaling.

React-Native-Feature-BoilerPlate

Features

• Redux
• Redux Saga
• Redux Persist
• React Navigation
• Jest
• Eslint (Airbnb config)

Projects using this BoilerPlate

• react-native-messenger
• rn-coffee

Prerequisites

• Node v8.10 (it is recommended to install it via NVM)
• Yarn
• A development machine set up for React Native by following these instructions

Getting Started

1. Clone this repo, git clone https://github.com/victorkvarghese/react-native-boilerplate.git <your project name>

2. Go to project's root directory, cd <your project name>

3. Remove .git folder, rm -rf .git

4. Open package.json and change the name property with your project name

5. Open index.js and replace 'ReactNativeBoilerPlate' by your project name

6. Open app.json and replace 'ReactNativeBoilerPlate' by your project name

7. Run yarn or npm install to install dependencies

8. Run react-native upgrade to upgrade and add iOS & Android Folders.

9. Run react-native link

10. Start the packager with npm start

11. Connect a mobile device to your development machine

12. Run the test application:

• On Android:
  • Run react-native run-android
• On iOS:
  • Open ios/YourReactProject.xcodeproj in Xcode
  • Hit Run after selecting the desired device

13. Enjoy!!!

Contributing

PRs are welcome