Mobile App White-Labeling

You can rebrand your Rocket.Chat mobile apps to suit your style guide by customizing the app icons, splash screens, app name, and colors for your mobile app. This section provides an overview of white-labelling the Rocket.Chat mobile app for both Android and iOS platforms.

Requirements

To customize your mobile apps, here are some essential requirements:

• Intermediate knowledge of Android or iOS development and basic JavaScript knowledge.

• The repo contains targets and build flavors for our experimental and official apps. Both apps are equal, but released at different paces in the stores.

• The experimental folder contains the assets for the non-official app. If you see it, avoid worrying about breaking anything.

The following sections provide an overview of the remaining requirements:

Set up the GitHub repository

1. iOS and Google developer accounts: The respective development environments must be working, depending on your choice.

2. React Native environment: You can follow the setup guide from React Native.

3. Clone the Rocket.Chat ReactNative GitHub repo and checkout to the single-server branch with this command:

   git clone https://github.com/RocketChat/Rocket.Chat.ReactNative
   git checkout single-server

   You can also clone the single-server branch directly by running this command:

   git clone -b single-server https://github.com/RocketChat/Rocket.Chat.ReactNative

General white-labeling

1. Create an account on Bugsnag.

2. Set server, appGroup, and appStoreId in the app.json file. appGroup must be the same App Group created for the iOS app.

3. Change app colors in the colors.ts file.

Set up Firebase

To configure Firebase, you will first need to create a project Google Cloud Platform (GCP). Follow these steps:

1. Sign in to Google Console.

2. Navigate to New Project.

3. Fill in the required project details and click Create. You are redirected to the newly created project page.

Then create a new Firebase project by following these steps:

1. Sign in to Firebase.

2. Click Create a Project.

3. Select the project you created in GCP.

4. Follow the setup prompts and click Create.

Continue with the steps in the Android App White-labeling and iOS app White-labeling documents, depending on what you are building.