Skip to content

zeroby0/netlify-plugin-11ty

Repository files navigation

Netlify 11ty Build Plugin

A plugin to make building with Eleventy and Netlify a joy!

Speed up your builds ⚡

Install

Install plugin via npm as dependency:

Note: Till 11ty/eleventy-img#116 is merged, please use this fork instead of @11ty/eleventy-img.

npm r @11ty/eleventy-img npm i zeroby0/eleventy-img#cache npm i netlify-plugin-11ty

And add the plugin to your netlify.toml file

[[plugins]] package = "netlify-plugin-11ty"

Configuration

Optionally, you can configure the plugin to suit your project's needs.

Example:

[[plugins]] package = "netlify-plugin-11ty" [plugins.inputs] cache_img = './img' cache_img_httpHeader = true cache_assets = '../.cache' cache_other = []

The following inputs options are available:

cache_img

Type: String or Array of Strings
Default: './img' (relative to the publish directory)

The folder(s) in which files generated by @11ty/eleventy-img are stored, relative to publish directory. Can be a string or an array of strings.

If set to false, files generated by @11ty/eleventy-img are not saved in Netlify cache.

cache_img_httpHeader

Type: Boolean
Default: true

If set to true, a files generated by @11ty/eleventy-img will be served with http header cache-control: public, max-age=31536000, immutable.

This should be safe to do as the file names have a hash calculated using file content and Sharp Options.

cache_assets

Type: String or Array of Strings
Default: '../.cache' (relative to the publish directory)

The folder(s) in which remote assets fetched by @11ty/eleventy-cache-assets are cached, relative to publish directory. Can be a string or an array of strings.

If set to false, assets fetched by @11ty/eleventy-cache-assets are not saved in Netlify cache.

cache_other

Type: String or Array of Strings
Default: [] (relative to the publish directory)

Any other folder(s) you'd like to cache across Netlify builds. If these folders exist before restoring Nelify cache, they will be replaced with cached folders.

Benchmarks

Run No cache persistence With cache persistence
1st run (empty cache) 11.74 seconds 11.52 seconds
2nd run (filled cache) 11.32 seconds 131.82 milliseconds

Read more

Recommended Netlify plugins

Bugs and Feature Requests

Please create an issue :)

License

MIT

If you need this repository with a different License, please create an issue.