Theme management
Theme management feature enables you to easily change the appearance and styling of your application. You can personalize the look and feel of your application to your branding, preferences, or specific requirements.
Key Features of Theme Management
-
Theme Management:
- Creation, editing, and management of themes.
- Selection of predefined themes or customization of themes from scratch.
-
Customization Options:
- Modification of color schemes, typography, spacing, and visual effects.
- Upload of custom assets like fonts and icons.
-
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.
-
Platform Consistency:
- Consistency of theme styles across different platforms and devices.
-
Preview:
- Real-time visualization of theme changes.
-
Export/Import Functionality:
- Export of themes for backup, sharing, or reuse across multiple environments (UAT, DEV, etc.).
- Import of exported themes 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:
Initiating theme creation
Locate the “Create New” button positioned above the right of the Themes list table.
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:
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
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.
Design Tokens
Design Tokens
The Design Tokens 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.
Global Settings
Global Settings
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).
Component-level configuration
Component-level configuration
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 leverage the push and import options. You can push from the web the same configuration to iOS or Android.
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.
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
Navigate to the Theme Management panel within FlowX Designer.
Select the theme(s) you wish to export.
From the breadcrumbs menu on the right, select Export Theme.
The exported theme is saved in a standard format (JSON) and can be downloaded to a local directory or storage location.
Importing a theme
Navigate to the Theme Management panel within FlowX Designer.
From the contextual menu on the right, select Import Theme.
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.