{"id":22788,"library":"vite-plugin-progress","title":"vite-plugin-progress","description":"A Vite plugin that displays a customizable progress bar during the build process. Current stable version is 0.0.7. It wraps the node-progress library and supports options like format, width, color via picocolors, and more. It is designed for Vite developers who want visual feedback on build progress, similar to progress-bar-webpack-plugin but for Vite. The plugin is lightweight, supports TypeScript, and has a simple API. Release cadence is low; it is a stable utility with few updates.","status":"active","version":"0.0.7","language":"javascript","source_language":"en","source_url":"https://github.com/jeddygong/vite-plugin-progress","tags":["javascript","vite","plugin","progress","typescript"],"install":[{"cmd":"npm install vite-plugin-progress","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-progress","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-progress","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only; CommonJS require is not supported.","wrong":"const progress = require('vite-plugin-progress')","symbol":"default","correct":"import progress from 'vite-plugin-progress'"},{"note":"Type import is safe; value import will cause runtime error because ProgressOptions is not exported as a value.","wrong":"import { ProgressOptions } from 'vite-plugin-progress'","symbol":"Types","correct":"import type { ProgressOptions } from 'vite-plugin-progress'"},{"note":"progress is a default export, not a named export.","wrong":"import { progress } from 'vite-plugin-progress'","symbol":"Plugin","correct":"import progress from 'vite-plugin-progress' \n export default { plugins: [progress()] }"}],"quickstart":{"code":"// vite.config.ts\nimport progress from 'vite-plugin-progress'\n\nexport default {\n  plugins: [\n    progress({\n      format: 'building [:bar] :percent',\n      total: 200,\n      width: 60,\n      complete: '=',\n      incomplete: ''\n    })\n  ]\n}","lang":"typescript","description":"Shows how to add the plugin with custom options to a Vite config.\n"},"warnings":[{"fix":"Set `total` explicitly (e.g., 200) or rely on internal counting (but may show no progress).","message":"The `total` option does not correspond to actual file count; it sets the total ticks for the progress bar. Default total is 0, leading to no progress display.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Do not use `srcDir`; remove it from options.","message":"The `srcDir` option is deprecated and may be removed in future versions.","severity":"deprecated","affected_versions":">=0.0.6"},{"fix":"No fix; this is expected behavior. Subsequent builds show full progress.","message":"During first build, `transforms` and `chunks` are not displayed. Progress may appear incomplete initially.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Clear cache (`rm -rf node_modules/.vite`) if issues occur.","message":"Version 0.0.7 changed cache judgment logic; builds with caching may see unexpected behavior.","severity":"breaking","affected_versions":"0.0.7"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}