Mobile App

The Rocket.Chat Mobile App is built using React Native, allowing you 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.

Requirements

Before setting up, confirm that these tools are installed and running correctly on your device:

  • 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

  • Clone the GitHub repository and install the required dependencies by running these commands:

git clone https://github.com/RocketChat/Rocket.Chat.ReactNative.git
cd Rocket.Chat.ReactNative
yarn
  • Run the app by executing these commands:

for iOS:

npx pod-install
yarn ios

for Android:

yarn android

Now, the app is running on the simulator or your device.

Contributing

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.

To learn more about Rocket.Chat contribution process, see Participate in Rocket.Chat Development.

You have the option to share your ongoing work before completion by adding [WIP] to your pull request (PR) title. This allows others to review your code and offer assistance if you encounter challenges while solving a problem.

Last updated

Rocket.Chat versions receive support for six months after release.