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

# FlowX.AI 4.0.0 Release Notes

> 🎉 Welcome to the much-anticipated FlowX.AI 4.0 release! 🚀 Get ready to experience a whole new level of innovation and efficiency with FlowX.AI 4.0.

<Info>
  **Release Date:** 18th April 2024
</Info>

<Frame>
  <video controls className="w-full aspect-video" src="https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/release4.0_fix.mp4" />
</Frame>

In this exhilarating update, we've added a bunch of cool stuff. From a **new theming feature** to a complete overhaul of **navigation**, killing the **milestones nodes** (we know you hated them), brace yourself for a transformative journey through the latest features and enhancements...and also a surprise for you, awaiting at the [**bottom of the page**](#coming-soon)!

## Bonus: meme of the day

Start with a laugh, because it will be a lot to read!

<Frame>
  <a href="https://imgflip.com/i/8jnc06">
    <img src="https://i.imgflip.com/8jnc06.jpg" title="made at imgflip.com" />
  </a>

  <div>
    <a href="https://imgflip.com/memegenerator" />
  </div>
</Frame>

Let's dive in and explore the exhilarating additions:

## **What's New?** 🆕

### Theme Management

The new **Theme Management** feature enhances our design process by establishing a unified visual language across various platforms.

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/themes_management.png)
</Frame>

This approach simplifies development by enabling the establishment of a foundational **theme**, which can then be customized to accommodate specific platform requirements.

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/theming_overview.gif)
</Frame>

Ultimately, this streamlines the development process, saving significant time and effort.

<AccordionGroup>
  <Accordion title="Design Tokens" icon="pen-ruler">
    * **Design Tokens**: Represent the single source of truth for the theme, storing visual elements of the design system.
    * **Color Palette, Shadows, Typography Tokens**: Configure these tokens based on your company's brand guidelines. They ensure reusability and consistency.

    ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/design_tokens_theme.gif)
  </Accordion>

  <Accordion title="Global Settings" icon="gears">
    * **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).

    <Frame>
      ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/global_settings_theme.gif)
    </Frame>
  </Accordion>

  <Accordion title="Component-level configuration" icon="hammer">
    **Component-level Configuration**: Customize the style of each component type.

    <Frame>
      ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/platform-components.gif)
    </Frame>
  </Accordion>
</AccordionGroup>

#### Universal Styling

Introduced the option for platform-specific theming customization for components across Web, iOS, and Android.

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/theming_across_platforms.gif)
</Frame>

More information about Theming:

<Card title="Themes" href="/4.0/docs/platform-deep-dive/core-extensions/content-management/themes" icon="pen-line" />

### Navigation areas (removed Milestones nodes)

<CardGroup>
  <Card>
    <Frame>
      ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/3.5/start-milestone.png)
    </Frame>
  </Card>

  <Card>
    <Frame>
      ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/3.5/end-milestone.png)
    </Frame>
  </Card>
</CardGroup>

In this release, we've bid farewell to **Milestone Nodes**, ushering in a fresh and improved approach to organizing the user interface. Say hello to a sleeker and more efficient system with the introduction of [**Navigation areas**](../../4.0/docs/building-blocks/process/navigation-areas).

<Info>
  For process definitions originating from releases earlier than **4.0**, Milestone nodes will evolve into [**Zones**](../../4.0/docs/building-blocks/process/navigation-areas#zone) during migration, offering enhanced navigation capabilities.
</Info>

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/nav_ares.gif)
</Frame>

### New navigation UI elements

* Tab Bar & Tabs
* Zones
* Parent Process Area

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/navigation_areas_preview.png)
</Frame>

#### Navigation areas per platform

<Card title="Navigation Areas" href="/4.0/docs/building-blocks/process/navigation-areas" icon="link" />

### UI Designer (enhancements)

* New enhanced UI designer, offering flexibility and control over your application's look and feel across all platforms.
* Added the possibility to customize the **navigation areas** through the **UI Designer**

#### UI Designer - universal configuration and styling

Introduced the option for platform-specific configuration and styling for components across Web, iOS, and Android.

<CardGroup>
  <Card>
    ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/uI_designer_panel1.png)
  </Card>

  <Card>
    ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/ui_designer_panel2.png)
  </Card>
</CardGroup>

The new navigation panel in the UI Designer allows you to manage navigation configurations efficiently across different platforms, ensuring consistency and clarity in your interface design.

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/ui_ui_designer.gif)

### New node - Embedded subprocess

Introducing Embedded Subprocesses! Enhance your process management with the new embedd subprocess functionality and the new **Start Embedded Subprocess** node.

<Frame>
  <img src="https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/start_embedded_subprocess.png" style={{ maxHeight: '60px' }} />
</Frame>

Seamlessly integrate self-contained subprocesses within parent processes for enhanced functionality and encapsulated operations. The Start Embedded Subprocess node enables the initiation of subprocesses within a parent process, offering a range of features and options for enhanced functionality.

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/embedded_example_copy.png)
</Frame>

<Card title="Embedded subprocess node" href="/4.0/docs/building-blocks/node/call-subprocess-tasks/start-embedded-subprocess" icon="link" />

### New nodes - Error Events

We are excited to introduce support for a new type of node in BPMN 2.0, specifically Error Events: Error Intermediate boundary event, which expand the capabilities of process modeling and error handling within your BPMN diagrams.

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/3.5/error_event.png)
</Frame>

These Error Event nodes enhance the BPMN standard and offer improved control over error management.

<Card title="Error events" href="/4.0/docs/building-blocks/node/error-events" icon="link" />

### Nodes Redesign: Redefining Connectivity

Experience a redesigned interface for smoother interaction with **nodes** and **Process Designer**.

<Frame>
  ![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/nodes_redesign.png)
</Frame>

### Favorites Tab

Keep track of your favorite process definitions and streamline process development with the all-new **Favorites tab**, ensuring effortless collaboration among teams.

<Frame>
  <img src="https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/favorites_tab.png" style={{ maxHeight: '500px' }} />
</Frame>

## **Changes**  🔧

<Info>
  For clients upgrading from an older release (v3.x), we recommend consulting our [**Migrating from v3.x**](./migrating-from-v3.4.x/) guide for comprehensive migration instructions.
</Info>

Here's a summary of the changes introduced in version 4.0 after upgrading from v3.4.x for all microservices:

* **AuthToken Management**: The ui-sdk no longer relies on the authToken being stored in LOCAL\_STORAGE. Read more, [**here**](/4.0/sdks/angular-renderer#authorization).
* The **Subprocess Run** node is now called **Call activity** node.
* The **Start subprocess** action is now available only on [User Task](../building-blocks/node/user-task-node) nodes. For any other node types, you should use the [Call Activity node](../building-blocks/node/call-subprocess-tasks/call-activity-node) instead.
* Business Rules: Enhancements for structured data management and improved attribute access via `instanceMetadata` new object. Read more, [**here**](./migrating-from-v3.4.x/process-configuration#business-rules).
* **Timer event scheduler**: Significant optimizations have been implemented in the timer event scheduler, resulting in improved efficiency and responsiveness.
* **UI Designer** updates and improvements.
* UI components style and props changes - consult the [**UI components change log**](./ui-components-changelog) for more information.
* Revised cache key organization. Read more [**here**](./migrating-from-v3.4.x/migrating-from-v3.4.x#revised-cache-key-organization).
* New environment variables to prevent log flooding. Read more, [**here**](./migrating-from-v3.4.x/migrating-from-v3.4.x#logging).
* Java 17 integration: Integrated Java 17 (all backend services - base image: `eclipse-temurin - 17.0.10_7-jre-jammy`) as default buildpack.

<Check>
  Do not to forget to consult the [**migration guide**](./migrating-from-v3.4.x/) for more information.
</Check>

### Admin - health monitoring

Improved health monitoring:

* Enabled role-based acccess control and added annotations to enable platform health by default.
* Established default annotations for platform health status.
* Adjusted liveness and readiness probes for improved reliability and responsiveness.
* Updated Prometheus scraping configuration for metric collection.

## **Bug Fixes** 🛠️

We've also squashed pesky bugs to ensure a smoother and more reliable experience across the board.

### Scheduler

* Tokens now leave the timer node promptly, no longer lingering like last-minute shoppers before closing time!
* Subprocesses can now rest easy knowing they won't trigger "Timer expression is not valid" errors when setting process expiry time in months—our code's time management just got a promotion!

### UI Designer

* Switch element label now obeys orders to move to the end—no more rebellious labels sticking to the start!

### Process Designer

* Small laptops users rejoice! Now you can scroll to see all subprocesses and audit logs without losing the last line—no more screen envy for external monitors!
* Start Subprocess Action now consistently saves selected version inputs and allows for multiple edits without page refreshes—no more need for extra clicks or browser gymnastics!
* Nodes now stay within swimlane borders when moved, preventing them from wandering off like lost sheep—no more unexpected node relocations disrupting your process layouts!

### FlowX Engine

* MVEL parser now (with the latest MVEL version update: 2.5.2) happily accepts arrays/lists after objects, eliminating JSON file frustrations and improving developer workflow—no more cryptic error messages ruining your day!
* `output.put` method is required to generate structured output data when using input to validate or filter incoming data based on certain conditions (commonly used to retrieve information needed for processing)

<Info>
  The direct property assignment syntax (input.property = value) is no longer supported. Instead, you must use the output.put method (output.put("property", value)) to generate structured output data.

  * This represents a fundamental change in how MVEL scripts interact with data
  * The input object should be treated as read-only for accessing incoming data
  * The output object with its put method must be used for storing any results or modified values
</Info>

* Python Business Rules now reliably execute during runtime, ensuring consistent behavior between test and live modes—no more mysterious token standstills!

### Web SDK

* You can now seamlessly execute actions in processes with radio buttons and validators, even after page reloads—eliminating the frustration of encountering unresponsive buttons.
* Also you can now successfully execute UI Actions on image components without encountering "undefined token uuid" errors—no more frustrations with unresponsive image interactions!
* Custom validators now retain their specified async execution type upon saving, ensuring consistency and reliability in process validation—no more frustrating switches back to sync execution!
* Forget playing favorites in the WEB\_SDK! Now you can save data from both form elements and UI action custom body simultaneously. Say goodbye to tough decisions—saving data just got a whole lot easier and funnier!

### FlowX Admin

* Fixed issues with Persistent Database (PDB) API and service account auto-mount.
* Disabled auto service links in containers (all SVC/PORT variables).

## Other

<Card>
  Our docs also received an upgrade...a new home...and a new AI search function! But we know that you like to read so do not be that lazy! 🔥
</Card>

## Coming soon

<video autoPlay muted loop playsInline className="w-full aspect-video" src="https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/release40/FlowX%20AI%20Agents.mp4" />

<Card>
  Hey there, tired of drowning in "virtual paperwork"? Fear not! We've got you covered. Who said machines can't handle finances? 🤖💰
</Card>

<Card icon="microchip-ai" color="#f3ad02">
  Coming soon: **FlowX AI Agents**. Want to find out more? Contact us about how we can make your journey smoother than ever before! 🚀
  <Card href="https://www.flowx.ai/#contact" icon="envelope">Get in contact</Card>
</Card>

## Gremlins to Watch Out For

Keep an eye out for these quirks:

* Versioning: Merging branches without importing the latest committed version may result in a surprise merge conflict party. We're on it!
* UI Designer: When relocating UI elements between parents, the elements' order doesn't always get the memo, causing a mix-up in the family tree. We're untangling this knot!

## Resources

For deployment guidelines and a seamless transition to version 4.0:

<CardGroup>
  <Card title="Deployment guidelines v4.0.0" href="./deployment-guidelines-v4.0.0" icon="file" />

  <Card title="Migrating from 3.4.x" href="./migrating-from-v3.4.x" icon="file" />

  <Card title="Renderer SDKs migration" href="./migrating-from-v3.4.x/renderers" icon="file" />

  <Card title="Process configuration v3.4.x to 4.0" href="./migrating-from-v3.4.x/process-configuration" icon="file" />
</CardGroup>
