Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
198 lines (142 loc) · 5.54 KB

CONTRIBUTING.md

File metadata and controls

198 lines (142 loc) · 5.54 KB
Raw

Contributing to Deen Bridge Backend

Thank you for your interest in contributing to Deen Bridge! We welcome contributions from the community to help make Islamic education more accessible.

Drips Wave Program

This repository participates in the Stellar Drips Wave bounty program. Contributors can earn rewards by resolving issues during Wave cycles. Everyone is welcome to contribute — no religious background or knowledge is required; our issues are regular engineering tasks.

How It Works

  1. Find an Issue: During an active Wave, browse this repo's issues in the Drips Wave app
  2. Apply: Apply to work on the issue through the Drips Wave app; the maintainer reviews applications and assigns one contributor
  3. Submit a PR: Complete the work and open a pull request (base branch dev) before the Wave ends
  4. Earn Points: Once the issue is marked resolved during the Wave, you earn its Points, which convert to rewards from the Wave pool

Complexity & Points

Points are assigned per issue by the maintainer in the Drips Wave dashboard using Drips' three complexity tiers:

Complexity Points Typical Scope
Trivial 100 Typos, small bug fixes, minor copy changes
Medium 150 Standard features or involved bug fixes
High 200 Complex features, refactors, integrations

Issues carry complexity:trivial, complexity:medium, or complexity:high labels that mirror these tiers.

Wave Rules

  • One contributor per issue — apply through the Drips Wave app; the maintainer reviews all applications and selects who is assigned
  • PRs must be linked to the issue
  • PRs must target the dev branch (not main)
  • Code must pass all tests
  • Follow the coding standards below

Getting Started

Prerequisites

  • Node.js 18+
  • MongoDB (local or Atlas)
  • npm or yarn
  • Git

Setup

# Fork the repository
# Clone your fork
git clone git@github.com:YOUR_USERNAME/dnb-backend.git
cd dnb-backend

# Add upstream remote
git remote add upstream git@github.com:Deen-Bridge/dnb-backend.git

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your values

# Start development server
npm run dev

Branching Strategy

Branch Purpose
main Stable, production-ready code — releases only
dev Active development — all pull requests must target dev

Maintainers periodically merge dev into main for releases. Pull requests opened against main will be asked to retarget dev.

Making Changes

  1. Create a branch from the latest dev:

    git fetch upstream
git checkout -b feature/your-feature-name upstream/dev

  2. Make your changes following our coding standards

  3. Test your changes:

    npm test

  4. Commit with a descriptive message:

    git commit -m "feat: add transaction retry logic"

  5. Push and create a PR with dev as the base branch:

    git push origin feature/your-feature-name

Coding Standards

JavaScript/Node.js

  • Use ES6+ features
  • Use async/await for asynchronous code
  • Follow existing file structure
  • Use descriptive variable and function names
  • Handle errors properly with try/catch

API Design

  • Follow RESTful conventions
  • Use appropriate HTTP status codes
  • Return consistent response formats
  • Document new endpoints

Database

  • Use Mongoose schemas for all models
  • Add proper indexes for queries
  • Validate input data
  • Use transactions where appropriate

Commits

We follow Conventional Commits:

  • feat: - New features
  • fix: - Bug fixes
  • docs: - Documentation changes
  • style: - Code style changes (formatting, etc.)
  • refactor: - Code refactoring
  • test: - Adding or updating tests
  • chore: - Maintenance tasks

Pull Request Guidelines

  1. Base Branch: open the PR against dev, never main
  2. Title: Use conventional commit format
  3. Description: Explain what and why
  4. Link Issue: Reference the issue number (Closes #123)
  5. Testing: Describe how you tested
  6. API Changes: Document any endpoint changes

Issue Guidelines

Reporting Bugs

Include:

  • Clear description of the bug
  • Steps to reproduce
  • Expected vs actual behavior
  • API endpoint affected
  • Request/response samples
  • Environment info

Requesting Features

Include:

  • Clear description of the feature
  • Use case and motivation
  • Proposed API design (if applicable)
  • Database schema changes (if applicable)

Security

  • Never commit secrets or credentials
  • Use environment variables for configuration
  • Validate and sanitize all input
  • Follow OWASP guidelines
  • Report security issues privately

Stellar Integration

When working on Stellar-related features:

  • Test on testnet first
  • Never log private keys or seeds
  • Verify transactions on-chain
  • Handle network errors gracefully
  • Follow Stellar best practices

Code of Conduct

  • Be respectful and inclusive
  • Welcome newcomers
  • Focus on constructive feedback
  • Contributors of all backgrounds and faiths are welcome

Questions?

  • Open a GitHub Discussion
  • Check existing issues and PRs
  • Review the documentation

License

By contributing, you agree that your contributions will be licensed under the MIT License.