The Wallet Tracker Channel code utilizes Push Showrunners to operate the channel in the backend. The Showrunners framework is a scaffold that developers can use to build out notifications for their use cases. This framework provides the tools and helpers required for constructing the payload and sending the notification using the Push protocol infrastructure. Learn more here.
Before setting up the project locally, you need to:
- Create a channel. Head over to the Staging Push Dapp Channel Creation. If you need help setting up the channel, follow this tutorial.
- Install Docker: You can get Docker from the official Docker guide.
-
Clone the repository:
git clone https://github.com/push-protocol/Build-with-wallet-tracker.git
-
Navigate to the
push-showrunner-framework
folder:cd push-showrunner-framework/
-
Initialize Docker: For local ease of development, we use Docker. Make sure you have it installed. You can get Docker here.
docker-compose up
-
Install packages and set up environment variables: We have simplified this process for you. Use the
setup.js
script to complete the setup. Before that make sure you open up a new terminal and point to same folder i.e push-showrunner-framworknode setup.js
Make sure to enter the correct details. If anything goes sideways, check the newly created
.env
file. -
Start the project:
yarn run dev
You should now have the notification sending.
Before getting into contributing, please understand the folder structure and find where to make changes by reading the Contribution Guidelines.
Build with Wallet Tracker is an open-source project. We firmly believe in a completely transparent development process and value any contributions. We would love to have you as a member of the community, whether you are assisting us in bug fixes, suggesting new features, enhancing our documentation, or simply spreading the word.
- Bug Report: Please create a bug report if you encounter any errors or problems while utilizing the Push Protocol.
- Feature Request: Please submit a feature request if you have an idea or discover a capability that would make development simpler and more reliable.
- Documentation Request: If you're reading the Push documentation and believe that we're missing something, please create a docs request.
Not sure where to start? Join our Discord, and we will help you get started!
- Fork the repository: Create your own copy of it.
- Clone your personal copy onto your personal machine:
git clone https://github.com/YOUR_USERNAME/Build-with-wallet-tracker.git
- Raise an issue on GitHub repo: Briefly describe the issue or feature.
- Create a branch on your local machine: Name the branch as the issue name.
git checkout -b issue-name
- Make your changes: After making changes, commit them.
- Raise a PR in the main repo: Submit your pull request.
- Link the issue with PR: In the PR comment section, link the issue with
closes #Issue_number
.
Congratulations, you have successfully contributed to an open-source project. Sit back, relax, and watch your PR get merged. Cheers!