Skip to main content

​
Version strategy

FlowX.AI UI Toolkits follow a semantic versioning approach with a unique release numbering system that maps to the FlowX.AI platform versions.

​
Version mapping

The UI Toolkits use a two-tier versioning system:
  • Release version: The public-facing version number (e.g., 4.7.11, 5.0.0)
  • Internal version: The internal build version that aligns with the FlowX.AI platform (e.g., v5.103.6, v9.69.0)
Both Angular and React UI Toolkits are released in sync with identical version numbers and feature parity.

​
Version 4.x series

The 4.x series (4.7.0 through 4.7.11) represents the stable, production-ready toolkit with:
  • Internal versions ranging from v5.80.6 to v5.103.6
  • Full backwards compatibility within the 4.7.x range
  • Active maintenance and security patches
  • Dependency on react-hook-form for form management (React)
  • Dependency on @radix-ui primitives for accessible components (React)

​
Version 5.x series

The 5.x series (5.0.0 and above) introduces significant architectural improvements:
  • Internal versions starting from v9.69.0
  • Major dependency updates and modernization
  • Breaking changes in component APIs
  • Enhanced accessibility with @base-ui-components/react
  • Improved multi-select capabilities
  • New components and features

​
Support policy

Version 4.7.x will receive security updates and critical bug fixes until December 31, 2026. After this date, only version 5.x and later will be supported.

​
Current support status

VersionStatusSupport UntilRecommended For
4.7.xMaintenanceDec 31, 2026Existing production applications
5.0.x - 5.1.xActiveOngoingMigration projects
5.2.x+ActiveOngoingNew projects
Version 5.5.0 is the latest stable release and is recommended for all new projects.

​
Choosing a version

​
Stay on 4.7.x if:

  • You have a stable production application with no immediate need for new features
  • You want to minimize migration effort in the short term
  • Your application depends on the current form API structure
  • You plan to migrate before the end-of-support date

​
Migrate to 5.x if:

  • You’re starting a new project
  • You need the latest features and improvements
  • You want access to the new Chip component
  • You need enhanced multi-select functionality
  • You want to leverage modern dependency updates
  • You’re planning for long-term maintenance

​
Version compatibility

​
Platform compatibility

  • FlowX.AI Platform: v5.80.6 - v5.103.6
  • React: ~18.x
  • React DOM: ~18.x
  • Angular: 15.x - 17.x (Angular UI Toolkit only)
  • Node.js: 16.x or higher
  • TypeScript: 4.9.x or higher
  • FlowX.AI Platform: v9.69.0 or higher
  • React: ~18.x
  • React DOM: ~18.x
  • Angular: 15.x - 18.x (Angular UI Toolkit only)
  • Node.js: 18.x or higher
  • TypeScript: 5.0.x or higher

​
Peer dependencies

​
React UI Toolkit 4.7.x

"peerDependencies": {
  "react": "~18",
  "react-dom": "~18",
  "air-datepicker": "~3",
  "ag-grid-react": "~32"
}

​
React UI Toolkit 5.x

"peerDependencies": {
  "react": "~18",
  "react-dom": "~18"
}
Version 5.x bundles air-datepicker and ag-grid-react as direct dependencies, simplifying your dependency management.

​
Migration paths

1

Audit your current implementation

Review which UI Toolkit components your application uses and identify any custom implementations or workarounds.
2

Review breaking changes

Consult the breaking changes reference to understand what will change in your application.
3

Plan your migration

Decide whether to migrate all at once or incrementally. For large applications, consider a phased approach.
4

Follow the migration guide

Use the v4 to v5 migration guide for step-by-step instructions and code examples.
5

Test thoroughly

Ensure all components work as expected, paying special attention to forms, selects, and data-heavy components.

​
Feature comparison

Feature4.7.x5.xNotes
Basic components✅✅Button, Card, Message, etc.
Form controls✅✅API changes in 5.x
Select component✅✅Enhanced in 5.x with render props
Multi-select⚠️ Limited✅ EnhancedFull customization in 5.x
Chip component❌✅New in 5.x
Accordion✅✅No changes
Stepper✅✅No changes
Table✅✅No changes
Modal✅✅No changes
Toast✅✅No changes
Document Viewer✅✅No changes
File Upload✅✅No changes
Icon system✅✅Structure change in 5.x

​
Next steps

v4 to v5 migration guide

Step-by-step guide to migrate from version 4.7.x to 5.x

Breaking changes reference

Complete list of breaking changes across versions

Build docs developers (and LLMs) love

Get started for freeTalk to us