@vitejs/plugin-react weekly downloads statistics

@vitejs/plugin-react

The default Vite plugin for React projects.

• enable Fast Refresh in development (requires react >= 16.9)
• use the automatic JSX runtime
• small installation size

// vite.config.js
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
})

Options

include

Includes .js, .jsx, .ts & .tsx by default. This option can be used to add fast refresh to .mdx files:

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import mdx from '@mdx-js/rollup'

export default defineConfig({
  plugins: [
    { enforce: 'pre', ...mdx() },
    react({ include: /\.(mdx|js|jsx|ts|tsx)$/ }),
  ],
})

exclude

The default value is /node_modules/. You may use it to exclude JSX/TSX files that runs in a worker or are not React files. Except if explicitly desired, you should keep node_modules in the exclude list:

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [
    react({ exclude: [/\/pdf\//, /\.solid\.tsx$/, /\/node_modules\//] }),
  ],
})

jsxImportSource

Control where the JSX factory is imported from. By default, this is inferred from jsxImportSource from corresponding a tsconfig file for a transformed file.

react({ jsxImportSource: '@emotion/react' })

jsxRuntime

By default, the plugin uses the automatic JSX runtime. However, if you encounter any issues, you may opt out using the jsxRuntime option.

react({ jsxRuntime: 'classic' })

reactRefreshHost

The reactRefreshHost option is only necessary in a module federation context. It enables HMR to work between a remote & host application. In your remote Vite config, you would add your host origin:

react({ reactRefreshHost: 'http://localhost:3000' })

Under the hood, this simply updates the React Fash Refresh runtime URL from /@react-refresh to http://localhost:3000/@react-refresh to ensure there is only one Refresh runtime across the whole application. Note that if you define base option in the host application, you need to include it in the option, like: http://localhost:3000/{base}.

React Compiler

Rust React Compiler

[!WARNING] Native React Compiler support is experimental.

The compiler option uses oxc-transform-react, a Rust port of React Compiler, which must be installed as an optional peer dependency:

npm install -D oxc-transform-react

// vite.config.js
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react({ compiler: true })],
})

The compiler option also accepts React Compiler options:

react({ compiler: { compilationMode: 'annotation' } })

Set logDiagnostics to true to log recoverable React Compiler diagnostics through Vite. This option defaults to false. Fatal diagnostics are always logged and fail the transform.

react({ compiler: { logDiagnostics: true } })

Babel React Compiler

React Compiler can also be used through Babel with the exported reactCompilerPreset helper. This requires @rolldown/plugin-babel, babel-plugin-react-compiler, and @babel/core as peer dependencies:

npm install -D @rolldown/plugin-babel @babel/core babel-plugin-react-compiler

If you are using TypeScript with Babel 7, you will also need to install @types/babel__core:

npm install -D @types/babel__core

// vite.config.js
import { defineConfig } from 'vite'
import react, { reactCompilerPreset } from '@vitejs/plugin-react'
import babel from '@rolldown/plugin-babel'

export default defineConfig({
  plugins: [react(), babel({ presets: [reactCompilerPreset()] })],
})

The reactCompilerPreset accepts an optional options object with the following properties:

• compilationMode — Set to 'annotation' to only compile components annotated with "use memo".
• target — Set to '17' or '18' to target older React versions (uses react-compiler-runtime instead of react/compiler-runtime).

Additional options can be found in the documentation.

babel({
  presets: [reactCompilerPreset({ compilationMode: 'annotation' })],
})

[!TIP]

reactCompilerPreset is only a convenient helper with a preconfigured filter. You can configure override the filters to fit your project structure or code. For example, if you know a large portion of your files are never React/hook-related or won't benefit from the React Compiler, you can aggressively exclude them via rolldown.filter:

const myPreset = reactCompilerPreset()
myPreset.rolldown.filter.id.exclude = ['src/legacy/**', 'src/utils/**']

babel({
  presets: [myPreset],
})

@vitejs/plugin-react/preamble

The package provides @vitejs/plugin-react/preamble to initialize HMR runtime from client entrypoint for SSR applications which don't use transformIndexHtml API. For example:

// [entry.client.js]
import '@vitejs/plugin-react/preamble'
```…