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
main(a guide on how to fork a repository).
yarn bootstrapon the root level, to setup the development environment.
- Do the changes you want and test them out in the example app before sending a pull request.
Commit message convention
We follow the conventional commits specification for our commit messages:
fix: bug fixes, e.g. fix Button color on DarkTheme.
feat: new features, e.g. add Snackbar component.
refactor: code refactor, e.g. new folder structure 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 circleci config.
BREAKING CHANGE: 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
typescript 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 typescript: type-check files with
yarn lint: lint files with
yarn test: run unit tests with
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 example start in the project root (or
expo start in the
example/ folder) and scan the QR code to launch it on your device.
To run the example on web, run
yarn example web in the project root.
Working on documentation
The documentation is automatically generated from the TypeScript annotations in the components. You can add comments above the type annotations to add descriptions. To preview the generated documentation, run
yarn docs start in the project root.
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 main 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.