Stable Node.js Version for React SDK Setup and Custom Component Publishing

User Experience
1

Could you please confirm the stable and officially supported Node.js version for setting up the React SDK 25.1.10 and publishing custom components?

While configuring the SDK, Node 22.15.0 was rejected, and the setup required Node 24.4.1 or higher. After upgrading to Node 25.x, the SDK started successfully. However, when creating and publishing a custom component, I encountered the following error:

TypeError [ERR_INVALID_ARG_VALUE]: The property ‘options.recursive’ is no longer supported. Received true

It appears that newer Node versions introduce breaking changes that affect the build process.

To avoid further compatibility issues, could you please advise:

  • The recommended stable Node.js version

  • Whether Node 25 is officially supported

  • If there is a preferred LTS version for development and publishing

This will help ensure consistency across environments.

Thank you.

2

@gupts2 , @Kamil Janeczek any update ?

3

Hi @Akhilesh.Madala

For React SDK 25.1.10, the DX Component Builder (DXCB) inside the SDK requires Node.js 24.4.1 or higher (LTS). This is the officially tested and supported version for creating and publishing custom components.

  • Recommended version: Node.js 24.4.1 LTS
  • Node 25.x: Not officially supported and may cause build/runtime errors due to breaking changes
  • Older LTS versions (for example, Node 22): Not sufficient for DXCB initialization

To ensure consistency and avoid compatibility issues, we recommend standardizing all development and CI environments on Node.js 24.4.1 LTS.

1 Like