> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Themes

> Theme management enables you to change the appearance and styling of your app. Personalize the look and feel to match your branding, preferences, or specific requirements.

![Themes list in Design Assets with the Name, Default, Edited by and Edited at columns](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-list.png)

## 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

> [!NOTE]
>
> 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"

> [!TIP]
>
> 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`.

> [!TIP]
>
> The primary color accepts a 6-digit or 8-digit HEX value (for example `#006BD8` or `#006BD880` for a translucent color), or an `rgb()` or `rgba()` value. When you leave the field or press **Enter**, the value is converted to uppercase HEX. An invalid value doesn't show an error: the field goes back to the last valid color.

![New Theme Setup dialog with the theme name, font family and primary color fields](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-create-dialog.png)

## 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**

> [!NOTE]
>
> 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.

> [accordion] Design Tokens
>
> > [!NOTE]
> >
> > **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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-design-tokens.png)

> [accordion] Global Settings
>
> > [!NOTE]
> >
> > 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-global-settings.png)

> [accordion] Component-level configuration
>
> > [!NOTE]
> >
> > 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.
>
> > [!TIP]
> >
> > 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.
>
> > [!NOTE]
> >
> > 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.
>
> > [!NOTE]
> >
> > 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-component-button.png)

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

> [!WARNING]
>
> 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).

> [!NOTE]
>
> 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.

> [!NOTE]
>
> **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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-override-add-menu.png)

> [!NOTE]
>
> 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-override-platform-menu.png)

![UI Designer Styles tab for a button with a Default state background theme override added](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-override-added.png)

> [!NOTE]
>
> 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-ui-designer-theme-select.png)

> [!NOTE]
>
> 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-copy-uuid.png)

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

> [!WARNING]
>
> Import is restricted to internal FlowX.AI mechanisms only; themes from external sources like Figma or Zeplin are not supported.

### Exporting a theme

**Step 1**

Navigate to **Design Assets** → **Themes**.

**Step 2**

Find the theme you want to export.

**Step 3**

Open the theme's contextual menu and select **Export**.

**Step 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-export.png)

### Importing a theme

**Step 1**

Navigate to **Design Assets** → **Themes**.

**Step 2**

From the contextual menu at the top of the page, select **Import from ZIP**.

**Step 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-import-menu.png)

### 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-set-default.png)

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.

> [!NOTE]
>
> 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-row-menu.png)

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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-ui-designer-default-theme.png)

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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/themes-start-process-theme.png)

> [!NOTE]
>
> 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.


## Related topics

- [Permission reference guide](https://docs.flowx.ai/6.x/setup-guides/access-management/permission-reference-guide.md)
- [iOS SDK](https://docs.flowx.ai/6.x/sdks/ios-renderer.md)
- [Workspaces](https://docs.flowx.ai/6.x/docs/projects/workspaces.md)
- [Separator](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-component-types/separator.md)
- [Projects](https://docs.flowx.ai/6.x/docs/projects/managing-applications/application.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.