Mobile App
    • Dark
    • PDF

    Mobile App

    • Dark
    • PDF

    Article summary

    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.


    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

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

    git clone
    cd Rocket.Chat.ReactNative
    • 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.


    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.

    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.

    Eddy AI, facilitating knowledge discovery through conversational intelligence