Skip to content

Latest commit

 

History

History
129 lines (77 loc) · 4.25 KB

CONTRIBUTING.md

File metadata and controls

129 lines (77 loc) · 4.25 KB

Contributing to Outerbridge

As the old chinese saying goes: 礼轻情意重 (It's the thought that counts), we appreciate any form of contributions.

⭐ Star

Star and share the Github Repo.

🙋 Q&A

Search up for any questions in Q&A section, if you can't find one, don't hesitate to create one. It might helps others that have similar question.

🙌 Share Workflow

Yes! Sharing how you use Outerbridge is a way of contribution. Export your workflow as JSON, attach a screenshot and share it in Show and Tell section.

💡 Ideas

Ideas are welcome such as new feature, apps integration, and blockchain networks. Submit in Ideas section.

🐞 Report Bugs

Found an issue? Report it.

👨‍💻 Contribute to Code

Not sure what to contribute? Some ideas:

  • Create new node/credential component
  • Update existing components such as extending functionality, fixing bugs
  • Add new blockchain network to support
  • Unit tests and E2E tests

Developers

Outerbridge has 3 different modules in a single mono repository.

  • server: Node backend to serve API logics
  • ui: React frontend
  • components: Nodes and Credentials of applications

Prerequisite

  • Install MongoDB here
  • Install Yarn
    npm i -g yarn

Step by step

  1. Fork the official Outerbridge Github Repository.

  2. Clone your forked repository.

  3. Create a new branch, see guide. Naming conventions:

    • For feature branch: feature/<Your New Feature>
    • For bug fix branch: bugfix/<Your New Bugfix>.
  4. Switch to the newly created branch.

  5. Go into repository folder

    cd Outerbridge
  6. Install all dependencies of all modules:

    yarn install
  7. Build all the code:

    yarn build
  8. Start the app on http://localhost:3000

    yarn start
  9. For development, run

    yarn dev

    Any changes made in packages/ui or packages/server will be reflected on http://localhost:8080

    For changes made in packages/components, run yarn build again to pickup the changes.

  10. After making all the changes, run

    yarn build

    and

    yarn start

    to make sure everything works fine in production.

  11. Commit code and submit Pull Request from forked branch pointing to Outerbridge master. Example PR.

📖 Contribute to Docs

Contribute to Outerbridge docs if there is any mistake, confusion or grap.

🏷️ Pull Request process

A member of the Outerbridge team will automatically be notified/assigned when you open a pull request. You can also reach out to us on Discord.

📃 Contributor License Agreement

Before we can merge your contribution you have to sign our Contributor License Agreement (CLA). The CLA contains the terms and conditions under which the contribution is submitted. You need to do this only once for your first pull request. Keep in mind that without a signed CLA we cannot merge your contribution.

📜 Code of Conduct

This project and everyone participating in it are governed by the Code of Conduct which can be found in the file. By participating, you are expected to uphold this code. Please report unacceptable behavior to [email protected] or [email protected].