discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

pastelsky/bundlephobia · source

Snapshot 0 · 2026-11-04T12:47:24Z · TypeScript · MIT

GitHub description at capture

🏋️ Find out the cost of adding a new frontend dependency to your project

README at capture

<p align="center">
    <img src="https://cdn.rawgit.com/pastelsky/bundlephobia/bundlephobia/client/assets/site-logo.svg" alt="" width="290" height="235" />
</p>
<p align="center">
  <img src="https://img.shields.io/npm/v/package-build-stats.svg" />
  <img src="https://img.shields.io/npm/l/package-build-stats.svg" />
  <a href="https://discord.gg/trbWvVet44">
    <img src="https://badgen.net/badge/icon/discord?icon=discord&label"/>
  </a>
</p>
<p align="center">
  <a href="https://bundlephobia.com"> bundlephobia.com </a> <br />
</p>
<p align="center">
  Know the performance impact of including an npm package in your app's bundle.
</p>

<p align="center">
    <b><a href="https://github.com/pastelsky/bundlephobia/issues/683"> Bundlephobia's looking for contributors and co-maintainers </a> </b>
</p>

## Features

- Works with ES6 packages
- Can build css and scss packages as well (beta)
- Reports historical trends
- See package composition

## Badges

- [badgen.net](https://badgen.net/#bundlephobia) - example size of react: ![react](https://badgen.net/bundlephobia/minzip/react)
- [shields.io](https://shields.io/#/examples/size) - example size of react: ![react](https://img.shields.io/bundlephobia/minzip/react.svg)

## Built using bundlephobia

- Size in browser - As seen on package searches at [yarnpkg.com](https://yarnpkg.com)
- [bundlephobia-cli](https://github.com/AdrieanKhisbe/bundle-phobia-cli) - A Command Line client for bundlephobia
- [importcost](https://atom.io/packages/importcost) - An Atom plugin to display size of imported packages
- [JS Bundle Size Cross-Browser Extension](https://github.com/vicrazumov/js-bundle-size) - Chrome and Firefox extension automatically adding package size to the github and npm pages.
- [npmcharts.com](https://npmcharts.com/compare/bundle-phobia-cli) - bundle size stats at top of page
- [Rollpkg](https://github.com/rafgraph/rollpkg) - A build tool to create packages with Rollup and TypeScript

## Support

Liked bundlephobia? Used it's API to build something cool? Let us know!

We could use some 💛 and sponsorship on –

<a href="https://github.com/sponsors/pastelsky">
  <img src="https://opencollective.com/bundlephobia/tiers/backer.svg"/>
</a>

## FAQ

#### 1. Why does search for package X throw `MissingDependencyError` ?

This error is thrown if a package `require`s a dependency without adding it in its dependencies or peerDependencies list. In the absence of such a definition, we cannot reliably report the size of the package - since we cannot resolve any information about the package.

In such a case, it's best to report an issue with the package author asking the missing package to be added to its `package.json`

#### 2. I see a `BuildError` for package X, but I'm not sure why.

You can see a detailed stack trace in your devtools console, and [open an issue](https://github.com/pastelsky/bundlephobia/issues/new) with the relevant details. Working on a more ideal solution for this.

## Contributing

See [Contributing](https://github.com/pastelsky/bundlephobia/blob/bundlephobia/CONTRIBUTING.md)

### Installation service

Build workers use `INSTALLATION_SERVICE_ENDPOINT` when configured. The singleton
installation service resolves registry tags and ranges immediately before install,
then queues exact-version package-manager work and reuses each completed
installation across requests and service restarts. Analyses write generated entries
and bundles to separate temporary artifact directories. Without the service,
package-build-stats installs packages locally as before.
When the endpoint is configured but unavailable, build workers return an error
instead of starting duplicate local installations.
Remote builds are bounded to ten minutes; abandoned subscriptions expire after
fifteen minutes, while released installations remain reusable for five minutes.

## Sponsors

<a href="https://www.digitalocean.com?utm_medium=opensource&utm_source=bundlephobia"><img width="100px" src="https://upload.wikimedia.org/wikipedia/commons/f/ff/DigitalOcean_logo.svg"/></a>