|
| 1 | +--- |
| 2 | +sidebar_title: "Contribution Guide" |
| 3 | +--- |
| 4 | + |
| 5 | +## How can I contribute to web3-onboard? |
| 6 | + |
| 7 | +### Reporting Bugs |
| 8 | + |
| 9 | +Before creating an issue for a bug, please do a search through the Web3 Onboard issues to make sure that one has not already been created. You may find that someone else has run in to that issue and there may be a fix that has been released in a newer update. |
| 10 | + |
| 11 | +If an issue does not exist for the bug that you want to report, go ahead and create an issue, making sure to add as much detail as possible and following the issue template instructions. |
| 12 | + |
| 13 | +Once an issue has been created, one of the Web3 Onboard maintainers will take a look and will respond typically within a few days. The initial response will usually just acknowledge the issue and will indicate what will happen next. |
| 14 | + |
| 15 | +### Pull Requests |
| 16 | + |
| 17 | +If there is a feature or change that you would like to see in Web3 Onboard, you can fork the repo and make a pull request to have the changes merged in to the main repo and released as part of the official packages. |
| 18 | + |
| 19 | +Once a PR is created, one of the Web3 Onboard maintainers will acknowledge the PR and add it to our sprint planning to be reviewed as soon as possible. |
| 20 | + |
| 21 | +### How can I get a new wallet added? |
| 22 | + |
| 23 | +Web3 Onboard does not require a wallet to be a part of the main codebase to work, so a wallet module can be created and used for your project without needing anything to happen within the Web3Onboard codebase. If you would like the wallet to be part of the official Web3 Onboard packages and repo, then create a pull request, and make sure to add any documentation updates by creating a docs pull request. |
| 24 | + |
| 25 | +If the wallet you are adding is an “injected” wallet (browser extension, mobile dapp browser wallet), you can add a wallet to the injected wallets module. [See here for an example of an injected wallets pull request.](https://github.com/blocknative/web3-onboard/pull/1177/files) You should also add the wallet to the [natively supported injected wallets list](https://onboard.blocknative.com/docs/packages/injected#injected-wallets-supported-natively). |
| 26 | + |
| 27 | +Otherwise if the wallet you are adding requires adding dependencies and initialization (SDK), then you will need to create a new package in the Web3 Onboard monorepo. [See here for an example of a pull request.](https://github.com/blocknative/web3-onboard/pull/1238/files) |
| 28 | + |
| 29 | +If you cannot write the code yourself to add a new wallet, then go ahead and create a feature request issue which may be considered by the maintainers or someone else in the community. |
| 30 | + |
| 31 | +### Documentation contributions |
| 32 | + |
| 33 | +In order to contribute to the docs, you'll have to create a PR on the [docs-develop branch](https://github.com/blocknative/web3-onboard/tree/docs-develop). If you contribute code, you should definitely document it appropriately. We highly encourage the community to improve web3-onboard docs, if you have any questions don't hesitate to reach out. |
| 34 | + |
| 35 | +## Feedback |
| 36 | + |
| 37 | +Jump in to our discord server to provide any feedback you feel is worth sharing. Could the docs be improved? Did you have trouble integrating? Feature requests etc. |
| 38 | + |
| 39 | +## Support |
| 40 | + |
| 41 | +For general questions about how to use Web3 Onboard you can first check out our [docs](https://onboard.blocknative.com/docs/overview/introduction#features) to see if there is an answer there, or you can head to our [Discord](https://discord.com/invite/KZaBVME) for support from the Blocknative team |
0 commit comments