Registry / devops / react-app-rewired-esbuild

react-app-rewired-esbuild

library0.0.11jsnpmunverified

A plugin for react-app-rewired that replaces Babel and Terser with esbuild for faster builds in Create React App projects. Current version 0.0.11 is stable but young, with low community adoption. Key differentiator: minimal config integration into existing react-app-rewired setups. Compared to alternatives like CRACO or custom Webpack config, it offers an easy drop-in replacement. Release cadence is low; latest version unchanged since 2021. Not recommended for production due to missing React JSX transform auto-injection.

devops

npm install react-app-rewired-esbuild

github ↗package ↗

INSTALL

IMPORT

SIG · REACT-APP-REWIRED-

react-app-rewired-esbuild

devopsjavascriptv0.0.11

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 (function rewiredEsbuild)

✓ const rewiredEsbuild = require('react-app-rewired-esbuild');

✗ const { rewiredEsbuild } = require('react-app-rewired-esbuild');

default export is a function; named import will fail. CJS only, no ESM export.

rewiredEsbuild (Customize CRA pattern)

✓ module.exports = override(rewiredEsbuild());

✗ module.exports = override(rewiredEsbuild);

rewiredEsbuild must be called (returns a function) when used with customize-cra's override.

ESBuildLoaderOptions

✓ rewiredEsbuild({ loader: 'tsx', target: 'es2020' })

✗ rewiredEsbuild({ ESBuildLoaderOptions: { loader: 'tsx' } })

Options are passed directly as first argument, not nested under a property name.

Overriding CRA config with react-app-rewired to use esbuild for faster development builds.

// config-overrides.js const rewiredEsbuild = require('react-app-rewired-esbuild'); module.exports = function override(config, env) { // add your other config overrides here return rewiredEsbuild()(config, env); };

Debug

Known issues

gotchaJSX files may fail with 'ReferenceError: React is not defined' since esbuild does not auto-inject the React import.

fix

Add 'import React from 'react' at the top of every JSX file, or use esbuild's automatic JSX runtime injection via jsxFactory and jsxFragment.

affects: >=0.0.0

deprecatedThe underlying esbuild-loader is being superseded by direct esbuild integration in newer build tools, but this package has not been updated since 2021.

fix

Consider using CRACO with esbuild-loader directly, or migrate to Vite (which uses esbuild natively).

affects: >=0.0.0

gotchaThis package only works with CRA projects that use react-app-rewired. It does not support react-scripts@5 or higher without additional compatibility fixes.

fix

Check react-scripts version; for v5, you may need to patch config-overrides.js or use an alternative like CRACO.

affects: >=0.0.0

breakingOptions passed to rewiredEsbuild override the entire default configuration; merging with existing override config may be destructive.

fix

Ensure that rewiredEsbuild() is called last in the override chain after any other config modifications.

affects: >=0.0.0

gotchaEsbuild's CSS support is experimental; CSS imports may behave differently or fail in production builds.

fix

Use onlyMinimizer: true for production to avoid CSS processing issues, or handle CSS separately.

affects: >=0.0.0

Errors

Common errors & fixes

ReferenceError: React is not defined

esbuild does not automatically inject the React import declaration for JSX files, unlike Babel's classic runtime.

fix

Add 'import React from 'react' at the top of each JSX file, or enable automatic JSX runtime in esbuild options (e.g., loader: 'jsx', jsxFactory: 'React.createElement', jsxFragment: 'React.Fragment').

Module not found: Can't resolve 'react-app-rewired'

react-app-rewired is a peer dependency that must be installed separately.

fix

Run 'npm i react-app-rewired --save-dev' or 'yarn add react-app-rewired --dev'.

TypeError: rewiredEsbuild is not a function

Imported the default export incorrectly, e.g., using destructuring with named import.

fix

Use 'const rewiredEsbuild = require('react-app-rewired-esbuild');' without curly braces.

Error: Cannot find module 'esbuild-loader'

esbuild-loader is a transitive dependency that was not installed or resolved properly.

fix

Run 'npm i esbuild-loader --save-dev' or ensure your npm/yarn resolutions include it.

Upgrade

Version history

0.0.11latest on npm

Audit

Dependencies

react-app-rewiredrequiredpeer dependency required to override react-scripts configuration

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/fupengl/react-app-rewired-esbuild ↗

packagehttps://www.npmjs.com/package/react-app-rewired-esbuild ↗