Mobile App Center

The Mobile App Center is a hub for building, configuring, and managing mobile apps in ThingsBoard. Whether you are starting from scratch or preparing to publish the ThingsBoard Mobile Application to the Google Play Store or App Store, this tool guides you through every step.

The Mobile App Center is divided into tabs:

• Bundle — manage settings for mobile applications included in the bundle: authentication methods, layout.
• Applications — add, edit, or remove mobile applications.
• QR code widget — set up a QR code widget on the Home page for easy mobile app access.

A Bundle groups together configurations like OAuth 2.0 settings, layout design for one or more mobile apps — allowing you to manage Android and iOS versions in one place.

The bundle wizard includes the following steps:

• Basic settings — define the bundle name and link your apps. You can also create a new app directly.
• OAuth 2.0 — enable Single Sign-On (SSO) via third-party identity providers that support OAuth 2.0.
• Layout — customize the app’s navigation menu to match your use cases.

1. Go to the Mobile center page.
2. On the Bundle tab, click + Add bundle in the upper-right corner.

A new settings dialog will open.

Enter a name for your bundle and select existing Android/iOS apps, or create new ones directly from this window.

1. Click Create new in the corresponding section (Android Application or iOS Application).
2. Enter the application package name.
3. An Application Secret will be generated automatically. Save it or replace with your own.
4. Set the application status:
   • Draft — for applications still in development. Store information can be added later.
   • Published — for applications ready to be launched and used by end users.
   • Deprecated — for older applications that are no longer actively supported but still available.
   • Suspended — for applications that are temporarily disabled or restricted.
5. (Optional) Specify minimum/latest app versions and release notes.
6. Add store information:
   • Android: Google Play Store link and SHA256 certificate fingerprints.
   • iOS: App Store link and App ID.
7. Click Add to save the application.

Then, click Next.

Add authentication for your users through an external provider that supports the OAuth 2.0 protocol. Specify an already configured OAuth 2.0 client or configure a new one.

You can also disable OAuth 2.0 for mobile devices.

After completing the OAuth 2.0 configuration, click Next.

Set up quick access to the features and dashboards you use most frequently. Add menu items, change icons and item names, and reorganize the navigation menu.

To add a new menu item:

1. Click + Add specific page at the bottom of the page or between existing menu items.
2. Enter the name for the new menu page.
3. Select the page type:
   • Dashboard — link to a ThingsBoard dashboard.
   • Webview — link to an external webpage.
   • Custom — link to built-in ThingsBoard pages.
4. Depending on the selected page type, specify a dashboard, external URL, or ThingsBoard menu item.
5. Click Add.

The following routes are available for the Custom page type:

Page name	Route	Description
Home	/home	Displays the Home page
Assets	/assets	Displays the Assets page
Device profiles	/devices	Displays the Device profiles page
All devices	/deviceList	Displays the list of all devices
Alarms	/alarms	Displays the list of alarms
Dashboards	/dashboards	Displays the list of dashboards
Specific dashboard	/dashboard/:id	Displays the specified dashboard
Audit logs	/auditLogs	Displays the Audit logs page
Customers	/customers	Displays the list of customers
Specific customer	/customer/:id	Displays the specified customer
Notifications	/notifications	Displays the list of notifications
Custom URL link	/url/:link	Displays an external URL

The number of menu items displayed in the bottom navigation menu depends on the screen size of the mobile device. Items that do not fit will be available under the More page.

After creating the bundle, a configuration dialog opens with basic configuration settings for the ThingsBoard Mobile Application. Continue configuring your new mobile app using the provided instructions, or skip this step if you already have a mobile app configured. Click Close.

The bundle has been added. The applications specified in the bundle now use the defined settings.