https://github.com/mcataford/packwatch

📦👀 Keep an eye on your packages' footprint
https://github.com/mcataford/packwatch

dependencies developer-tools devtools footprint node-package npm package package-size

Last synced: 2 months ago
JSON representation

📦👀 Keep an eye on your packages' footprint

• Host: GitHub
• URL: https://github.com/mcataford/packwatch
• Owner: mcataford
• License: mit
• Created: 2020-02-29T22:52:41.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-05-28T18:11:42.000Z (7 months ago)
• Last Synced: 2024-05-29T00:05:14.638Z (7 months ago)
• Topics: dependencies, developer-tools, devtools, footprint, node-package, npm, package, package-size
• Language: TypeScript
• Size: 3.11 MB
• Stars: 4
• Watchers: 0
• Forks: 1
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 📦 PackWatch 👀

[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](#contributors-)

> It ain't easy being tiny.

[![codecov](https://codecov.io/gh/mcataford/packwatch/branch/master/graph/badge.svg)](https://codecov.io/gh/mcataford/packwatch)

![packwatch CI](https://github.com/mcataford/packwatch/workflows/packwatch%20CI/badge.svg)

> # ✈️ Moved away!

>

> This project has moved away from Github and is now hosted [elsewhere](https://forge.karnov.club/marc/packwatch).

## Overview

`packwatch` is inspired by what projects like [`bundlewatch`](https://github.com/bundlewatch/bundlewatch) do for webpack bundle size monitoring and applies the same general idea to monitor your node packages' tarball sizes across time and help avoid incremental bloat. Keeping your applications as trim as possible is important to provide better experiences to users and to avoid wasting system resources, and being cognizant of the footprint of the packages you put out there is paramount.

Using `packwatch`, you can track your package's expected size, packed and unpacked, via a manifest comitted along with your code. You can use it to define an upper limit for your package's size and validate that increases in package footprint are warranted and not accidental.

## Installation

Installing `packwatch` is easy as pie:

```

yarn add packwatch -D

```

or 

```

npm install packwatch --save-dev

```

While you can install `packwatch` as a global package, it's better to include it as a devDependency in your project.

## Usage

`packwatch` tracks your packages' size via its `.packwatch.json` manifest. To get started, call `packwatch` at the root of your project: a fresh manifest will be generated for you using your current package's size as the initial upper limit for package size.

Once a manifest file exists, calling `packwatch` again will compare its data to the current state of your package. Every time `packwatch` compares your code to the manifest, it will update the last reported package size statistics it contains, but not the limit you have set.

At any time, you can update the limit specified in your manifest by using the `--update-manifest` flag:

```

packwatch --update-manifest

```

Just commit your `.packwatch.json` manifest and you're good to go!

Check out [Packwatch's best practices tips and tricks](https://github.com/mcataford/packwatch/blob/master/BEST_PRACTICES.md) for some advice on how to make the most of it!

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    
Marc Cataford
🤔 💻 🚇 ⚠️ 📖

    
Michael Rose
🚇 📖 💻

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!