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.

Code of Conduct

We have adopted a

Code of conduct

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.

Open Development

All work on NativeBase happens directly on

GitHub

. Both core team members and external contributors send pull requests which go through the same review process.

Branch Organization

According to our

release schedule

, 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 or canary-minor 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.

Bugs

We are using

GitHub Issues

for bug tracking. The best way to get your bug fixed is by using our

issue helper

and providing reproduction steps with this

template.

Before you report a bug, please make sure you've searched existing issues, and read our

FAQ.

Your First Pull Request

Working on your first Pull Request? You can learn how from this free video series:

How to Contribute to an Open Source Project on GitHub

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.

Sending a PR

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.

Development Workflow

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.

Setup NativeBase Provider

Creating a Universal App with NativeBase and Solito

Quick Nav