# siddharthkp/bundlesize

Keep your bundle size in check

Repository: https://github.com/siddharthkp/bundlesize
Canonical: https://ross.abutalabs.com/products/bundlesize
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2026-07-29T12:28:26+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 8, longevity 100
- inputs: {"age_days": 3354, "days_push": 35, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4474, forks 176 (observed 2026-08-28T04:08:51.030161+00:00)

## What it is
bundlesize is an npm CLI tool that checks whether your JavaScript bundle files stay under configured size limits, with gzip or brotli compression options and glob pattern matching. It integrates into test scripts and CI to fail builds when bundles exceed their maxSize thresholds.

## Use cases
- keep my javascript bundle size under a limit in ci
- fail the build if vendor.js exceeds 30kb
- track bundle size of my npm library
- check gzipped or brotli bundle sizes
- monitor bundle sizes with hashed filenames using glob patterns

## When to choose
- you ship a JS library or frontend app and want automated bundle size budgets in CI
- you need gzip/brotli-compressed size checks with glob matching for hashed build outputs

## When to avoid
- you need full bundle analysis with visual breakdowns of what's inside the bundle (use webpack-bundle-analyzer)
- your project is not JavaScript/Node-based

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: benchmarking, ci-cd, developer-tools
- domain: frontend, web-development, developer-tools, performance
- platform: cli, cross-platform
- tags: bundle-size, webpack, javascript, build-monitoring, npm, nodejs

## Member repositories
- siddharthkp/bundlesize (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:51.030161+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:20:35.574877+00:00, confidence not recorded.
  - readme: https://github.com/siddharthkp/bundlesize (fetched 2026-08-28T04:08:51.030161+00:00, sha b86803713ae0)
  - registry_npm: https://registry.npmjs.org/bundlesize (fetched 2026-08-29T09:07:21.415298+00:00, sha 699a354b6809)
- Data as of 2026-08-30T08:39:29.467469+00:00.