In this document, you will learn how to build a React component library with Rslib.
You can use create-rslib
to create a project with Rslib + React. Just execute the following command:
Then select React
when prompted to "Select template".
To develop a React library, you need to set the target to "web"
in rslib.config.ts
. This is crucial because Rslib sets the target
to "node"
by default, which differs from the default target of Rsbuild.
To compile React (JSX and TSX), you need to register the Rsbuild React Plugin. The plugin will automatically add the necessary configuration for React builds.
For example, register in rslib.config.ts
:
'automatic' | 'classic'
'automatic'
React introduced a new JSX transform in version 17. This new transform removes the need to import React
when using JSX.
By default, Rsbuild uses the new JSX transform, which is runtime: 'automatic'
. It requires at least React 16.14.0
or higher. The peer dependency for React should be declared as above 16.14.0
.
To change the JSX transform, you can pass the swcReactOptions option to the React plugin. For example, to use the classic runtime:
string
'react'
When runtime
is 'automatic'
, you can specify the import path of the JSX transform through importSource
.
For example, when using Emotion, you can set importSource
to '@emotion/react'
: