Awesome Open Source
Awesome Open Source

Netlify Status

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 build

Runs 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 ava

Runs unit tests.

npm run lint

Lints and prettifies source files.

npm test

Runs both unit tests and linting.

npm run release

Publishes this plugin to npm.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,513,839
Shell (226,249
Nodejs (53,975
Linux (16,468
Plugin (9,961
Windows (9,740
Macos (8,929
Bash (6,999
Es6 (5,305
Serverless (4,764
Terminal (4,111
Ci (2,197
Netlify (2,022
Deployment (1,799
Continuous Integration (1,584
Build (1,167
Continuous Delivery (574
Continuous Deployment (488
Related Projects