Contributing to NativeBase
Thanks for showing an interest in contributing to NativeBase. We are excited about our collaboration. The following is a set of guidelines that will make the journey memorable. Please spend several minutes reading these guidelines before you create an issue or pull request.
We have adopted a
that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.
All work on NativeBase happens directly on
. Both core team members and external contributors send pull requests which go through the same review process.
According to our
, we maintain canary
branches which are like development branches with the latest changes. If you send a pull request, please do it against the master
branch. Once you create your PR we will update the base branch to a more specific canary branch if required. Once a release candidate is ready, canary-patch
branch will be released as a rc release package and once a stable release test is done it will be released to native-base
package and merged into the master
We are using
for bug tracking. The best way to get your bug fixed is by using our
and providing reproduction steps with this
Before you report a bug, please make sure you've searched existing issues, and read our
Working on your first Pull Request? You can learn how from this free video series:
If you decide to fix an issue, please be sure to check the comment thread in case somebody is already working on a fix. If nobody is working on it at the moment, please leave a comment stating that you intend to work on it so other people don't accidentally duplicate your effort.
If somebody claims an issue but doesn't follow up for more than two weeks, it's fine to take over it but you should still leave a comment.
The core team is monitoring for pull requests. We will review your pull request and either merge it, request changes to it, or close it with an explanation.
Before submitting a pull request, please make sure the following is done:
Fork the repository and create your branch from the canary branch.
If you are fixing a bug, follow the naming convention and name your branch fix/<issue-number>.
If you are adding a new feature, follow the naming convention and name your branch feat/<feature-name>.
If you've fixed a bug or added code that should be tested, add tests!
Once your test passes, commit your changes and submit a pull request to the canary branch.
If you've fixed a bug, please provide a link to the issue so other people can follow up.
If you've added a new feature, please give a brief explanation what the feature is and why it's needed.
After cloning NativeBase, you can start working on your PRs by running the following commands:
Run yarn in the repository root.
Run cd example && yarn in the repository root.
Run yarn example start in the repository root to run the example app.
Now you can start making changes/fixes in src directory and check the changes output in the example app.