Registry / web-framework / laravel-mix-esbuild

laravel-mix-esbuild

JSON →
library1.1.0jsnpmunverified

Laravel Mix extension to replace babel-loader with esbuild-loader, significantly speeding up JavaScript/TypeScript compilation. Current stable version is 1.1.0. It adds an `esbuild()` method to your Mix pipeline with presets for React, TypeScript, JSX. Requires laravel-mix ^6.0 as a peer dependency. Unlike babel-based setups, this leverages esbuild's native fast transforms but with limited tsconfig support and no Vue SFC support.

npm install laravel-mix-esbuild
INSTALL
IMPORT
SIG · LARAVEL-MIX-ESBUIL
L
laravel-mix-esbuild
web-frameworkjavascriptv1.1.0
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
require('laravel-mix-esbuild')
import 'laravel-mix-esbuild'
This extension is designed for Laravel Mix's CommonJS environment; ESM import may not work.
mix.esbuild
mix.esbuild('preset', options)
mix.esbuild(true)
The method is added to mix after requiring the extension; it can be called without arguments for defaults.
presets
mix.esbuild('react')
mix.esbuild({ preset: 'react' })
Presets are strings passed as first argument; object syntax is not supported.

Shows basic setup: require the extension, then call esbuild() with a preset and options.

// webpack.mix.js const mix = require('laravel-mix'); require('laravel-mix-esbuild'); mix .js('resources/js/app.js', 'public/js') .esbuild('ts', { target: 'es2020' });
Debug
Known issues
gotchaVue Single File Components (.vue) are NOT supported; Vue may work only without SFC.
fix
Use default babel-loader for Vue SFC or avoid using .vue files.
affects: >=1.0.0
gotchaesbuild only supports a subset of TypeScript compiler options; tsconfig must have isolatedModules and esModuleInterop.
fix
Add 'isolatedModules': true and 'esModuleInterop': true to tsconfig.json.
affects: >=1.0.0
gotchaReact presets may require adding 'acorn' as a dependency.
fix
Run 'npm install acorn --save-dev'.
affects: >=1.0.0
deprecatedNo breaking changes known; but note that esbuild-loader may have its own breaking changes.
fix
Check esbuild-loader changelog for breaking changes.
affects: >=1.0.0
Errors
Common errors & fixes
Cannot find module 'laravel-mix-esbuild'
Package not installed or missing from node_modules.
fix
Run 'npm install laravel-mix-esbuild --save-dev'.
mix.esbuild is not a function
The require('laravel-mix-esbuild') is missing or placed after mix is used.
fix
Ensure 'require('laravel-mix-esbuild')' is called before using mix.esbuild().
Upgrade
Version history
1.1.0latest on npm
Audit
Dependencies
laravel-mixrequiredpeer dependency; version ^6.0 required
Agent activity
2 hits · last 30 days
node
2
Resources
laravel-mix-esbuild — npm install laravel-mix-esbuild · libregistry