{"id":25432,"library":"esbuild-plus","title":"esbuild-plus","description":"Minimal zero-dependency esbuild development environment with live reload. Current version 0.3.4. Provides a CLI tool (ebp) for development server and production builds using esbuild. Convention-over-configuration folder structure (static/, src/, target/). Includes global IS_DEV flag, IIFE support, and static file copying. Not actively maintained (last release 2021). Smaller alternative to full bundler setups like webpack or Vite for esbuild-based projects.","status":"maintenance","version":"0.3.4","language":"javascript","source_language":"en","source_url":"https://github.com/gavoja/esbuild-plus","tags":["javascript","esbuild","development"],"install":[{"cmd":"npm install esbuild-plus","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-plus","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-plus","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"required peer dependency for bundling","package":"esbuild","optional":false}],"imports":[{"note":"The package exposes a bin script named 'ebp', not a programmatic API. Use npx or add script in package.json.","wrong":"npm run ebp","symbol":"CLI command","correct":"npx ebp"},{"note":"No programmatic API is exported. The package only provides CLI.","wrong":"","symbol":"programmatic usage","correct":""},{"note":"IS_DEV is a global variable injected at build time, not an import. It is available in bundled code when running with --dev.","wrong":"import { IS_DEV } from 'esbuild-plus'","symbol":"IS_DEV global","correct":"if (IS_DEV) { ... }"}],"quickstart":{"code":"npm init -y\nnpm i -D esbuild esbuild-plus\nmkdir -p static src\necho '<script src=\"/main.js\"></script>' > static/index.html\necho 'console.log(\"Hello esbuild-plus\");' > src/main.js\nnpx ebp --dev","lang":"javascript","description":"Initialize a new project, install dependencies, create minimal files, and start the dev server at localhost:3000."},"warnings":[{"fix":"Add --dev when you want a development server with live reload.","message":"The --dev flag must be used to enable live reload; without it, the command bundles for production and exits.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Run npm i -D esbuild alongside esbuild-plus.","message":"The package requires esbuild as a peer dependency but does not install it automatically.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Add a global type declaration file.","message":"IS_DEV is a global variable, not an import; TypeScript users must declare it (declare var IS_DEV: boolean;).","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Update your workflow if you relied on old server behavior.","message":"In v0.2.0, the dev server was replaced with a custom server (was previously using esbuild's serve).","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Upgrade to v0.3.2+ for improved static syncing.","message":"Static files are only copied on initial start; changes to static/ may not be hot-reloaded.","severity":"gotcha","affected_versions":"<0.3.2"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run: npm i -D esbuild","cause":"esbuild peer dependency not installed.","error":"Error: Cannot find module 'esbuild'"},{"fix":"Use: npx ebp or add to scripts in package.json.","cause":"npx not used or path not set.","error":"Command 'ebp' not found"},{"fix":"Run with --dev: npx ebp --dev","cause":"IS_DEV global not available without --dev flag.","error":"IS_DEV is not defined"},{"fix":"Use CLI via npx; there is no programmatic API.","cause":"Attempted to use programmatic API, but no such API exists.","error":"TypeError: ebp.runDev is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}