---
title: "Mobile App White-Labeling"
slug: "mobile-app-white-labelling"
description: "Customise Rocket Chat mobile apps with white labelling. Build secure branded communication tools for enterprise use."
updated: 2026-08-14T10:46:28Z
published: 2026-08-14T10:49:30Z
canonical: "developer.rocket.chat/mobile-app-white-labelling"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 official app.
- **Android only:** Your build must declare its own `android:sharedUserId`. Keeping the official value prevents your app from being installed alongside the official Rocket.Chat app. See the [Android App White-Labeling](/v1/docs/android-app-white-labeling) guide for more details.

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](https://reactnative.dev/docs/set-up-your-environment) from React Native.
3. Clone the Rocket.Chat [ReactNative GitHub repo](https://github.com/RocketChat/Rocket.Chat.ReactNative) and checkout to the `single-server` branch with this command:

```bash
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:

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

## General white-labeling

1. Create an account on [Bugsnag](https://www.bugsnag.com/).
2. Set `server`, `appGroup`, and `appStoreId` in the [app.json](https://github.com/RocketChat/Rocket.Chat.ReactNative/blob/single-server/app.json#L5) file. `appGroup` must be the same **App Group** created for the iOS app.
3. Change app colors in the [colors.ts](https://github.com/RocketChat/Rocket.Chat.ReactNative/blob/develop/app/lib/constants/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](https://console.cloud.google.com/home/dashboard).
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](https://console.firebase.google.com/).
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](/v1/docs/android-app-white-labeling) and [iOS app White-labeling](/v1/docs/ios-app-white-labeling) documents, depending on what you are building.