Netlify Next.js cache

Cache the Next.js build folder in Netlify builds.

A popular Netlify build plugin.

Usage

This is a Netlify build plugin, which will run during your Netlify builds. You can learn more about Netlify Build Plugins in the Netlify docs.

If you want to manually install the plugin add the following lines to your netlify.toml file:

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

Next, from your project's base directory, use yarn, npm, or any other Node.js package manager to add this plugin to devDependencies in package.json.

yarn add -D netlify-plugin-cache-nextjs

If you want to configure the plugin, you can do this in your netlify.toml file:

[[plugins]]
package = "netlify-plugin-cache-nextjs"
    # These options will cache the build directory at `${NETLIFY_BASE}/frontend/.next-build`
    [plugins.inputs]
    # The path to the build directory
    build_dir_path = "frontend"
    # Custom build directory if you aren't using `.next` (https://nextjs.org/docs/api-reference/next.config.js/setting-a-custom-build-directory)
    custom_build_dir_name = ".next-build"

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

Contributing

Prequisites

This project uses any Node.js version Netlify supports (8-13). For best results use the latest Node.js LTS version.

This project uses Yarn to install dependencies, although you can use another package manager like npm or pnpm.

yarn install
# or `npm install`
# or `pnpm install`

Building

Run the build script to compile and optimize the TypeScript code into the dist folder.

Style

This project uses Prettier and XO.

You can run Prettier in the project with this command:

yarn run style

You can run XO with this command:

yarn run lint

Note that XO will also error if you have TypeScript errors, not just if your formatting is incorrect.

Linting

This project uses XO (which uses ESLint and some plugins internally) to perform static analysis on the TypeScript. It reports things like unused variables or not following code conventions.

yarn run lint

Note that XO will also error if you have incorrect formatting, not just if your TypeScript code has errors.