Skip to content
Buidler TypeScript plugin boilerplate
TypeScript Shell JavaScript
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
scripts Initial version Feb 3, 2019
src Update to the new plugin system May 13, 2019
test Update to the new plugin system May 13, 2019
.editorconfig Update to the new plugin system May 13, 2019
.env Initial version Feb 3, 2019
.gitignore
.travis.yml Update to the new plugin system May 13, 2019
LICENSE Initial version Feb 3, 2019
README-TEMPLATE.md Change badge url to refresh the github cache and add link. Jul 2, 2019
README.md Update README.md Jul 1, 2019
package-lock.json Update package-lock.json May 13, 2019
package.json Update buidler version May 13, 2019
tsconfig.json Update to the new plugin system May 13, 2019
tslint.json Update to the new plugin system May 13, 2019

README.md

Buidler TypeScript plugin boilerplate

This is a sample Buidler plugin written in TypeScript. Creating a Buidler plugin can be as easy as extracting a part of your config into a different file, wrapping it in a function and publishing it to npm.

This sample project contains an example on how to do that, but also comes with many more features:

  • A mocha test suit ready to use
  • TravisCI already setup
  • A package.json with scripts and publishing info
  • Examples on how to do different things

Installation

We recommend developing Buidler plugins using yarn. To start working on your project, just run

npm install

Plugin development

Make sure to read our Plugin Development Guide to learn how to build a plugin, and our best practices to create high-quality plugins.

Testing

Running npm run test will run every test located in the test/ folder. They use mocha and chai, but you can customize them.

We recommend creating unit tests for your own modules, and integration tests for the interaction of the plugin with Buidler and its dependencies.

Linting and autoformat

All all of Buidler projects use prettier and tslint.

You can check if your code style is correct by running npm run lint, and fix it with npm run lint:fix.

Building the project

Just run npm run buidl ️👷‍

README file

This README describes this boilerplate project, but won't be very useful to your plugin users.

Take a look at README-TEMPLATE.md for an example of what a Buidler plugin's README should look like.

You can’t perform that action at this time.