Skip to content

Latest commit

Β 

History

History
70 lines (53 loc) Β· 1.7 KB

File metadata and controls

70 lines (53 loc) Β· 1.7 KB

🀝 Contributing to Stellar GreenPay

Thank you for helping build transparent climate finance! Every contribution β€” big or small β€” matters.


🍴 Fork & Set Up

git clone https://github.com/YOUR_USERNAME/stellar-greenpay.git
cd stellar-greenpay
git remote add upstream https://github.com/your-org/stellar-greenpay.git
chmod +x scripts/setup-dev.sh && ./scripts/setup-dev.sh

🌿 Branch Naming

feature/impact-nft-badges
fix/leaderboard-sort-bug
docs/soroban-contract-guide
contracts/implement-co2-tracking
chore/upgrade-stellar-sdk

πŸ’¬ Commit Style

feat: add donor leaderboard page
fix: correct CO2 offset calculation
docs: update contract deployment guide
contracts: implement impact NFT minting
chore: upgrade soroban-sdk to 21.0

πŸ”ƒ Pull Request Process

  1. Branch from main
  2. Make your changes and test on Testnet
  3. Open a PR against main
  4. Fill in the PR template and link the issue (Closes #123)
  5. Wait for review β€” we respond within 48 hours

πŸ“ Project Structure

stellar-greenpay/
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ components/     ← Reusable UI components
β”‚   β”œβ”€β”€ pages/          ← Next.js routes
β”‚   β”œβ”€β”€ lib/            ← Stellar SDK + wallet + API helpers
β”‚   └── utils/          ← Types, formatting, constants
β”œβ”€β”€ backend/
β”‚   └── src/
β”‚       β”œβ”€β”€ routes/     ← Express routes
β”‚       β”œβ”€β”€ services/   ← Business logic
β”‚       └── middleware/ ← Auth, rate limiting
β”œβ”€β”€ contracts/          ← Soroban smart contracts (Rust)
└── docs/               ← Architecture & API docs

Look for good first issue labels for beginner-friendly tasks!