# size-limit

> CLI tool for Size Limit

Latest version **14.0.0** (published 2026-09-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install size-limit
pnpm add size-limit
yarn add size-limit
bun add size-limit
```

Provides the command `size-limit`.

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 14.0.0 |
| Published | 2026-09-15 |
| First published | 2017-06-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | ^22.19.0 \|\| ^24.5.0 \|\| >=26.0.0 |
| Dependencies | 2 |
| Unpacked size | 40.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 6944 |
| Author | Andrey Sitnik |
| Maintainers | ai |
| Keywords | budget, cli, esm, performance, performance budget, size-limit |

## Links

- npm: https://www.npmjs.com/package/size-limit
- Repository: https://github.com/ai/size-limit
- Homepage: https://github.com/ai/size-limit#readme
- Issues: https://github.com/ai/size-limit/issues
- npm.io page: https://npm.io/package/size-limit

## Dependencies (2)

- [lilconfig](https://npm.io/package/lilconfig.md) ^3.1.3
- [nanospinner](https://npm.io/package/nanospinner.md) ^1.2.2

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 14.0.0 (latest) — 2026-09-15
- 13.1.1 — 2026-09-12
- 13.0.3 — 2026-07-30
- 13.0.2 — 2026-07-28
- 13.0.1 — 2026-07-24
- 12.1.0 — 2026-04-13
- 12.0.1 — 2026-03-06
- 12.0.0 — 2025-11-28
- 11.2.0 — 2025-02-18
- 11.1.6 — 2024-09-30
- 11.1.5 — 2024-09-09
- 11.1.4 — 2024-05-16
- 11.1.3 — 2024-05-09
- 11.1.2 — 2024-03-21
- 11.1.1 — 2024-03-16
- … 170 more at https://npm.io/package/size-limit/versions

## README

# Size Limit CLI Tool

<img src="https://ai.github.io/size-limit/logo.svg" align="right"
     alt="Size Limit logo by Anton Lovchikov" width="120" height="178">

Size Limit is a performance budget tool for JavaScript. It checks every commit
on CI, calculates the real cost of your JS for end-users and throws an error
if the cost exceeds the limit.

- **ES modules** and **tree-shaking** support.
- Add Size Limit to **Travis CI**, **Circle CI**, **GitHub Actions**
  or another CI system to know if a pull request adds a massive dependency.
- **Modular** to fit different use cases: big JS applications
  that use their own bundler or small npm libraries with many files.
- Can calculate **the time** it would take a browser
  to download and **execute** your JS. Time is a much more accurate
  and understandable metric compared to the size in bytes.
- Calculations include **all dependencies and polyfills**
  used in your JS.

<img src="./img/example.png" alt="Size Limit CLI" width="738">

With **[GitHub action]** Size Limit will post bundle size changes as a comment
in pull request discussion.

<img src="https://raw.githubusercontent.com/andresz1/size-limit-action/master/assets/pr.png"
  alt="Size Limit comment in pull request about bundle size changes"
  width="686" height="289">

See **[full docs](https://github.com/ai/size-limit/)** on GitHub.

[GitHub action]: https://github.com/andresz1/size-limit-action

---

<img src="https://cdn.evilmartians.com/badges/logo-no-label.svg" alt="" width="22" height="16" />  Size Limit is built by <b><a href="https://evilmartians.com/">Evil Martians</a></b>, an American design and engineering consultancy for <b>developer tools, AI, and cybersecurity startups</b>.

---

---
_Source: https://npm.io/package/size-limit · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._