Skip to main content
Themes list in Design Assets with the Name, Default, Edited by and Edited at columns

Key features of theme management

  1. Theme Management:
    • Creation, editing, and management of themes.
    • Selection of predefined themes or customization of themes from scratch.
  2. Customization Options:
    • Modification of color schemes, typography, spacing, and visual effects.
    • Upload of custom assets like fonts and icons.
  3. Overrides and Variations:
    • Ability to override default UI components styles properties on specific elements or sections.
    • Creation of different themes to accommodate different users/clients preferences.
  4. Platform Consistency:
    • Consistency of theme styles across different platforms and devices.
  5. Preview:
    • Real-time visualization of theme changes.
  6. Export/Import Functionality:
    • Export of themes for backup, sharing, or reuse across multiple environments (UAT, DEV, etc.).
    • Import of exported from other environments.

Creating a new theme

You have two options for creating the theme. You can import a theme that was exported from another environment (for example, your UAT/DEV) or to manually create it.
To successfully create a new theme in FlowX.AI Designer, follow these steps:
1

Initiating theme creation

In Design Assets → Themes, click the + button next to the Search by theme name field.
2

Inputting theme details

Enter the details for your theme:
  • Theme Name - pick a name for your theme
  • Font Family - select your desired font family, by default, the system provides “Open Sans”
To add a new font, click here in the hint under Font Family (“Haven’t uploaded your font yet? You can do it here”). This opens Design Assets → Fonts.
  • Choose your primary color - the default color is #006BD8.
The primary color accepts a 6-digit HEX value (for example #006BD8). The field doesn’t accept other characters.
New Theme Setup dialog with the theme name, font family and primary color fields

Configuring a new theme

After creating a theme, you must configure it. To configure your theme effectively, follow these steps:
1

Access theme settings

  • After you click Create, the theme editor opens on the Color Palette section. You can reopen it any time from Design Assets → Themes.
  • Look for options related to styling and think of an overall design
2

Customize theme settings

The Themes styles mechanism is based on hierarchy. In this hierarchy we have the following elements: Tokens (design tokens), Global Settings and Components. These are the three groups in the theme editor’s side menu.
Modify color schemes (using the design tokens), typography, spacing, and other visual elements to match your desired look and feel. Use the provided tools or controls to adjust theme settings. This might include sliders, color pickers, or dropdown menus.
The Design Tokens (shown as Tokens in the theme editor) represent values based on which the theme is built.
  • Color Palette, Shadows, Typography Tokens: Configure these tokens based on your company’s brand guidelines. They ensure reusability and consistency.
Theme editor Color Palette tokens with the primary, secondary, success, warning, error and neutral shades
The Global Settings are properties that inherit values from the Design Tokens and sit on the top of the hierarchy. These properties are then inherited by the Components.
  • Platform-specific Settings: Configure settings for each platform (web, iOS, Android) based on the global settings you’ve defined.
  • Styles and Utilities: General settings applying to all components (styles) and labels, errors, and helper text settings (utilities).
Theme editor Global Settings section with the Styles and Utilities entries
When setting up your theme, remember that different platforms like web, iOS, and Android have their own settings. You need to configure each platform separately. Only color settings are the same across all platforms.
For example, you can configure a web theme, and then use Copy to Android or Copy to iOS in the section’s menu to apply the same configuration to the other platform. Copy from pulls the configuration from another platform.
Component-level Configuration: Customize the style of each component type.
Keep in mind, there are differences between platforms, for example, for button configuration there are different properties available. What you configure on a platform will not be inherited by the others.
The theme includes a configurable Modal component (web only). You can style the modal container (padding, gap, border width, border radius, shadow, background and border colors) and its header (padding, gap, alignment, icon color, title and subtitle text styles and colors, and the dismiss icon).
Theme editor Button component settings with the Web, Android and iOS platform tabs
3

Reviewing the changes (multi-platform)

  • Before finalizing the theme configuration, it’s crucial to review how the changes will appear across different platforms. This step ensures consistency and allows for platform-specific adjustments if needed.
  • You can do that by either using the preview feature from Themes or by using the preview mode in the UI Designer by switching to your preffered platform.
Keep in mind that the preview generated in the UI Designer for iOS and Android platforms is an estimate meant to help you visualize how it might look on a mobile view.

Managing themes - process level (theme overrides)

With the Overrides feature you have now the possibility to override default theme settings on specific elements or sections. Use Theme Overrides in UI Designer to adjust styles or props for specific UI elements based on the desired platform (Web, iOS and Android).
Content and form components can be styled with token overrides for the color, typography and shadow settings defined in the theme. Navigation areas (pages, zones, tabs, steppers and steps), Chat, Breadcrumbs, Task Management, Process Renderer, reusable templates and multi-file upload have no theme overrides.
Theme overrides in UI Designer are applied to the component itself, rather than to specific themes. This means that when switching the view to another theme, the overrides persist and apply to the new theme as well.

Styles tab

The Styles tab functions independently for three platforms: Web, iOS, and Android. Here, you can customize styles for each UI component on each platform. If you want to customize the appearance of a component to differ from the theme settings, you must apply a Theme Override.
Theme Overrides add menu in the UI Designer Styles tab, listing the button states and their properties
Theme overrides can be imported from one platform to another.
Theme Overrides contextual menu with the Copy from and Copy to options for Android and iOS
UI Designer Styles tab for a button with a Default state background theme override added
Preview mode: In the UI Designer, overrides are entirely independent of the theme. Regardless of the theme selected in preview mode, you will see the applied override reflected at the UI Designer level.

Preview

When you are editing a process in UI Designer you have the possibility of having the preview of multiple themes:
Theme selector open in the UI Designer top bar, listing the available themes
Overrides are completely independent of the theme, regardless of which theme you choose in the preview mode.

Using a Theme in the container application

To integrate the theme into your container application, follow these steps:
  • Copy the unique identifier (UUID) associated with the theme.
  • Set the copied UUID within your container application.
  • By doing so, ensure that the renderers within your application can recognize and apply the specified theme.
Theme contextual menu with the Copy UUID option highlighted

Exporting/importing a theme

The Export/Import functionality in the theme management system allows users to export themes for various purposes such as backup, sharing, or reuse across multiple environments. Additionally, it enables importing themes previously exported from other environments, facilitating integration and continuity across design workflows.
Import is restricted to internal FlowX.AI mechanisms only; themes from external sources like Figma or Zeplin are not supported.

Exporting a theme

1
Navigate to Design Assets → Themes.
2
Find the theme you want to export.
3
Open the theme’s contextual menu and select Export.
4
The exported theme is saved in a standard format (JSON) and can be downloaded to a local directory or storage location.
Theme contextual menu with the Export option highlighted

Importing a theme

1
Navigate to Design Assets → Themes.
2
From the contextual menu at the top of the page, select Import from ZIP.
3
If a theme with the same ID already exists in this environment, choose Override to replace it or Create new to import it as a new theme. If only the name matches an existing theme, change the name to continue.
Contextual menu at the top of the Themes page with the Import from ZIP option

Setting a default theme

You can establish a default theme by accessing the contextual menu on the right side of a theme and selecting “Set as Default.”
Theme contextual menu with the Set as Default option highlighted
When a default theme is not set (or you haven’t created a theme yet), the platform automatically assigns the built-in FlowXTheme system theme. FlowXTheme isn’t listed on the Themes page. This ensures that there’s always a default theme in place to provide a consistent appearance across processes and interactions within the app.
In case you select a specific default theme but later you delete it, the platform will revert to FlowXTheme as the default. This safeguard ensures that there’s always a default theme available, even if you remove your custom selection.
Theme contextual menu with the Set as Default, Duplicate, Copy UUID, Export and Delete options
When you open a process in the UI Designer, the preview uses the Project Theme set in the project’s Version Settings. Projects created in the Designer start with FlowXTheme as their project theme, so change Project Theme to preview your own theme by default.
UI Designer opened on a process with FlowXTheme selected as the preview theme
Because new projects start with FlowXTheme, it is also the theme preselected when you start a process from the project’s process list.
Start Process dialog with the Theme field set to FlowXTheme
When you start a process from the project’s process list, the Theme field defaults to the project’s theme, or to the theme you last picked in this session. When you start it from the builds list, it defaults to the theme set as default on the Themes page, or FlowXTheme if none is set.
Last modified on November 12, 2026