Supported Server Versions: 0.58.0+ (We are working to support earlier versions)

Follow the React Native Getting Started Guide for detailed instructions on setting up your local machine for development.

• General requirements

  • XCode 8.3
  • Install required packages using homebrew:

    $ brew install watchman
    $ brew install yarn

• Clone repository and configure:

  $ git clone [email protected]:RocketChat/Rocket.Chat.ReactNative.git
  $ cd Rocket.Chat.ReactNative
  $ npm install
  $ npm install -g react-native-cli

• Run application

  $ react-native run-ios

  $ react-native run-android

• General requiriments:

  • JDK 7 or greater
  • Android SDK
  • Virtualbox
  • An Android emulator: Genymotion or Android emulator. If using genymotion ensure that it uses existing adb tools (Settings: "Use custom Android SDK Tools")
  • Install watchman (do this globally):

    $ git clone https://github.com/facebook/watchman.git
    $ cd watchman
    $ git checkout master
    $ ./autogen.sh
    $ ./configure make
    $ sudo make install

    Configure your kernel to accept a lot of file watches, using a command like:

    $ sudo sysctl -w fs.inotify.max_user_watches=1048576

• Clone repository and configure:

  $ git clone [email protected]:RocketChat/Rocket.Chat.ReactNative.git
  $ cd Rocket.Chat.ReactNative
  $ npm install
  $ npm install -g react-native-cli

• Run application

  • Start emulator
  • Start react packager: $ react-native start
  • Run in emulator: $ react-native run-android

• General requirements

  • Install storybook

    $ npm i -g @storybook/cli

• Running storybook

  • Run storybook application

    $ npm run storybook

  • Run application in other shell

    $ react-native run-ios

  • Running storybook on browser to help stories navigation

    open http://localhost:7007/