Registry / devops / rollup-plugin-react-refresh

rollup-plugin-react-refresh

library0.0.3jsnpmunverified

A Rollup/Nollup development plugin enabling React Fast Refresh (Hot Module Replacement) for React applications. Current stable version is 0.0.3, with no recent updates. It wraps react-refresh and requires the Babel plugin react-refresh/babel. Key differentiator: lightweight, zero-config HMR for Rollup-based React builds. Less maintenance compared to alternatives like @pmmmwh/react-refresh-webpack-plugin (webpack-only).

devops

npm install rollup-plugin-react-refresh

package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-REAC

rollup-plugin-react-refresh

devopsjavascriptv0.0.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

default (refresh)

✓ import refresh from 'rollup-plugin-react-refresh'

✗ const refresh = require('rollup-plugin-react-refresh');

Default import is named export in CJS; ESM-only plugin.

rollup-plugin-react-refresh (default export)

✓ const refresh = require('rollup-plugin-react-refresh').default;

✗ const refresh = require('rollup-plugin-react-refresh');

In CJS contexts, default export is attached to .default property.

refresh (function call)

✓ refresh({})

✗ new refresh()

Plugin is a factory function returning a Rollup plugin object, not a constructor.

Rollup config with react-refresh plugin enabled only in development.

// rollup.config.js import refresh from 'rollup-plugin-react-refresh'; // v0.0.3 module.exports = { input: 'src/index.js', output: { file: 'dist/bundle.js', format: 'iife' }, plugins: [ process.env.NODE_ENV === 'development' && refresh() ].filter(Boolean) };

Debug

Known issues

gotchaPlugin requires react-refresh Babel transform; without it, Fast Refresh won't work.

fix

Add 'react-refresh/babel' to Babel plugins in development environment.

affects: >=0.0.0

gotchaPlugin only works in development mode; must be gated with process.env.NODE_ENV check to avoid production issues.

fix

Wrap plugin with process.env.NODE_ENV === 'development' condition.

affects: >=0.0.0

gotchaDefault import in CJS requires `.default`; common mistake causes 'refresh is not a function'.

fix

Use `const refresh = require('rollup-plugin-react-refresh').default;`

affects: >=0.0.0

deprecatedreact-refresh v0.9.0 is specified as peer dep; newer versions may work but not guaranteed.

fix

Install exactly react-refresh@^0.9.0 for guaranteed compatibility.

affects: >=0.0.0

Errors

Common errors & fixes

TypeError: refresh is not a function

Using CJS `require` without `.default` property.

fix

Replace `require('rollup-plugin-react-refresh')` with `require('rollup-plugin-react-refresh').default`.

Module not found: Can't resolve 'react-refresh/runtime'

Missing peer dependency react-refresh.

fix

Run `npm install react-refresh@^0.9.0 --save-dev`.

ReferenceError: React is not defined

Missing React import in component files after Fast Refresh; Babel transform assumes React is in scope.

fix

Add `import React from 'react';` to all JSX files.

Upgrade

Version history

0.0.3latest on npm

Audit

Dependencies

react-refreshrequiredPeer dependency providing the core React Refresh runtime; must be installed separately with ^0.9.0

Agent activity

6 hits · last 30 days

node

Resources

packagerollup-plugin-react-refresh ↗