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 Designer, follow these steps:

1

Initiating theme creation

Locate the “Create New” button positioned above the right of the Themes list table.

2

Inputting theme details

Click the “Create New” button and enter 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”

If you wish to add a new font, click on the link provided under the Font Family field, which redirects you to the Fonts management Selection.

  • Choose your primary color - the default color is #006BD8.

Verify that the color format is in HEX. If not, an error message will indicate “Please insert a HEX color.”

Configuring a new theme

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

1

Access theme settings

  • Navigate to the settings or customization section of your application (in the UI Designer).
  • 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: Design Tokens, Global Settings and Components.

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.

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.

Here is a quick walkthrough video on how to create and configure a theme:

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).

All components can now be styled with token overrides, for color, typography and shadow settings defined in the theme.

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 can be imported from one platform to another.

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:

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.

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 the seamless import of themes previously exported from other environments, facilitating swift integration and continuity across design workflows.

Import is restricted to internal FlowX mechanisms only; themes from external sources like Figma or Zeplin are not supported.

Exporting a theme

1

Navigate to the Theme Management panel within FlowX Designer.

2

Select the theme(s) you wish to export.

3

From the breadcrumbs menu on the right, select Export Theme.

4

The exported theme is saved in a standard format (JSON) and can be downloaded to a local directory or storage location.

Importing a theme

1

Navigate to the Theme Management panel within FlowX Designer.

2

From the contextual menu on the right, select Import Theme.

3

Import it as a new theme or if the theme already exists in other environment, you can override it.

Setting a default theme

You can easily establish a default theme by accessing the contextual menu on the right side of a theme and selecting “Set as Default.”

When a default theme is not set (or you haven’t created a theme yet), the platform automatically assigns the FlowXTheme, which is the platform’s default theme. This ensures that there’s always a default theme in place to provide a consistent appearance across processes and interactions within the application.

In case you select a specific default theme but later you delete it, the platform will revert to the FlowX theme as the default. This safeguard ensures that there’s always a default theme available, even if you remove your custom selection.

Upon opening any process within the UI Designer, the default theme is displayed as the initial preview. This gives users a clear starting point and ensures consistency in the appearance of the process until further customization is applied.

When creating a new process, you will notice the Default Theme (FlowXTheme) as the default preview.

Furthermore, when you start a process definition, the theme switch defaults to the default theme in the run process popup from the process definitions list. This ensures that the default theme is consistently applied during the execution of processes, maintaining visual coherence in user interactions.