{"id":21936,"library":"rollup-plugin-build-statistics","title":"rollup-plugin-build-statistics","description":"A Rollup plugin that tracks and logs build times to a JSON file, enabling teams to monitor build performance over time. Version 0.0.19 is the latest release (April 2021), part of a monorepo that also includes a webpack variant and a core package. It provides project-level configuration, daily summaries, and a web-based log analyzer. Unlike general logging plugins, it focuses specifically on build duration to help justify infrastructure improvements and detect configuration or hardware issues. The plugin is TypeScript-friendly with included type definitions.","status":"active","version":"0.0.19","language":"javascript","source_language":"en","source_url":"https://github.com/nemwiz/build-statistics-plugin","tags":["javascript","rollup-plugin","rollup-plugin-build-statistics","build-statistics","typescript"],"install":[{"cmd":"npm install rollup-plugin-build-statistics","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-build-statistics","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-build-statistics","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Default ESM export. CommonJS require works but may lack TypeScript type inference.","wrong":"const buildStatistics = require('rollup-plugin-build-statistics')","symbol":"buildStatistics","correct":"import buildStatistics from 'rollup-plugin-build-statistics'"},{"note":"TypeScript type import for plugin options. Only needed when using TypeScript.","wrong":null,"symbol":"BuildStatisticsOptions","correct":"import type { BuildStatisticsOptions } from 'rollup-plugin-build-statistics'"},{"note":"TypeScript type import for the plugin function, useful for advanced type annotations.","wrong":null,"symbol":"RollupPluginBuildStatistics","correct":"import type { RollupPluginBuildStatistics } from 'rollup-plugin-build-statistics'"}],"quickstart":{"code":"import buildStatistics from 'rollup-plugin-build-statistics';\n\nexport default {\n  input: './src/index.js',\n  output: {\n    file: 'dist/index.js',\n    format: 'cjs',\n  },\n  plugins: [\n    buildStatistics({\n      projectName: 'my-app',\n      logsDirectoryName: 'stats',\n      summaryLogFilename: 'build-stats-summary',\n    }),\n  ],\n};","lang":"typescript","description":"Example Rollup config integrating the build statistics plugin with all configuration options."},"warnings":[{"fix":"Add 'stats' to your .gitignore file.","message":"The plugin writes to the filesystem during builds. Ensure the output directory is writable and consider adding the stats folder to .gitignore.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Periodically delete old log files or implement a rotation strategy.","message":"Logs accumulate over time; disk usage may grow if not cleaned. The summary file overwrites daily, but individual logs persist.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use a unique name when importing if collisions occur: import customName from 'rollup-plugin-build-statistics'.","message":"plugin name 'buildStatistics' may conflict with other Rollup plugins if not renamed.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'npm install --save-dev rollup-plugin-build-statistics'.","cause":"Package not installed or missing from node_modules.","error":"Error: Cannot find module 'rollup-plugin-build-statistics'"},{"fix":"Use 'import buildStatistics from 'rollup-plugin-build-statistics' (no curly braces).","cause":"Default import used incorrectly; likely imported as { buildStatistics } instead of default.","error":"TypeError: buildStatistics is not a function"},{"fix":"Add projectName to the plugin options object.","cause":"Missing required option 'projectName' in plugin configuration.","error":"Error: \"projectName\" is required"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}