bundlesize

0.17.1 • Public • Published 2 months ago

Keep your bundle size in check

minimal setup

npm install bundlesize --save-dev

usage

Add it to your scripts in package.json

"scripts": {
  "test": "bundlesize"
}

Or you can use npx with NPM 5.2+.

npx bundlesize

configuration

1) Add the path and maxSize in your `package.json`.

By default the gzipped size is tested. You can use the compression option to change this. (gzip, brotli, or none).

{
  "name": "your cool library",
  "version": "1.1.2",
  "bundlesize": [
    {
      "path": "./dist.js",
      "maxSize": "3 kB"
    }
  ]
}

bundlesize also supports glob patterns

Example:

"bundlesize": [
  {
    "path": "./dist/vendor-*.js",
    "maxSize": "3 kB"
  },
  {
    "path": "./dist/chunk-*.js",
    "maxSize": "3 kB"
  }
]

This makes it great for using with applications that are bundled with another tool. It will match multiple files if necessary and create a new row for each file.

2) build status

build status

Currently works for Travis CI, CircleCI, Wercker, and Drone.

Authorize bundlesize for status access, copy the token provided.
Add this token as BUNDLESIZE_GITHUB_TOKEN as environment parameter in your CIs project settings.

(Ask me for help if you're stuck)