There are several Github repositories as part of our project. They are all part of the hackathon:
- buidler-symfoni-demo
- fork and changes to buidler-react (this project)
- fork and changes to buidler-typechain
- buidler-plugins
- buidler-react-boilerplate
The files under src\defaults
are copied into new Symfoni projects.
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
We recommend developing Buidler plugins using yarn. To start working on your project, just run
npm install
Make sure to read our Plugin Development Guide to learn how to build a plugin, and our best practices to create high-quality plugins.
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.
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
.
Just run npm run buidl
️👷
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.