Contributing to React Native Paper
Code of Conduct
We want this community to be friendly and respectful to each other. Please read the full text so that you can understand what actions will and will not be tolerated.
Our Development Process
The core team works directly on GitHub and all work is public.
Working on your first pull request? You can learn how from this free series: How to Contribute to an Open Source Project on GitHub.
- Fork the repo and create your branch from
master(a guide on how to fork a repository).
yarn bootstrapto setup the developement environment.
- Do the changes you want and test them out in the example app before sending a pull request.
Commit message convention
We prefix our commit messages with one of the following to signify the kind of change:
fix: bug fixes, e.g. fix Button color on DarkTheme.
feat: new features, e.g. add Snackbar component.
refactor: code/structure refactor, e.g. new structure folder for components.
docs: changes into documentation, e.g. add usage example for Button.
test: adding or updating tests, eg unit, snapshot testing.
chore: tooling changes, e.g. change circle ci config.
BREAKING: for changes that break existing usage, e.g. change API of a component.
Our pre-commit hooks verify that your commit message matches this format when committing.
Linting and tests
flow for type checking,
prettier for linting and formatting the code, and
jest for testing. Our pre-commit hooks verify that the linter and tests pass when commiting. You can also run the following commands manually:
yarn flow: run flow on all files.
yarn typescript: run tests for typescript.
yarn lint: run eslint and prettier.
yarn test: run unit tests.
Sending a pull request
When you're sending a pull request:
- Prefer small pull requests focused on one change.
- Verify that
eslintand all tests are passing.
- Preview the documentation to make sure it looks good.
- Follow the pull request template when opening a pull request.
When you're working on a component:
- Follow the guidelines described in the official material design docs.
- Write a brief description of every prop when defining
type Propsto aid with documentation.
- Provide an example usage for the component (check other components to get a idea).
- Update the type definitions for Flow and Typescript if you changed an API or added a component.
Running the example
After you're done, you can run
yarn start or
expo start in the
example/ folder and scan the QR code to launch it on your device.
Working on documentation
The documentation is automatically generated from the flowtype annotations in the components. You can add comments above the type annotations to add descriptions. To preview the generated documentation, run
yarn start in the
Publishing a release
We use release-it to automate our release. If you have publish access to the NPM package, run the following from the master branch to publish a new release:
NOTE: You must have a
GITHUB_TOKEN environment variable available. You can create a GitHub access token with the "repo" access here.
You can report issues on our bug tracker. Please follow the issue template when opening an issue.
By contributing to React Native Paper, you agree that your contributions will be licensed under its MIT license.