Skip to content

Latest commit

 

History

History
74 lines (54 loc) · 3.57 KB

CONTRIBUTING.md

File metadata and controls

74 lines (54 loc) · 3.57 KB

Contributing to React Flow

Hello there! So glad you want to help out with our documentation 🤗 You’re the best. Here’s a guide for how you can contribute to the project.

Our Contributing Philosophy

The direction of each of our libraries, which new features are added, and which are left out, is decided by the core team (sometimes referred to as a “cathedral” style of development). The core team is paid to do this work (see how here). With this model we ensure that the people doing the most work on the library are paid for their time and effort, and that we prevent the library from bloating.

That being said, our libraries are only interesting because of the people who make things with them Some of the most important and undervalued work in open source is from non-code contributions, and that is where we can use the most help from you.

How can I help?

The things we need the most help for the library and its community are:

🐛 Bug reports: We simply can’t catch them all. Check existing issues and discussions first, then create a new issue to tell us what’s up.

💬 Answering questions in our Discord Server and Github discussions. This is surprisingly high-impact for us! Folks always have questions and we can't always get round to them all.

🎬 Create tutorials for React Flow. Send them to us and we’ll happily share them!

✏️ Edit our docs: This repo contains the docs sites for both React Flow and Svelte Flow. If you notice a typo or think something can be clearer, you can let us know by opening an issue or PR here.

All interactions should be done with care following our Code of Conduct.

Enhancements

If you have an idea or suggestion for an enhancement to the React Flow library, please use the New Features discussion section. If you want to build it yourself, please reach out to us before you dive into a new pull request. The direction of React Flow and which new features are added are discussed in our Discord Server and in this Github discussions section, and in the end they are decided by the core team.

Talking to us first about the enhancement you want to build will be the most likely way to get your pull request into the library (see Our Contributing Philosophy above). We would hate to see you write code you’re proud of, just to learn that we’ve already been working on the same thing, or that we feel doesn’t fit into the core library.

Contact us

To ask about a possible enhancement, There are a few ways you can get in touch:

💫 Pull Requests

If you want to contribute improvements or new features we are happy to review your PR :)
Please use a meaningful commit message and add a little description of your changes.

  1. Install dependencies pnpm install
  2. Start dev server pnpm dev
  3. Test your changes with the existing examples or add a new one if it's needed for your changes
  4. Run tests pnpm test and add new new tests if you are introducing a new feature