{"id":20551,"library":"simple-progress-webpack-plugin","title":"Simple Progress Webpack Plugin","description":"A simple progress plugin for Webpack (v2.0.0, last released 2022, infrequent updates) that provides detailed, visually appealing build progress in the command line. It supports four output formats: minimal, simple, compact (default), expanded, and verbose. Requires Node.js 12+. Alternative to webpack's built-in progress plugin or ProgressBarPlugin.","status":"active","version":"2.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/dominique-mueller/simple-progress-webpack-plugin","tags":["javascript","webpack","plugin","progress","simple","logger","typescript"],"install":[{"cmd":"npm install simple-progress-webpack-plugin","lang":"bash","label":"npm"},{"cmd":"yarn add simple-progress-webpack-plugin","lang":"bash","label":"yarn"},{"cmd":"pnpm add simple-progress-webpack-plugin","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency: required to function as a webpack plugin","package":"webpack","optional":false}],"imports":[{"note":"CommonJS is the standard for webpack config files; ESM import may not work in all Node.js versions.","wrong":"import SimpleProgressWebpackPlugin from 'simple-progress-webpack-plugin';","symbol":"SimpleProgressWebpackPlugin","correct":"const SimpleProgressWebpackPlugin = require('simple-progress-webpack-plugin');"},{"note":"Default export is the class itself, not a named export.","wrong":"import { SimpleProgressWebpackPlugin } from 'simple-progress-webpack-plugin';","symbol":"SimpleProgressWebpackPlugin","correct":"import SimpleProgressWebpackPlugin = require('simple-progress-webpack-plugin');"},{"note":"Type import for TypeScript; options interface is not a runtime value.","wrong":"import { Options } from 'simple-progress-webpack-plugin';","symbol":"Options","correct":"import type { Options } from 'simple-progress-webpack-plugin';"}],"quickstart":{"code":"// webpack.config.js\nconst SimpleProgressWebpackPlugin = require('simple-progress-webpack-plugin');\n\nmodule.exports = {\n  // ... other webpack config\n  plugins: [\n    new SimpleProgressWebpackPlugin({\n      format: 'compact', // optional: minimal, simple, compact, expanded, verbose\n      color: true, // optional: default true\n      name: 'My Build', // optional: custom build name\n    }),\n  ],\n};","lang":"javascript","description":"Instantiates SimpleProgressWebpackPlugin with default options in a webpack config file."},"warnings":[{"fix":"Upgrade Node.js to version 12 or higher.","message":"Requires Node.js 12+. Older versions are not supported and may cause errors.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Use the correct class name 'SimpleProgressWebpackPlugin'.","message":"Plugin renamed from 'SimpleProgressPlugin' in v1.x? No, always 'SimpleProgressWebpackPlugin'.","severity":"breaking","affected_versions":"all"},{"fix":"Use 'compact', 'expanded', 'simple', or 'minimal' for production.","message":"The 'format' option 'verbose' may produce excessive output and is intended for debugging only.","severity":"deprecated","affected_versions":"all"},{"fix":"Set 'color: false' if colors are not supported.","message":"The plugin uses chalk internally; color output may not appear on all CI systems (e.g., Jenkins).","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'minimal' format to reduce output or consider a custom condition.","message":"In watch mode, the plugin prints progress for each recompilation, which may clutter output.","severity":"gotcha","affected_versions":">=1.0.4"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install simple-progress-webpack-plugin --save-dev'.","cause":"Package not installed or not in node_modules.","error":"Error: Cannot find module 'simple-progress-webpack-plugin'"},{"fix":"Use 'const SimpleProgressWebpackPlugin = require('simple-progress-webpack-plugin');' or 'import SimpleProgressWebpackPlugin from ...' if ESM.","cause":"Incorrect import: using a named import instead of default.","error":"TypeError: SimpleProgressWebpackPlugin is not a constructor"},{"fix":"Upgrade webpack to version 2 or higher.","cause":"Webpack version is too old; plugin requires webpack 2+.","error":"Error: webpack >=2.0.0 is required"},{"fix":"Check the format option and use one of the allowed values.","cause":"Invalid format string passed to options.","error":"Options.format must be one of: minimal, simple, compact, expanded, verbose"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}