🎉 Thank you for being interested in contributing to Aragon! 🎉
Feel welcome and read the following sections in order to know how to ask questions and how to work on something.
There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into the project.
All members of our community are expected to follow our Code of Conduct. Please make sure you are welcoming and friendly in all of our spaces.
Unsure where to begin contributing to Aragon?
You can start with a Good First Issue.
Good first issues are usually for small features, additional tests, spelling / grammar fixes, formatting changes, or other clean up.
Start small, pick a subject you care about, are familiar with, or want to learn.
If you're not already familiar with git or Github, here are a couple of friendly tutorials: First Contributions, Open Source Guide, and How to Contribute to an Open Source Project on GitHub.
An architecture guide is available for the Aragon client's code bases to help guide you towards your first contribution. You may especially find the guide for setting up your local development environment useful!
If you see a problem, you can report it in our issue tracker.
Please take a quick look to see if the issue doesn't already exist before filing yours.
Do your best to include as many details as needed in order for someone else to fix the problem and resolve the issue.
If you find a security vulnerability, do NOT open an issue. Email security@aragon.org instead.
In order to determine whether you are dealing with a security issue, ask yourself these two questions:
- Can I access or steal something that's not mine, or access something I shouldn't have access to?
- Can I disable something for other people?
If the answer to either of those two questions are "yes", then you're probably dealing with a security issue. Note that even if you answer "no" to both questions, you may still be dealing with a security issue, so if you're unsure, please send a email.
If you're interested in the smart contracts underlying Aragon, a bug bounty program with payouts up to $50,000 is available for rewarding contributors who find security vulnerabilities.
- Find an issue that you are interested in.
- You may want to ask on the issue or in the Aragon Client Spectrum channel if anyone has already started working on the issue.
- Fork and clone a local copy of the repository.
- Make the appropriate changes for the issue you are trying to address or the feature that you want to add.
- Push the changes to the remote repository.
- Submit a pull request in Github, explaining any changes and further questions you may have.
- Wait for the pull request to be reviewed.
- Make changes to the pull request if the maintainer recommends them.
- Celebrate your success after your pull request is merged!
It's OK if your pull request is not perfect (no pull request is). The reviewer will be able to help you fix any problems and improve it!
You can also edit a page directly through your browser by clicking the "EDIT" link in the top-right corner of any page and then clicking the pencil icon in the github copy of the page.
Windows users may need to install the windows-build-tools before installing this project's dependencies.
For local development, where you may want to use a local version of aragonUI or connect to a locally running instance of aragon-apps, you should follow the frontend development setup guide.
In the future, we will improve this flow to make it much easier to get started.
We use prettier and eslint to automatically lint and format the project. An npm run lint script is provided to automatically run the linter, and commit hooks are automatically installed to run the linter on commits and prettier on pushes.
We generally avoid adding external dependencies if they can be ported over easily, due to numerous NPM-related security issues in the past (e.g. event-stream).
If you need help, please reach out to Aragon core contributors and community members in the Aragon Client Spectrum channel. We'd love to hear from you and know what you're working on!