{"id":25390,"library":"esbuild-plugin-progress","title":"esbuild-plugin-progress","description":"A plugin for esbuild that displays a live progress spinner during the build process. Current stable version is 1.3.9. The plugin is released on npm and updates are infrequent. Key differentiators: simple integration, no dependencies, minimalist spinner animation that provides visual feedback for esbuild builds, especially useful for large builds or server-side bundling. It is a lightweight alternative to more complex logging plugins.","status":"active","version":"1.3.9","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","progress","server","esbuild","plugin","typescript"],"install":[{"cmd":"npm install esbuild-plugin-progress","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-plugin-progress","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-plugin-progress","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The package is ESM-first; require() works in Node >=16 with default conditions.","wrong":"const progress = require('esbuild-plugin-progress')","symbol":"progress","correct":"import progress from 'esbuild-plugin-progress'"},{"note":"There is no named export; only a default export.","symbol":"ProgressPlugin","correct":"import { ProgressPlugin } from 'esbuild-plugin-progress'"},{"note":"Default import is the intended usage.","symbol":"default","correct":"import progress from 'esbuild-plugin-progress'"}],"quickstart":{"code":"import esbuild from 'esbuild';\nimport progress from 'esbuild-plugin-progress';\n\nawait esbuild.build({\n  entryPoints: ['./src/index.js'],\n  bundle: true,\n  outfile: './dist/bundle.js',\n  plugins: [progress()],\n});\nconsole.log('Build complete');","lang":"typescript","description":"Shows the simplest usage: import esbuild and the plugin, then include in plugins array."},"warnings":[{"fix":"Use environment detection to disable the plugin in non-interactive shells.","message":"The progress spinner may not display properly in non-TTY terminals or CI environments.","severity":"gotcha","affected_versions":"all"},{"fix":"Do not use this plugin with esbuild's watch or serve modes.","message":"Plugin does not support esbuild's watch mode; spinner will only appear for one-time builds.","severity":"gotcha","affected_versions":"all"},{"fix":"Use dynamic import() if using CommonJS in a mixed module project.","message":"The package ships CommonJS but is primarily ESM; require() may cause issues in strict ESM projects.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run npm install esbuild-plugin-progress --save-dev","cause":"Package not installed or missing from node_modules.","error":"Error: Cannot find module 'esbuild-plugin-progress'"},{"fix":"Use import progress from 'esbuild-plugin-progress'","cause":"Using the default import incorrectly, e.g., importing as { progress }.","error":"TypeError: progress is not a function"},{"fix":"Check if process.stdout.isTTY is true before using the plugin.","cause":"Non-interactive terminal or CI environment.","error":"The spinner is not showing"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}