esbuild-notifier

1.0.1 verified Fri May 01 auth: no javascript

A build notifier plugin for esbuild that shows OS-level notifications on build success or failure. Version 1.0.1, no recent updates. Inspired by webpack-build-notifier, it provides simple visual feedback for esbuild watch mode. Limited configuration options; no active maintenance.

Common errors

error Cannot find module 'esbuild-notifier' ↓

cause Package not installed as devDependency

fix

Run: npm install --save-dev esbuild-notifier

error TypeError: esbuildBuildNotifier is not a function ↓

cause Incorrect import (e.g., using named import or default import with wrong syntax)

fix

Use: const esbuildBuildNotifier = require('esbuild-notifier');

Warnings

gotcha CJS-only package; ESM imports may fail or require bundler interop. ↓

fix Use require() instead of import, or configure bundler for CJS interop.

deprecated Package not actively maintained; may not work with newer esbuild versions. ↓

fix Consider alternatives like esbuild-plugin-notify or custom notify scripts.

Install

npm install esbuild-notifier

yarn add esbuild-notifier

pnpm add esbuild-notifier

Imports

default

wrong

import esbuildBuildNotifier from 'esbuild-notifier';

correct

const esbuildBuildNotifier = require('esbuild-notifier');

Package is CJS-only; ESM import will fail.

default

import esbuildBuildNotifier from 'esbuild-notifier'; // with bundler or in CJS mode

Some bundlers may handle CJS/ESM interop, but native ESM is not supported.

default

wrong

const { default: esbuildBuildNotifier } = require('esbuild-notifier');

correct

const esbuildBuildNotifier = require('esbuild-notifier');

No named exports; default export is the function.

Quickstart

Shows how to add the plugin to esbuild's build options to get OS notifications on build completion or failure.

const esbuild = require('esbuild');
const esbuildBuildNotifier = require('esbuild-notifier');

esbuild.build({
  entryPoints: ['src/app.jsx'],
  bundle: true,
  outfile: 'build/bundle.js',
  watch: true,
  plugins: [
    esbuildBuildNotifier()
  ]
}).catch(() => process.exit(1));