Registry / web-framework / nuxt-esbuild-module

nuxt-esbuild-module

library1.0.4jsnpmunverified

A Nuxt module that enables esbuild to transpile JavaScript and TypeScript, speeding up development builds. Current version 1.0.4. It uses esbuild-loader for fast transpilation during development, and optionally for TypeScript, while still applying Babel for production builds to ensure browser compatibility. Similar to Vite's approach. Provides faster dev builds compared to Babel-only or ts-loader setups.

web-framework devops

npm install nuxt-esbuild-module

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · NUXT-ESBUILD-MODUL

nuxt-esbuild-module

web-frameworkjavascriptv1.0.4

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.

nuxt-esbuild

✓ import 'nuxt-esbuild'

✗ const NuxtEsbuild = require('nuxt-esbuild')

Nuxt modules are added as strings in buildModules, not imported as functions.

module registration

✓ buildModules: ['nuxt-esbuild']

✗ modules: ['nuxt-esbuild']

For Nuxt 2, use buildModules to avoid running on production server. For Nuxt 3, use modules.

default import

✓ import NuxtEsbuildModule from 'nuxt-esbuild'

✗ import { NuxtEsbuild } from 'nuxt-esbuild'

This module exports a function as default, not a named export.

Configure nuxt-esbuild module with TypeScript support in nuxt.config.js. Shows how to add module and specify esbuild options.

// nuxt.config.js const path = require('path') export default { buildModules: ['nuxt-esbuild'], esbuild: { loader: 'ts', // or 'js' for JavaScript only tsconfigRaw: require(path.resolve(__dirname, 'tsconfig.json')), }, }

Debug

Known issues

gotchaesbuild is only used in development mode. Production builds use Babel for JavaScript.

fix

Do not rely on esbuild for production. Ensure Babel configuration is correct for production builds.

affects: >=0.0.0

gotchaWhen using TypeScript, both esbuild and Babel will transpile code (esbuild first, then Babel). This may cause issues if Babel plugins are incompatible with esbuild's output.

fix

Review Babel plugins and ensure they work with esbuild-transpiled code. Consider using only esbuild for TypeScript if possible.

affects: >=0.0.0

gotchaThe module uses esbuild-loader, which requires Webpack 4 or 5 (Nuxt's default). Ensure compatibility with your Webpack version.

fix

Check Nuxt and Webpack versions. Upgrade if necessary.

affects: >=0.0.0

deprecatedFor Nuxt 3, the buildModules array is replaced by modules. Using buildModules in Nuxt 3 will cause a warning.

fix

Use modules: ['nuxt-esbuild'] for Nuxt 3.

affects: >=1.0.0

Errors

Common errors & fixes

Module 'nuxt-esbuild' not found

Package not installed or incorrect import path

fix

npm install nuxt-esbuild and add 'nuxt-esbuild' to buildModules in nuxt.config.js

esbuild-loader requires Webpack 4 or higher

Using older Webpack version

fix

Upgrade Webpack to 4+ or use a compatible version of esbuild-loader

Cannot read property 'raw' of undefined

Missing or malformed tsconfigRaw option

fix

Ensure tsconfig.json exists and path is correct, or omit tsconfigRaw if not needed

Upgrade

Version history

1.0.4latest on npm

Audit

Dependencies

esbuild-loaderrequiredCore loader for transpilation with esbuild

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/galvez/nuxt-esbuild-module ↗

packagehttps://www.npmjs.com/package/nuxt-esbuild-module ↗

homepagehttps://esbuild.github.io ↗