In this section · 4 articles

Change the app's theme, remote settings and feature flags

Add or change a theme and choose the default, add a remote configuration value the app reads, and switch a feature on or off with a feature flag, all without a new app release.

Applies to
Core Mobile 2.0 and later
Who can do this
Platform owner, Developer
Permission
feature.cm.remote_config.edit
Where
Core Mobile › Themes, Remote Configuration or Feature Flags (Platform Administration)
On this page

These three screens hold values your app reads by name. Agree the names with whoever builds the app first: a theme token, configuration key or flag the app doesn't know about does nothing.

Before you start

  • For themes, you need Create Theme or Edit Theme (feature.cm.theme.create, feature.cm.theme.edit).
  • For remote configuration and feature flags, you need Create Remote Config or Edit Remote Config (feature.cm.remote_config.create, feature.cm.remote_config.edit). The same permissions cover both screens.

Change a theme

A theme is one look for the app: its colors, type and shapes. The app's start-up settings include one theme: the active theme marked Default. The app can ask separately for every active theme, for example to offer a dark one.

  1. In the Platform Administration sidebar, select Core Mobile › Themes. Each row shows the theme's Palette as color dots.

    The Core Mobile Themes list showing 14 themes, each with its Variant, Palette color dots, Default and Status; one theme, Ambrovale Light, is marked Default.
  2. Select Create, or open a theme's actions menu and select Edit.

  3. Fill in:

    • Name: up to 100 characters.
    • Variant: Light, Dark, High Contrast or Custom.
    • Season (optional): for a theme you use at a time of year, such as diwali.
    • Sort Order: the order the app lists themes in.
  4. Turn on Default to make it the theme the app starts with. Only one theme can be the default: turning it on here turns it off on the others.

  5. Leave Status on. An inactive theme isn't sent at all.

  6. Under Design Tokens (JSON), set the colors. Each row is a Key path, a Type and a Value: for example, primary, Colour and #1d4ed8. Select Add row for more. The key paths offered include primary, secondary, background, surface, text and danger.

  7. Optional: set Typography (JSON), such as font_family or font_sizes.md, and UI (JSON), such as radius.md or spacing.sm, the same way. Select Show preview to see the result.

  8. Select Save.

The Create Themes drawer for Corporate Navy, Variant Light, with Default and Status on and three Design Tokens rows for primary, secondary and background, with the Live JSON and Visual tree preview open.

You see, for example, 'Theme "Corporate Navy" saved.'

Tip: A theme row is one variant, not a light and dark pair. For a dark mode, make a second theme with Variant Dark and the same Season, and let the app pair them.

Add a remote configuration value

A remote configuration value is a setting the app reads by its key, such as how many items to load or a promotion's text.

  1. Select Core Mobile › Remote Configuration.

  2. Select Create.

  3. In Key, enter the name the app looks for, such as max_upload_size. Use letters, digits, dots, dashes and underscores, up to 150 characters.

  4. Choose the Type: String, Integer, Boolean or JSON.

  5. Enter the Value. The box changes with the type: a switch for Boolean, key path rows for JSON.

    The Create Remote Configuration drawer with Key max_upload_size, Type Integer, Value 20, Group uploads, a description of the upload limit in MB, and Status turned on.
  6. Optional: add a Group, such as uploads, to keep related keys together, and a Description for your team.

  7. Leave Status on.

  8. Select Save.

You see, for example, 'Remote config "max_upload_size" saved.' The app receives the value with its type: 20, not "20".

Switch a feature on or off

A feature flag is an on or off switch the app reads by its key.

  1. Select Core Mobile › Feature Flags.

  2. Select Create, or open a flag's actions menu and select Edit.

  3. In Key, enter the name the app looks for, such as enable_wallet.

  4. Turn Enabled on or off.

    The Create Feature Flags drawer with Key enable_wallet, the Enabled switch off, an empty Description, and the Rollout (JSON) and Conditions (JSON) builders below.
  5. Optional: add a Description.

  6. Select Save.

Every flag is sent to every app, as on or off. Rollout (JSON) and Conditions (JSON) are saved but not used: Core Mobile 2.1.0 doesn't roll a flag out to some people only. To show something to some people, use an audience on an onboarding flow, menu item or dashboard instead. See Show content to an audience.

What happens next

The app gets the change the next time it asks for its settings, usually when it next starts.

Switching a remote configuration value's Status off, or deleting a value or a flag, leaves it out of the app's settings. The app then uses its own built-in default, which may not be what you expect. To turn a feature off, set the flag's Enabled to off instead of deleting it.

If the app doesn't change, see The app doesn't show your changes.