-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit 3778ea4
Showing
3 changed files
with
90 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
theme: jekyll-theme-cayman |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,89 @@ | ||
[![https://img.shields.io/npm/v/rollup-plugin-summary](https://img.shields.io/npm/v/rollup-plugin-summary)](https://www.npmjs.com/package/rollup-plugin-summary) | ||
[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/) | ||
[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) | ||
![https://img.shields.io/github/languages/top/yousifalraheem/rollup-plugin-summary](https://img.shields.io/github/languages/top/yousifalraheem/rollup-plugin-summary) | ||
![npm bundle size](https://img.shields.io/bundlephobia/minzip/rollup-plugin-summary) | ||
[![codecov](https://codecov.io/gh/yousifalraheem/rollup-plugin-summary/branch/master/graph/badge.svg)](https://codecov.io/gh/yousifalraheem/rollup-plugin-summary) | ||
[![Release](https://github.com/yousifalraheem/rollup-plugin-summary/actions/workflows/release.yml/badge.svg)](https://github.com/yousifalraheem/rollup-plugin-summary/actions/workflows/release.yml) | ||
|
||
# rollup-plugin-summary | ||
|
||
A rollup plugin that summarizes the output of the build. | ||
|
||
<img src="assets/sample_output.png" alt="Sample output" /> | ||
|
||
## Installation | ||
|
||
<hr/> | ||
|
||
### npm | ||
|
||
```terminal | ||
npm i -D rollup-plugin-summary | ||
``` | ||
|
||
### yarn | ||
|
||
```terminal | ||
yarn add -D rollup-plugin-summary | ||
``` | ||
|
||
<hr/> | ||
|
||
## Usage | ||
|
||
File: _`rollup.config.js`_ | ||
|
||
```javascript | ||
import summary from "rollup-plugin-summary"; | ||
|
||
export default { | ||
plugins: [summary()], | ||
}; | ||
``` | ||
|
||
|
||
|
||
<hr/> | ||
|
||
## Options | ||
|
||
These are the available options: | ||
|
||
| Name | Type | Description | Default | | ||
| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | | ||
| warnLow? | `number` | Minimum size in bytes to be highlighted in yellow.<br><sub>This is used to warn <span style="color: #ffcd39;">(in yellow)</span> about the files whom on the brink of exceeding the acceptable pre-defined file size</sub> | `5000` | | ||
| warnHigh? | `number` | Minimum size in bytes to be highlighted in red.<br><sub>This is used to alert <span style="color: #dc3545;">(in red)</span> about files that exceeded the acceptable pre-defined file size</sub> | `10000` | | ||
| totalLow? | `number` | Minimum total size in bytes to be highlighted in yellow.<br><sub>This is used to warn <span style="color: #ffcd39;">(in yellow)</span> about the total build size if it comes nearly below maximum acceptable pre-defined size</sub> | `200000` | | ||
| totalHigh? | `number` | Minimum total size in bytes to be highlighted in red.<br><sub>This is used to alert <span style="color: #dc3545;">(in red)</span> about the total build size if it exceeds the acceptable pre-defined size</sub> | `300000` | | ||
| showBrotliSize? | `boolean` | Should calculate and show Brotli size | `false` | | ||
| showMinifiedSize? | `boolean` | Should calculate and show Minified size | `false` | | ||
| showGzippedSize? | `boolean` | Should calculate and show Gipped size | `false` | | ||
|
||
<br/> | ||
|
||
Here is an example of how it's used: | ||
|
||
```javascript | ||
{ | ||
plugins: [ | ||
summary({ | ||
warnLow: 1000, | ||
warnHigh: 3000, | ||
showMinifiedSize: false, | ||
}), | ||
]; | ||
} | ||
``` | ||
|
||
<br/> | ||
|
||
<small>**Note:** File sizes will be evaluated against **high** values first. For example, if you've set `warnLow` | ||
and `warnHigh` to the same value, the files exceeding that number will be highlighted in red since the `warnHigh` is | ||
prioritized. Same goes for `totalLow` and `totalHigh`</small> | ||
|
||
<hr/> | ||
|
||
## License | ||
|
||
MIT |