Contributing

Thanks for leading the charge! The easiest way to contribute is to report bugs or suggest new features.

Report bugs

Head on over to our Slack and let us know what’s up. We recommend the #bugs-troubleshoot-questions channel.

Squash bugs

We’re always trying to make our project better, but we need your help! Take a look at our GitHub issues for small to medium complexity projects and bugs that need fixing.

Suggest new features

We love your suggestions. First take a look at our roadmap to see if your idea is already planned. You might also consider checking out open issues on GitHub.

Otherwise, drop a line in our Slack and let us know what you’re thinking. We recommend the #feature-requests channel.

Write documentation

We have a lot of docs. We really hope they’re fun to read, but we know they can be improved.

The great news is that they’re fun to write, too! The easiest way to contribute is by scrolling to the bottom of the page you’d like to edit (maybe this one) and clicking the “Edit this page” link. You’ll be taken to GitHub where you can make your changes and submit a pull request.

If you like working in code, that’s great too! All of our docs are written in markdown, so you can just pull Mage from GitHub and start writing.

Community Support

If you’re already an adept Mager, we need your help! We’re looking for community members to help answer questions in our Slack. Check out the #bugs-troubleshoot-questions, #general, and #feature-requests channels to get started. Anything helps!

If you want to take it up a notch, check out our GitHub issues! We have a lot of open issues that need your help.

Backend development

We’re always looking for help with the Mage backend— that might look like refactoring code, adding new features, or fixing bugs.

Here’s an example of an amazing backend PR that drastically improved dbt functionality in Mage.

Check out our roadmap for small to large complexity projects that need your help!

Data integration

Mage supports data integration pipelines via the Singer spec. We’re always looking for help adding/updating our sources and destinations.

Here’s an example of a great community PR & here’s our docs on adding a source.

IO operations (SQL block) and templates

Want to help build awesome tools inside the pipeline builder page? Help out with our IO operations by adding new SQL blocks! Here’s a PR that implements a DuckDB IO Class.

The simplest way you can help is by adding data loader/exporter templates. Here’s an example PR that adds a few for DuckDB.

Frontend development

Want to help build the future of the Mage UI? Help out with our frontend development! We’re always looking for help with UI/UX, accessibility, and more. Checkout our frontend page for more info.