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, and self-registration.
• 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, and self-registration 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.
• Self-registration — set up a registration form for new mobile users.

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.

The self-registration feature allows tenants to configure a sign-up page for their clients, enabling them to sign up and log in to ThingsBoard with predefined permission configurations.

Configure the self-registration form:

Basic settings:

• Page title — the header displayed at the top of the registration page.
• Notification recipient — recipients that will receive notifications about new user registrations. Learn more about notifications.
• Redirect settings:
  • Application URL scheme — the custom URL scheme for redirecting users after registration (e.g., tbscheme).
  • Application URL hostname — the hostname used in redirection (e.g., app.pe.thingsboard.org).

Registration form fields:

The mandatory fields are email, password, and repeat password. Additional fields can be specified as needed.

Captcha properties:

Captcha prevents automated creation of fake accounts.

To generate Captcha keys, navigate to the Google reCAPTCHA admin console:

1. Select the reCAPTCHA version (v2, v3, or Enterprise).
2. Specify the domain name of your ThingsBoard instance.
3. Copy and securely store the site key and secret key.

In ThingsBoard:

Parameter	Description
Captcha version	The reCAPTCHA version to use.
Captcha site key	The public key used to render the captcha on the site.
Captcha secret key	The private key used to verify captcha responses on the server.
Captcha log action name	The action name associated with the captcha, used for logging.

Additional settings:

• Show Privacy Policy — enable or disable the Privacy Policy link on the registration page.
• Show Terms of Use — enable or disable the Terms of Use link on the registration page.
• User group roles — roles assigned to the user upon successful registration, determining their permissions and access level.

Advanced settings:

Parameter	Description
Customer group	The customer group to which the new user will be added.
Customer title prefix	A prefix added to the customer's title for identification.
Custom menu	A custom navigation menu applied for the new user.
Default dashboard	The dashboard displayed when the user logs in for the first time.

Home dashboard:

The main dashboard displayed when the user navigates to the Home menu item.

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.