{"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,"search_vec":"'12':42 '2022':14 'altern':43 'appeal':21 'build':22 'built':48 'built-in':47 'command':26 'compact':35 'default':36 'detail':19 'expand':37 'format':32 'four':30 'infrequ':15 'javascript':54 'last':12 'line':27 'logger':59 'minim':33 'node.js':41 'output':31 'plugin':4,8,51,56 'progress':2,7,23,50,57 'progressbarplugin':53 'provid':18 'releas':13 'requir':40 'simpl':1,6,34,58 'support':29 'typescript':60 'updat':16 'v2.0.0':11 'verbos':39 'visual':20 'webpack':3,10,45,55","created_at":"2026-04-25T11:23:43.410798+00:00","updated_at":"2026-04-25T11:23:43.410798+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/dominique-mueller/simple-progress-webpack-plugin","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/simple-progress-webpack-plugin","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-17","next_check":"2026-07-24","install_tag":null}}