FAQ

v3.17.0+

Is there any prerequisites for on-premise solutions?

Enable the feature form-component-development

Configure tokens on when doing the environment setup.

Ensure your user has one of the following permissions: formComponentDeveloper or admin

Is there an example available?

Yes, there is an example available to get started.

How can I style my components?

Tailwind and sccs are supported by default. For Sccs, you can create a component.scss file in the component folder.

How can I reuse some logic between components?

Use the folder shared to develop reusable code

How can I test my custom components?

You can add the test framework of you choice, however we recommend vitest

Can I use storybook to develop my components?

Yes, you can add it to the project following the storybook documentation

What are the minimum requisites?

• React 18 or higher

• React developer tools extension installed

• Flowable version 3.17 or higher

• Node version 18 or higher

How can I migrate an old custom component project?

• Run flowable components create to register a new component
• Move the code to the new {component-name}.tsx file that was created.
• Migrate the palette definition json to the custom component management view.

Can I also create custom components with a version older than 3.17?

Yes, also older versions of Flowable support the creation of custom components. However, there are more manual steps required and additional things need to be done. Please check-out the how-to create a custom form component for further details.

I'm using tailwind v4 but my styles are not applied

Due to breaking changes in the Tailwind library from v3 to v4, you might experience issues if you are using Flowable 2025.1 or 3.17. To resolve this, you can use higher specificity, such as important for CSS styles that are not being applied. This workaround will not be needed from version 2025.2 onwards.

Which React version should I use?

We recommend using the same React version in your custom components that Flowable is using. This will help reduce possible runtime issues and some limitations in the cli with flowable components watch.

Flowable version	React version
2025.2+	react 19
2025.1	react 18
3.17	react 18