2.3 KiB
Contributing to ReactXP
We welcome contributions to ReactXP! This gude provides some tips for a successful contributions.
For complex changes, we recommend filing a GitHub issue to start a discussion with project maintainers before implementing the change.
Pull Requests
Please make sure the following is done when submitting a pull request:
- Fork the repo and create your branch from
master
. - If you've added code that should be tested, add test code to the RXPTest sample app.
- If you've changed APIs, update the documentation files.
- Ensure the test suite passes.
- If you haven't already, complete the Contributor License Agreement ("CLA").
Testing Your Change
To test your change:
- Rebuild reactxp:
npm i
andnpm run build
- Switch to the RXPTest sample directory:
cd ./samples/RXPTest
- Update dependencies:
npm i
- Copy the locally-built reactxp library:
cp -r ../../dist/* ./node_modules/reactxp/dist
- Rebuild the test app:
npm run web-watch
ornpm run rn-watch
- If testing the web version:
- for desktop: open the test in the browser:
open ./index.html
and run the test - for mobile: run
npm run web -- -host YOUR_LOCAL_IP
then on your mobile enterhttp://YOUR_LOCAL_IP:8080
- If testing one or more RN versions, open the corresponding native project and build and run the test
Contributor License Agreement ("CLA")
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
You must sign a Contribution License Agreement (CLA) before your PR will be merged. This is a one-time requirement for Microsoft projects in GitHub. You can read more about Contribution License Agreements (CLA) on Wikipedia. You can sign the Microsoft Contribution License Agreement by visiting https://cla.microsoft.com/. Use your GitHub account to login.
Issues
We use GitHub issues to track bugs.
Coding Style
ReactXP is written in TypeScript and uses tslint to help enforce an internally-consistent coding style. Contributions should be consistent with this style.