Totara Mobile has two levels of customisation, customising the look and feel, and extending the app.
Look and feel customisation
In order to brand the Totara Mobile app with minimal changes, use the official theming product documentation as a reference.
Extend the app
After exploring the theming product documentation, in order to extend the mobile app, you may have the following main options to change:
- App unique application ID
- App icons
- Advanced theming using TotaraTheme
- Caching
- Default language strings
Using a unique app ID will ensure you do not overwrite the official Totara Mobile app from your app drawer. In the same way, a unique icon can visually identify your app.
iOS
You can modify iOS icons in this folder: ios/TotaraMobileApp/Images.xcassets.
For application ID, open XCode, in the identity section, change the Bundle Identifier to your app id.
Android
You can modify iOS icons in this folder: android/app/src/main/res/.
For Android application ID, change the default Config.applicationid inside android/app/build.gradle.
TotaraTheme object
TotaraTheme object has the main properties so you can fully customise your app. It can be found in this path: src/totara/theme/Theme.ts
Caching
In order to extend caching, you may check the caching features of Apollo client. Please note that by default, Apollo Client's fetch policy is cache-first.
Default language strings
You should be able to customise your language strings in the Totara Mobile plugin. However, some default language strings are predefined because you will need to show some screens before the user connects to the server. You can find default language strings files in this path: src/totara/locale/languages.