Skip to main content

Purpose

The FlowX.AI UI Designer is the visual editor for building user interfaces in FlowX.AI. You add, arrange, and configure UI components on a canvas, then adjust their properties and styles for Web, iOS, and Android. The same editor builds the screens of process user tasks, UI Flows, and reusable UI templates.

Key capabilities

Multi-Platform Support

Create interfaces with platform-specific configuration and styling across Web, iOS, and Android

Visual Interface Design

Use a drag-and-drop environment to design diverse UI templates with various elements and components

Real-Time Preview

Preview your designs across different platforms and themes with live feedback

Component Library

Access ready-to-use UI components including form elements, containers, and specialized components
In a BPMN process, the UI Designer is available for User Task nodes and Navigation Areas.

UI Designer interface

The UI Designer provides a comprehensive interface for creating and configuring user interfaces within your FlowX.AI processes.

Platform selection

The UI Designer supports multi-platform design with dedicated configuration tabs:
Full Feature Support: Complete UI Designer functionality with all component types and navigation features
  • All UI component types supported
  • Full navigation area capabilities
  • Zones with headers and footers
  • Single page and wizard navigation types

Configuration panels

The UI Designer interface consists of configuration sections for comprehensive component setup:
Generic Configuration: Properties available cross-platform (Web, Android and iOS)Platform-Specific Settings: Override generic properties for specific platforms
  • Property overrides (Title, Subtitle, Helper text)
  • Expression overrides (Hide conditions)
  • Copy overrides between platforms (Copy from <platform>, Copy to <platform>)
Theme Integration: Components inherit styling from the active theme by defaultTheme Overrides: Customize component appearance beyond theme settings
  • Platform-specific styling
  • Conditional styling (for Text, Link, Image, Container, Card, Form, Collection and Collection prototype elements)
  • Copy theme overrides between platforms (Copy from <platform>, Copy to <platform>)
Multi-Platform Preview: Switch between platforms to preview designs
  • Real-time platform switching
  • Theme selection for preview
  • Visual estimation for mobile platforms
iOS and Android previews are estimates to help visualize mobile views.

UI components available

The FlowX.AI platform offers a variety of ready-to-use UI components. The groupings below follow the navigation order:
Layout foundation elements, the framework for arranging everything else:
Data collection components, for capturing user input:
Interactive and display components:
Conversational and formatted content:
  • Chat: Interactive AI agent conversations, with sub-components for the header, history, messages, input, suggested prompts and file attachments
  • Markdown: Renders Markdown-formatted content on a screen
  • Separator: Visual divider for grouping content
  • Progress bar: Visualizes progress or completion state
  • Tooltip: Shows extra context on hover or focus
Dynamic content components, for repeated content and dynamic data:

Component configuration

After adding a UI component, the right-side menu displays configuration options:
  • Settings Tab: Configure component properties and behavior
  • Styles Tab: Customize appearance and apply theme overrides
  • Platform Overrides: Adapt components for specific platforms
Navigation areas can be configured through the UI Designer, providing:
  • Hierarchical navigation structure
  • Platform-specific navigation capabilities
  • Copy/paste functionality for consistency across platforms

Using the UI designer

To open the UI Designer for a process:
1

Open the process

In your project, go to Processes and select the process you want to design.
2

Switch to the UI Designer

Select the UI Designer (brush) icon in the left rail.
3

Pick a navigation area or user task

In the Navigation section of the left panel, select the navigation area or user task to design. User tasks that are not assigned to a navigation area are listed under Not Allocated. For details, see Navigator in the left panel.
Process UI Designer with the brush icon selected in the left rail, a user task selected in the Navigation section of the left panel, its form on the canvas, and the Desktop platform, language and theme selectors in the toolbar
UI Flows and reusable UI templates open in the same editor: open the UI Flow or template from your project to design it.
Productivity Features:
  • Undo/Redo: Available within the UI Designer for actions such as dragging, dropping, or deleting elements
  • Keyboard Shortcuts: Use keyboard commands for quick access to undo/redo functionality
  • Drag and Drop: Support for dragging and dropping elements in the preview section
  • Settings Panel: Right-side menu displays configuration options after adding components

Comprehensive design guides

Master the UI Designer with our detailed guides covering every aspect of interface creation:

Screen Configuration Guide

How to Approach Screen ConfigurationLearn the systematic methodology for creating effective user interfaces:
  • User journey definition and analysis
  • Navigation pattern selection
  • Information architecture planning
  • Layout strategy implementation
  • Platform-specific adaptations
  • Validation and testing approaches

Best Practices

UI Designer Best PracticesEssential guidelines for creating accessible, performant interfaces:
  • User-centered design principles
  • Information architecture standards
  • Component usage excellence
  • Accessibility compliance (WCAG 2.1)
  • Testing and quality assurance
  • Maintenance strategies

Platform Considerations

Platform-Specific GuidelinesComprehensive platform optimization and limitation reference:
  • Web, iOS, and Android design patterns
  • Performance optimization strategies
  • Platform-specific constraints and workarounds
  • Security and privacy considerations
  • Cross-platform testing protocols

UI components

When you select a UI component, the right panel shows its configuration in two tabs, Settings and Styles. For the full component list, see UI components available. The sections below use a card element, which is a root component, as the example.

Settings tab

Settings tab of a selected Card, with the Properties section (Title, Subtitle, Has accordion), the Expressions, Permissions and Advanced sections, and the Web overrides section with its menu and add buttons

Settings for all platforms

The Settings tab holds the configuration shared by Web, iOS, and Android: the component’s Properties, its Expressions (hide and disable conditions), Permissions, and Advanced settings. Form elements add sections such as Datasource, Validators, and Event handlers.

Platform-specific settings

Override a property or an expression for one platform only. For example, on Android you might want a shorter Card title.
1

Select the component

In the UI Designer, select a UI element, such as a Card.
2

Pick the platform

Use the platform selector in the toolbar (Desktop, Mobile iOS, or Mobile Android). The Settings tab shows an overrides section for the selected platform, such as Web overrides for Desktop.
3

Add the override

Select + next to the overrides section, then choose Properties to override a property or Expressions to add a hide condition for this platform only. Enter the value for this platform.
Add menu of the Web overrides section, listing Properties and Expressions
4

Preview your changes

Switch platforms in the platform selector to compare the result on each platform.
To reuse overrides on another platform, open the menu (â‹®) next to the overrides section and select Copy from Android, Copy from iOS, Copy to Android, or Copy to iOS.
Menu of the Web overrides section with the Copy from Android, Copy from iOS, Copy to Android and Copy to iOS options
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.

Hide and disabled conditions

Components can be hidden or turned read-only at runtime based on a JavaScript condition. Both are expressions in the Expressions section of a component’s Settings panel:
1
Select a UI component in the UI Designer, then open Settings -> Expressions.
2
Select Add new (+). In the popover, pick a Type (Hide or Disable) and write your JavaScript condition in Expression. Select Open in editor for a larger editor.
3
The expression is saved as a card named Hide condition or Disable condition. Select a card to edit its condition, or use its delete button to remove it. Each type can be added once per component.
Availability depends on the component. Most form fields support both, along with Form, Button, the file upload and download components, and the chat input. A hide condition is available on a wider set, including containers, cards, tables, text and images. Setting a condition for one platform only To hide an element on a specific platform rather than everywhere, add a hide expression as a platform override: pick the platform in the toolbar, select + next to the platform’s overrides section in Settings, and choose Expressions. Platform overrides offer only Hide; set a Disable condition in the component’s Expressions section. A component whose expression is overridden on some platforms shows an info marker naming them.
Expressions section of a selected Text Area with a Hide condition card showing its JavaScript condition

Permission-based expressions

Control UI element visibility and interaction based on user roles and process data.

Permission-based expressions

Complete guide to configuring role-based UI permissions, cross-swimlane references, and collaborative workflows
Quick configuration
1

Enable multiple executors

In process settings, enable Allow multiple executors for your swimlane.
2

Select component

In UI Designer, select the component to configure.
3

Add condition

Expand Permissions section and click + to add hide or disable conditions.
4

Configure parameters

Set Type (USERNAME/ROLE), Operator (IN/NOT_IN), Value Type, and Value.
Use CONFIGURATION_SWIMLANE_ROLE for swimlane roles and PROCESS_DATA for dynamic values. SWIMLANE_OWNER requires no value.

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.
Styles tab of a selected Card with the Layout, Sizing and Spacing sections
To make a component look different from the theme settings, apply a Theme override: in the Styles tab, go to Advanced, select + next to Theme overrides, and pick the properties to override.
Add menu of the Theme overrides section in the Styles tab, showing Common properties
Theme overrides can be copied from one platform to another: open the menu (â‹®) next to Theme overrides and select Copy from or Copy to another platform.
Menu of the Theme overrides section with the Copy from Android, Copy from iOS, Copy to Android and Copy to iOS options

Theme Management

Copy/paste styles

The Copy / Paste Styles entry in the component’s contextual menu groups these actions:
  • Copy Styles: Copy styling properties between compatible components
  • Paste Styles: Apply copied styles to selected components
  • Cross Platforms Actions: Copy from or Copy to another platform to share styles across Web, iOS, and Android
  • Multiple selection: Apply styles to multiple components simultaneously
Compatible component groups for style copying:
  • Input-like: Input, Select, Datepicker, Textarea, Multiselect
  • Selection: Radio, Checkbox
  • Container: Container, Form, Card, Collection, Collection Prototype
  • Action: Button, File Upload
UI Designer with a Form selected on the Styles tab and the More menu open, listing Copy Styles, Paste Styles, and the Cross Platforms Actions Copy from iOS, Copy from Android, Copy to iOS, and Copy to Android

Preview

The canvas previews your screen on the platform and with the theme selected in the toolbar. Use the platform selector (Desktop, Mobile iOS, Mobile Android) and the theme selector, which has a search box, to switch the preview.
Theme selector open in the UI Designer toolbar, with a search box and the FlowXTheme theme
Overrides are completely independent of the theme, regardless of which theme you choose in the preview mode.

Layout

There are two main types of layouts for organizing child elements: Linear and Grid.
  • Linear Layout: Arranges child elements in a single line, either horizontally or vertically. Ideal for simple, sequential content flow.
  • Grid Layout: Organizes elements into a structured grid with multiple columns and rows, useful for more complex, multi-dimensional designs.
  • Platform-Specific Layouts: You can customize layout settings per platform (e.g., Grid on web, Linear on mobile) to ensure optimal responsiveness.
Both layouts offer options to customize direction, alignment, spacing, and wrap behavior for flexibility in design.
Layout section of the Styles tab with Display, Direction, Justify, Align, Wrap and Gap settings

Layout

Sizing

By setting desired values for these props, you can ensure that all UI elements on the interface are the desired size and perfectly fit with each other. When adjusting the Fit W and Fit H settings, you can control the size and shape of the elements as they appear on your screen:
  • Fit W: fill, fixed or auto
  • Fit H: fixed or auto. The Chat component in Fill display type offers fixed or fill instead.
UI element sizing options

Spacing

Margin and padding are CSS properties used to create space between elements in a web page:
  • margin - the space outside an element
  • padding - the space inside an element
Spacing section of the Styles tab with margin and padding values for each side

Margin

Padding

Advanced

  • Advanced - for advanced customization, you can add CSS classes to pre-defined components, this option is available under the Advanced section
  • Data test ID - add custom test identifiers for automated testing and element interaction. This field is in the Settings tab under Advanced, not in the styling options
By utilizing these styling options in FlowX.AI, you can create unique and visually appealing interfaces that meet your design requirements.

Data Test ID

The Advanced section of the Settings tab includes a Data test ID field, allowing you to assign custom identifiers to UI components. This feature enhances automated testing by providing meaningful, easily identifiable selectors for UI elements. Key benefits:
  • Replace auto-generated test IDs with custom, readable identifiers
  • Simplify element targeting in test scripts
Data test ID field in the component settings

Tree view

The Tree View panel displays the component hierarchy, allowing you to navigate through the different levels of the interface. Clicking on a specific component in the tree will highlight the selection in the editor, helping you locate and modify it.
UI Designer component tree
Process UI Designer left panel on the Navigation tab, with a navigation root expanded to its user task and a Not Allocated group listing unassigned user tasks, above the selected user task's components section
In the process UI Designer, the component tree is replaced by a two-part navigator on the Navigation tab of the left panel, the same layout UI Flows use. The UI Designer opens on this tab. The navigation area selector that sat next to the platform selector in the UI Designer header is removed: you pick the navigation area in the navigator instead. The top section, Navigation, lists the navigation roots of the process for the selected platform. User tasks that are not assigned to any navigation area appear under a Not Allocated heading.
  • Select a navigation root to open it. The open root expands to show its nested navigation areas, user tasks, and embedded subprocesses.
  • On an embedded subprocess row, select Open Subprocess to open that subprocess.
  • Use the view toggle (Switch to dropdown view / Switch to list view) to collapse the list into a searchable Select a root dropdown.
  • When the process allows read-only mode, a filter button offers Filter Nodes by → Visible in Read-Only Mode or View All. With Visible in Read-Only Mode selected, entries that are not visible in read-only mode are dimmed and marked with a crossed-out eye icon.

Components section

The bottom section, <name> Components, is named after the current selection, such as a navigation area or user task, and shows its UI component tree. Use Add UI Component to add components and Collapse All to fold the tree. A user task holds a single root component, so the add button is turned off once the root exists. When there is nothing to show, the section explains why: When a user task, UI Flow, or reusable UI template has no components yet, the canvas shows the same UI Designer empty state in all three, with a shortcut to add the first component or generate the layout with AI, depending on your permissions. In the reusable UI template designer, the navigator shows only the components section, labeled UI Components, where you add the template’s single root component.

Copy and paste UI components

Right-click a component and select Copy (⌘C on macOS, Ctrl+C elsewhere) to copy it, together with its child components. Then select the parent component you want to paste into, right-click it, and select Paste (⌘V / Ctrl+V). Paste is available only when a single parent is selected.

Paste review and cross-context paste

Review paste modal with a struck-through component and its tooltip explaining why it cannot be pasted, the 2 components will be pasted summary, and the Paste 2 components button
You can paste copied UI components into a different context: from a user task into a UI Flow, from a UI Flow into a reusable UI template, and so on. Copy and paste share one clipboard format across user tasks, UI Flows, and reusable UI templates. When everything in the clipboard fits the target, the paste happens straight away. When something does not fit, nothing is pasted yet and a Review paste modal opens instead:
  • The modal shows the copied component hierarchy. Components that cannot be placed are struck through. Hover over one to see why, and whether its child components are dropped with it or reviewed on their own.
  • Top-level components carry a checkbox, so you can leave out more components before pasting.
  • The summary reads N components will be pasted. Select Paste N components to go ahead or Cancel to stop.
  • When nothing in the selection can be pasted, the modal is titled Paste blocked and offers only Close.
Common reasons a component is dropped: Pasted components are also fitted to where they land:
  • Unique identifiers: a pasted component keeps its Component Identifier when no other component on the target screen uses it. Otherwise it gets a new generated identifier for its type, such as Button02, that no other component on the screen holds.
  • Data model: pasted components point to the data model of the target screen.
  • Unsupported properties: properties the target cannot use are removed or adjusted in the pasted copy.
If the copied content was made with an earlier clipboard format, for example before a platform update, the paste is refused with The copied content is no longer valid. Copy it again and retry. A component also cannot be pasted into one of its own child components.
Last modified on November 13, 2026