/mobx-react-native-template

A react-native template using advanced react-native Architecture with mobx

Primary LanguageJavaScript

Mobx React Native Template

It's a nice beginning for a new react native project with mobx architecture from mobx-react-native-template.

Howto

Install Dependencies:

  1. NodeJS( ~> 6.2.2 )

    $ brew update && brew install node

  2. npm( ~> 3.10.3 )

  3. rnpm

    npm install -g rnpm

In iOS platform, Xcode is needed.

In Android platfrom, Android studio or Genymotion is needed.

After finish install dependencies.

Then lauch it

  1. $ git clone git@github.com:80percent/mobx-react-native-template.git && cd mobx-react-native-template
  2. $ npm install
  3. $ react-native upgrade
  4. $ rnpm link
  5. $ cp app/config/index.js.example app/config/index.js
  6. $ react-native run-ios or react-native run-android

Done.

You need start an iOS simulator or android simulator before running your app, see more: https://facebook.github.io/react-native/docs/getting-started.html

Mobx advantage

Mobx is a new architecture to manage your store data. Unlike redux or flux, there's just a fewer concepts to understand and it's very simple to use.

See more usage into the directory app/.

Some Advice

Question: How to create a new page

  1. Add a new container component to app/containers/, some examples in app/containers/ you can follow.
  2. Add a new route to app/navigation/routes.js.
  3. Refresh your app page

Question: How to debug app

ReactNative use chrome debugger by default. You need install chrome browser before debug your app.

iOS Simulator:

  1. Open your app
  2. Input ctrl + command + z ( if not, try command + d )
  3. Choose Open debugger from the new modal. Now chrome will open a new page: http://localhost:8081/debugger-ui
  4. Select pause on exception in chrome debugger( optional )
  5. Refresh your app page( command + R )

Android:

  1. Open your app
  2. Input command + m
  3. Choose Open debugger from the new modal. Now chrome will open a new page: http://localhost:8081/debugger-ui
  4. Select pause on exception in chrome debugger( optional )
  5. Refresh your app page( double click R )

see more: https://facebook.github.io/react-native/docs/debugging.html

Question: How to rename my project

  1. Update the name of package.json
  2. Update the name of index.ios.js & index.android.js
  3. rm -rf ios; rm -rf android;
  4. react-native upgrade
  5. rnpm install

It's all

Other useful resources

  1. react layouts
  2. mobx best practices in react-native
  3. Running on android device
  4. Singed apk on android device

Code style recommend

  1. Use ES7
  2. Two spaces instead of tab
  3. No state operations in your code

Built with

80% team