Mobile App

The Rocket.Chat Mobile App is built using React Native, allowing us to develop Android and iOS applications from a single codebase. Setting up the development environment requires you to download and install multiple dependencies.
Please maintain an active internet connection throughout the installation process.


Before setting up, confirm that these tools are installed and running correctly on your device:
  • Git
  • Node.js
  • Yarn (recommended instead of npm)
  • macOS with XCode Command Line Tools to run the iOS version,
  • Android Studio to run the Android version.
Follow the official documentation to set up your React Native environment. Navigate to the React Native CLI Quickstart section, as we don't support Expo-managed flow.

Set up the codebase

git clone [email protected]:RocketChat/Rocket.Chat.ReactNative.git
cd Rocket.Chat.ReactNative
  • Run the app
for iOs:
npx pod-install
yarn ios
or, for android:
yarn android
Now, the app is running on the simulator or your device.


If you are yet to find a bug or want a new feature that hasn't been reported, see the help wanted sections or the good first issue labels. Triaging issues is a great way to contribute if you can't code.
You can follow the guidelines to open a pull request when your changes are ready. You can also share working results before finishing. Including [WIP] in the title. This way, anyone can look at your code: you can ask for help within the PR if you need help solving a problem.
Various tools automatically inspect your PR check their response, and try to improve your code accordingly. Requests that fail to build or have the wrong coding style won't be merged.