Registry / web-framework / vite-plugin-react

vite-plugin-react

library4.0.1jsnpmunverified

Official Vite plugin providing React Fast Refresh support, version 4.0.1. Release cadence follows Vite major releases. Key differentiator: default in create-vite-app React template, first-party support from Vite team. Alternative to react-refresh-webpack-plugin, with native ESM and HMR integration.

web-framework

npm install vite-plugin-react

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-REACT

vite-plugin-react

web-frameworkjavascriptv4.0.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import react from 'vite-plugin-react'

✗ const react = require('vite-plugin-react')

Default export, also works with require in CJS but prefer import.

createPlugin

✓ import { createPlugin } from 'vite-plugin-react'

Named export for advanced usage, not commonly used.

reactFastRefresh

✓ import { reactFastRefresh } from 'vite-plugin-react'

✗ import { fastRefresh } from 'vite-plugin-react'

Exact name of the HMR plugin.

Configures Vite with React Fast Refresh using the vite-plugin-react plugin.

// vite.config.js import { defineConfig } from 'vite'; import react from 'vite-plugin-react'; export default defineConfig({ plugins: [react()] });

Debug

Known issues

breakingvite-plugin-react requires Vite >=1.0.0-rc.13. Using older versions will cause errors.

fix

Update Vite to >=1.0.0-rc.13.

affects: >=0.0.0

deprecatedThe `jsx: 'react'` config option is no longer needed in Vite 2+.

fix

Remove `jsx: 'react'` from vite.config.js.

affects: >=2.0.0

gotchaThis plugin does not provide Babel transforms; ensure your project already handles JSX via Vite's built-in support.

fix

Use Vite's default esbuild for JSX or add @vitejs/plugin-react-refresh separately.

affects: >=1.0.0

Errors

Common errors & fixes

Cannot find module 'vite-plugin-react'

Package not installed or missing dependencies.

fix

Run `npm install vite-plugin-react`.

TypeError: react is not a function

Incorrect import or usage in vite.config.js

fix

Ensure you import default export: `import react from 'vite-plugin-react'` and call it as `react()`.

Uncaught Error: [vite-plugin-react] React Fast Refresh requires a React version that supports hooks.

Using React <16.8.0 without Hooks support.

fix

Upgrade React to >=16.8.0.

Upgrade

Version history

4.0.1latest on npm

Audit

Dependencies

viterequiredpeer dependency, version >=1.0.0-rc.13

Agent activity

5 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/vitejs/vite-plugin-react ↗

packagehttps://www.npmjs.com/package/vite-plugin-react ↗

homepagehttps://vitejs.dev ↗