Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ovhemert/gatsby-plugin-zopfli
Gatsby plugin for preparing zopfli-compressed versions of assets
https://github.com/ovhemert/gatsby-plugin-zopfli
compress gatsby gatsby-plugin gzip zopfli
Last synced: 30 days ago
JSON representation
Gatsby plugin for preparing zopfli-compressed versions of assets
- Host: GitHub
- URL: https://github.com/ovhemert/gatsby-plugin-zopfli
- Owner: ovhemert
- License: mit
- Created: 2018-08-20T18:56:49.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-11-30T14:36:44.000Z (about 1 year ago)
- Last Synced: 2024-11-15T03:39:33.912Z (about 1 month ago)
- Topics: compress, gatsby, gatsby-plugin, gzip, zopfli
- Language: JavaScript
- Size: 683 KB
- Stars: 13
- Watchers: 3
- Forks: 7
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md
Awesome Lists containing this project
README
# gatsby-plugin-zopfli
[](https://github.com/ovhemert/gatsby-plugin-zopfli/actions)
[](https://www.codacy.com/app/ovhemert/gatsby-plugin-zopfli?utm_source=github.com&utm_medium=referral&utm_content=ovhemert/gatsby-plugin-zopfli&utm_campaign=Badge_Grade)
[](https://snyk.io/test/npm/gatsby-plugin-zopfli)
[](https://coveralls.io/github/ovhemert/gatsby-plugin-zopfli)
[](http://standardjs.com/)
Gatsby plugin for preparing zopfli-compressed gzip versions of assets.
The Zopfli Compression Algorithm is a new, open sourced data compression library. It creates a smaller output size, typically 3–8% smaller compared to zlib at maximum compression
The compression method is best suited for static web content, files that don't change that often and that generate a lot of traffic. That's because Zopfli uses two to three times more CPU time than zlib at maximum quality.
Files compressed with Zopfli can be decompressed with existing methods on the client and there will be no performance penalty at this end.
```bash
/webpack-runtime-cde5506958f1afc4d89e.js
```
becomes
```bash
/webpack-runtime-cde5506958f1afc4d89e.js.gz
```
## Requirements
This plugin wil only generate the compressed files. To see them been served to the client, your Gatsby website should run on a production server that supports GZip. The Gatsby development server **does not** serve the compressed versions.
## Installation
With npm:
```bash
npm install --save gatsby-plugin-zopfli
```
Or with Yarn:
```bash
yarn add gatsby-plugin-zopfli
```
## Usage
In your `gatsby-config.js` file add:
```javascript
module.exports = {
plugins: [
{
resolve: 'gatsby-plugin-zopfli'
}
]
}
```
By default, only `.css` and `.js` files are compressed, but you can override this with the `extensions` option.
```javascript
module.exports = {
plugins: [
{
resolve: 'gatsby-plugin-zopfli',
options: {
extensions: ['css', 'html', 'js', 'svg']
}
}
]
}
```
You can even place all the zopfli-compressed files in a dedicated directory (ex. `public/zopfli`):
```javascript
module.exports = {
plugins: [
{
resolve: 'gatsby-plugin-zopfli',
options: {
path: 'zopfli'
}
}
]
}
```
To customize compression, you can add optional parameters to the zopfli library: ([see here for details on various options)](https://github.com/pierreinglebert/node-zopfli#options)
```javascript
module.exports = {
plugins: [
{
resolve: 'gatsby-plugin-zopfli',
options: {
path: 'zopfli',
numiterations: 25
}
}
]
}
```
For diagnostic information, you can enable verbose logging:
```javascript
module.exports = {
plugins: [
{
resolve: 'gatsby-plugin-zopfli',
options: {
verbose: true
}
}
]
}
```
## Maintainers
Osmond van Hemert
[](https://github.com/ovhemert)
[](https://ovhemert.dev)
## Contributing
If you would like to help out with some code, check the [details](./docs/CONTRIBUTING.md).
Not a coder, but still want to support? Have a look at the options available to [donate](https://ovhemert.dev/donate).
## Sponsors
[](https://www.browserstack.com/)
## License
Licensed under [MIT](./LICENSE).
_NOTE: This plugin only generates output when run in `production` mode!_