Applying multiple themes

Add multi-theme support to your app

Getting started

Before diving further into this guide, you should be familiar with these two procedures:

Global Branding

Applying a theme on iOS

Note: If you’d like to know how to apply multiple themes on iOS on a release version prior to 2024.09, read our guidelines in our old documentation site.

Preparing the theme

Extract the theme variant from Figma and place the themes' JSON file in your Xcode project. Make sure that the JSON file is included in your Copy Bundle Resources build phase.

Switching themes

Step 1

Install latest version of the Design System

First, you will need to have your BackbaseDesignSystem CocoaPod at minimum version 5.3.0.

Step 2

Using the theme switch functionality

In your code where appropriate you can import BackbaseDesignSystem and use the static function Theme.switchTo("<FILENAME>") where the filename is the exported JSON filename.

Step 3

Reapplying themes in UIKit

You will need your view controller stack to be recreated for the theme to take effect as colors in UIKit do not update automatically. The easiest way is by recreating the view controller that is assigned to your app delegates window.rootViewController. A simple approach to doing this within a Backbase context would be to logout the user and log back in, or apply the theme when the root view controller is about to change.

You can refer to our golden sample app for an example of how this can be done.