netlify-plugin-docz-cache v0.3.3

Netlify Build Plugin: Persist the Docz Cache Between Builds

Persist the Docz cache between Netlify builds for huge build speed improvements! ⚡️ Based on netlify-plugin-gatsby-cache

Usage

Currently, there are two ways to install this plugin on your application:

Installing from Netlify UI

One-click install to add this to your Gatsby site

Installing from your project's code

You can also install it manually using netlify.toml. If you want to know more about file-based configuration on Netlify, click here.

Add the following lines to your project's netlify.toml file:

[build]
  publish = "public"

[[plugins]]
  package = "netlify-plugin-docz-cache"

Note: The [[plugins]] line is required for each plugin, even if you have other plugins in your netlify.toml file already.

How does it work?

This plugin determines the location of your .docz folder by looking at the publish folder configured for Netlify deployment. This means that if your Docz site successfully deploys, it will be cached as well with no config required! 🎉

How much of a difference does this plugin make in build times?

Each Gatsby site is different, so build times vary widely between them, but one common slowdown in Gatsby builds is processing and transforming images. Gatsby is smart enough to check if these transformations have already been done and skip them, but in order to get that benefit in a build pipeline (e.g. Netlify) the public and .cache directories need to be preserved between builds. That’s what this plugin does!

tl;dr: Repeat builds with lots of images will be much faster. With few or no images, the difference will be there, but it won’t be as pronounced.

Want to learn how to create your own Netlify Build Plugins?

Check out Sarah Drasner’s excellent tutorial!