Feature: Client/Server url schemas limitations for custom mobile apps (…

…#7508) * feature/5024-client-server-url-schemas-limitations-for-custom-mobile-apps adding section * Update source/deploy/build-custom-mobile-apps.rst * Update source/deploy/build-custom-mobile-apps.rst * Update source/deploy/build-custom-mobile-apps.rst * Update source/deploy/build-custom-mobile-apps.rst --------- Co-authored-by: Carrie Warner (Mattermost) <[email protected]>
mattermost · Oct 23, 2024 · 9a3ebfa · 9a3ebfa
1 parent 04f0415
commit 9a3ebfa
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/source/deploy/build-custom-mobile-apps.rst b/source/deploy/build-custom-mobile-apps.rst
@@ -54,6 +54,15 @@ Custom mobile app branding
 
 Ensure you select a unique app name that helps users distinguish your version from others, such as "<Your Company Name> Collaboration". See our `Brand and Visual Design Guidelines <https://handbook.mattermost.com/operations/operations/company-processes/publishing/publishing-guidelines/brand-and-visual-design-guidelines#name-usage-guidelines.html>`__ in our company Handbook for details.
 
+URL Schema Limitations
+~~~~~~~~~~~~~~~~~~~~~~
+If you are building your own version of Mattermost's mobile client, you need to be aware of the following things:
+
+- To allow users to simultaneously run the App Store versions of Mattermost, in addition to the custom company version, you will need to adapt the URL schemes used for the app in the build, as well as configure those schemes on the server using :ref:`App Custom URL Schemes <configure/site-configuration-settings:app custom url schemes>`
+- Be aware that the ``bundleid`` for the application should not include ``rnbeta``.
+- The same change would be required in a custom build of the Mattermost desktop app.
+- The mobile and desktop custom clients would no longer be able to log into other Mattermost servers (unless they had the same custom app schema configuration change applied).
+
 Deploying your custom app
 -------------------------