Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

performance-budgets: Keep your apps with budgets

No more excuses not to set performance budgets. performance-budgets gives you a simple way to check and stay on top of performance. Easy to run and configure with your custom budgets.

Travis CodeCov MIT License PRs Welcome

Watch on GitHub Star on GitHub Tweet


Check budgets with one command...

docker run --rm boyney123/performance-budgets

Features: Set performance budgets, override lighthouse configuration, easily run on CI, and more...

Read the Docs | Edit the Docs

The problem

Every feature we add has an impact on the performance of our applications and can effect the end user experience. Performance budgets are a great way to keep your applications fast.

There is currently a lot of work going on around web performance and some new awesome features coming out.

Addy Osmani has written a great article on performance budgets, and he says...

Performance budgets usher a culture of accountability that enable stakeholders to weigh the impact to user-centric metrics of each change to a site. Talk to your organization and see if you can get by in to adopt performance budgets for your projects. If it's worth getting fast, it's worth staying fast. ❤️

Lighthouse has recently come out with a great feature that allows you to capture and set budgets on a given website.

This solution

performance-budgets was built from inspiration from these articles and built to give developers an easy way to get started with performance budgets.

performance-budgets was built with continuous-integration in mind, allowing developers to run one command to check budgets against any given url.

In the future we hope to add more features to the project and start to monitor other stats.





If you have any questions, features or issues please raise any issue or pull requests you like.


If you find this tool useful, feel free to buy me a 👍

Buy a drink