Template repository to create new Netlify Build plugins.
The main Build plugins documentation can be found here.
Initialization
To create a repository with a new Netlify Build plugin, click on the "Use this template" button on top of the page.
The repository name should start with netlify-plugin-, for example
netlify-plugin-gatsby.
Clone the repository locally.
Inside the new repository directory, run the following command.
npm run init
Some questions will be asked. Make sure the plugin's name matches the repository name.
Among other things, this will replace this README.md with the plugin's user
documentation. Development documentation will still be available in the
CONTRIBUTING.md.
Finally, create a Netlify Site with the repository. This will automatically run
your Build plugins in Netlify Build on every git push, as a smoke test.
You can also add a Netlify status badge.
Usage
The plugin's logic should be added to ./src/index.js.
Comments in that file will guide you through the creation of a Build plugin.
Development tasks
The following development tasks are available. Please check the
package.json scripts property for more information.
npm run buildRuns a Netlify Build locally with the current plugin. This can be used for debugging and manual tests.
The local Build configuration file is netlify.toml and can be
modified.
npm run avaRuns unit tests.
npm run lintLints and prettifies source files.
npm testRuns both unit tests and linting.
npm run releasePublishes this plugin to npm.