Registry / devops / rollup-plugin-build-statistics

rollup-plugin-build-statistics

library0.0.19jsnpmunverified

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.

devops observability

npm install rollup-plugin-build-statistics

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-BUIL

rollup-plugin-build-statistics

devopsjavascriptv0.0.19

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

buildStatistics

✓ import buildStatistics from 'rollup-plugin-build-statistics'

✗ const buildStatistics = require('rollup-plugin-build-statistics')

Default ESM export. CommonJS require works but may lack TypeScript type inference.

BuildStatisticsOptions

✓ import type { BuildStatisticsOptions } from 'rollup-plugin-build-statistics'

TypeScript type import for plugin options. Only needed when using TypeScript.

RollupPluginBuildStatistics

✓ import type { RollupPluginBuildStatistics } from 'rollup-plugin-build-statistics'

TypeScript type import for the plugin function, useful for advanced type annotations.

Example Rollup config integrating the build statistics plugin with all configuration options.

import buildStatistics from 'rollup-plugin-build-statistics'; export default { input: './src/index.js', output: { file: 'dist/index.js', format: 'cjs', }, plugins: [ buildStatistics({ projectName: 'my-app', logsDirectoryName: 'stats', summaryLogFilename: 'build-stats-summary', }), ], };

Debug

Known issues

gotchaThe plugin writes to the filesystem during builds. Ensure the output directory is writable and consider adding the stats folder to .gitignore.

fix

Add 'stats' to your .gitignore file.

affects: >=0.0.0

gotchaLogs accumulate over time; disk usage may grow if not cleaned. The summary file overwrites daily, but individual logs persist.

fix

Periodically delete old log files or implement a rotation strategy.

affects: >=0.0.0

gotchaplugin name 'buildStatistics' may conflict with other Rollup plugins if not renamed.

fix

Use a unique name when importing if collisions occur: import customName from 'rollup-plugin-build-statistics'.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'rollup-plugin-build-statistics'

Package not installed or missing from node_modules.

fix

Run 'npm install --save-dev rollup-plugin-build-statistics'.

TypeError: buildStatistics is not a function

Default import used incorrectly; likely imported as { buildStatistics } instead of default.

fix

Use 'import buildStatistics from 'rollup-plugin-build-statistics' (no curly braces).

Error: "projectName" is required

Missing required option 'projectName' in plugin configuration.

fix

Add projectName to the plugin options object.

Upgrade

Version history

0.0.19latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/nemwiz/build-statistics-plugin ↗

packagehttps://www.npmjs.com/package/rollup-plugin-build-statistics ↗