🌱 Harvesta — Plant Trees. Track Impact. Offset Carbon.

A decentralised tree-planting platform on Stellar where anyone can pay farmers and individuals to plant trees — anonymously or with full carbon-offset tracking — and planters upload real-world progress with a unique tree ID.

Proudly supported by Fundable Finance.

---

What is Harvesta?

Harvesta connects tree sponsors with on-the-ground planters (farmers, community groups, individuals) through a transparent, blockchain-backed payment system built on Stellar using Soroban smart contracts.

You can:

• Sponsor a tree — pay a planter to plant and care for a tree on your behalf.
• Go anonymous — make a one-time donation with no account required.
• Track your forest — create an account, get a unique tree ID for every tree you sponsor, and follow its growth through planter-uploaded photo and GPS updates.
• Measure your impact — the platform calculates estimated CO₂ offset per tree species and shows your cumulative carbon footprint reduction.

Planters receive instant Stellar payments the moment a tree is verified, with no banks, no delays, and no middlemen.

---

How It Works

Sponsor                   Harvesta Platform              Planter
  │                              │                          │
  │── Choose species, qty ──────>│                          │
  │── Pay in XLM / USDC ────────>│                          │
  │                              │── Escrow in contract ───>│
  │                              │                          │── Plant tree
  │                              │                          │── Upload photo + GPS
  │                              │<── Progress update ──────│
  │<── Carbon dashboard update ──│                          │
  │                              │── Release payment ──────>│

1. Sponsor selects tree species, quantity, region, and payment method (XLM or USDC).
2. Smart contract holds funds in escrow, mints a unique Tree NFT ID.
3. Planter receives the job, plants the tree, and uploads timestamped photo + GPS proof.
4. Contract releases payment to planter upon verification.
5. Sponsor dashboard shows live tree progress, species info, and CO₂ offset estimate.

---

Features

Feature	Description
🌳 Sponsor a Tree	Pay any planter to plant a tree on your behalf
👤 Anonymous Donations	One-time payment, no account needed
🆔 Unique Tree ID	Each sponsored tree gets a tamper-proof on-chain ID
📸 Planter Updates	Planters upload photo + GPS progress per tree
📊 Carbon Dashboard	Track estimated CO₂ offset across your entire portfolio
💸 Instant Settlement	Planters paid in XLM/USDC the moment work is verified
🔒 Escrow Protection	Funds held in smart contract until planting is confirmed
🗺️ Regional Selection	Sponsor trees in specific countries or biomes

---

Tech Stack

Layer	Technology
Smart Contracts	Soroban (Rust), Stellar mainnet/testnet
Frontend	React + TypeScript + Vite
Wallet	Freighter, Albedo, xBull
Storage	IPFS (planter photo uploads)
Off-chain API	Node.js / Express
Database	PostgreSQL
Carbon Data	Open-source CO₂ sequestration tables per species

---

Smart Contracts

contracts/
├── tree_registry/      # Mint and manage unique Tree IDs (NFT-like)
├── escrow/             # Hold sponsor funds, release on verification
├── planter_registry/   # Register planters, track reputation score
├── carbon_credits/     # Calculate and record CO₂ offset per tree
└── governance/         # DAO voting for platform parameters

---

Getting Started

Prerequisites

• Rust + cargo (stable)
• stellar-cli ≥ 21
• Node.js ≥ 18
• A Stellar testnet account funded via friendbot

Install

git clone https://github.com/RuhinaCodes/Harvesta.git
cd Harvesta

Build Contracts

cd contracts
cargo build --target wasm32-unknown-unknown --release

Deploy to Testnet

stellar contract deploy \
  --wasm target/wasm32-unknown-unknown/release/tree_registry.wasm \
  --network testnet

Run Frontend

cd frontend
npm install
npm run dev

---

Carbon Offset Methodology

Harvesta uses published biomass growth tables (FAO / IPCC Tier 1) to estimate CO₂ sequestration per tree species per year. Estimates are clearly labelled as projections and updated annually.

Example:

Species	Avg CO₂/year (kg)	Maturity
Teak	22 kg	20 years
Moringa	9 kg	3 years
Eucalyptus	31 kg	10 years
Mangrove	14 kg	15 years

---

For Planters

1. Register your wallet and identity on-chain.
2. Browse open planting jobs in your region.
3. Accept a job — funds are locked in escrow immediately.
4. Plant the tree and upload photo + GPS coordinates using the mobile-friendly uploader.
5. Receive payment to your Stellar wallet instantly upon verification.

---

Roadmap

• Core escrow contract
• Tree registry (unique ID minting)
• Planter reputation scoring
• Mobile planter app (React Native)
• DAO governance for fee parameters
• Satellite verification integration (Sentinel-2)
• Carbon credit marketplace

---

Contributing

Issues are open and labelled — see the Issues tab. Smart contract work is in contracts/, frontend in frontend/, backend in scripts/.

---

License

Apache 2.0

FarmCredit

Decentralized agricultural credit platform built on the Stellar network.

Tech Stack

• Framework: Next.js 15 (App Router)
• Language: TypeScript (strict mode)
• Styling: Tailwind CSS v4 + shadcn/ui
• Design System: Stellar brand colors + atomic design pattern
• Package Manager: pnpm

Getting Started

Prerequisites

• Node.js 20+
• pnpm (npm install -g pnpm)
• Git

Setup

git clone git@github.com:Farm-credit/stellar-app-os.git
cd stellar-app-os
pnpm install
pnpm dev

Open http://localhost:3000 to see the app.

Scripts

Command	Description
pnpm dev	Start development server
pnpm build	Production build (also runs type-check)
pnpm typecheck	Run TypeScript type-check without emitting
pnpm test	Run unit tests with Vitest
pnpm test:watch	Run Vitest in watch mode
pnpm start	Start production server
pnpm lint	Run ESLint
pnpm generate-icons	Generate PWA icons from source

Progressive Web App (PWA)

FarmCredit is a fully functional Progressive Web App with offline support and installability.

Features

• 📱 Installable - Add to home screen on mobile and desktop
• 🔌 Offline Support - Works without internet connection
• 🚀 Fast Loading - Cached assets for instant load times
• 🔔 Push Notifications - Optional notification support
• 📊 Network Aware - Detects and adapts to connection status

Quick Start

# Install PWA dependencies
npm install next-pwa @ducanh2912/next-pwa workbox-window
npm install -D @types/serviceworker sharp

# Generate icons
npm run generate-icons

# Build and test
npm run build
npm start

Documentation

• PWA Setup Guide - Comprehensive setup and deployment
• Installation Guide - Quick start guide
• Testing Checklist - Complete testing guide
• Quick Reference - Commands and tips

Testing PWA

1. Build production version: npm run build && npm start
2. Open DevTools → Application → Service Workers
3. Verify service worker is active
4. Test offline: DevTools → Network → Offline
5. Run Lighthouse audit for PWA score

Project Architecture

This project follows the atomic design pattern. Components are organized by complexity, not by feature.

stellar-app-os/
├── app/                    # Next.js App Router pages & layouts
│   ├── globals.css         # Stellar color tokens + Tailwind config
│   ├── layout.tsx          # Root layout
│   └── page.tsx            # Landing page
├── components/
│   ├── atoms/              # Smallest building blocks (Button, Input, Text, Badge)
│   ├── molecules/          # Combinations of atoms (Card)
│   ├── organisms/          # Complex sections (headers, forms — to be built)
│   ├── templates/          # Page-level layouts (to be built)
│   └── ui/                 # shadcn/ui base components (do not edit directly unless extending)
├── lib/
│   └── utils.ts            # Shared utilities (cn() helper)
└── public/                 # Static assets

Design Hierarchy

Level	Purpose	Example
Atoms	Single-purpose UI elements	Button, Input, Text, Badge
Molecules	Groups of atoms working together	Card, FormField
Organisms	Complex UI sections	Header, DonationForm, ProjectGrid
Templates	Page-level structural layouts	DashboardLayout, AuthLayout

Stellar Color Tokens

These brand colors are defined in app/globals.css and available as Tailwind classes:

Token	Value	Tailwind Class
Stellar Blue	#14B6E7	bg-stellar-blue, text-stellar-blue
Stellar Purple	#3E1BDB	bg-stellar-purple, text-stellar-purple
Stellar Navy	#0D0B21	bg-stellar-navy, text-stellar-navy
Stellar Cyan	#00C2FF	bg-stellar-cyan, text-stellar-cyan
Stellar Green	#00B36B	bg-stellar-green, text-stellar-green

Import Convention

No barrel exports. Always import directly from the component file:

// Correct
import { Button } from '@/components/atoms/Button';
import { Card, CardHeader } from '@/components/molecules/Card';

// Wrong — do not use index.ts barrel exports
import { Button } from '@/components/atoms';

---

Contributing

1. Pick an Issue

Browse open issues labeled Stellar Wave. Comment on the issue to claim it. Do not work on an issue someone else has claimed without coordinating.

2. Branch from main

Always start from the latest main:

git checkout main
git pull origin main
git checkout -b feat/<issue-number>-<short-description>

Branch naming examples:

• feat/42-wallet-connect-modal
• fix/78-rate-limit-toast
• docs/107-contributing-guide

3. Coding Standards

• TypeScript strict mode — no any, no unused variables
• Component patterns — use forwardRef where needed, always set displayName, export named types
• Naming — PascalCase for components, camelCase for functions/variables, kebab-case for CSS classes
• Atomic design — atoms extend ui/ base components with Stellar variants; molecules compose atoms
• No barrel exports — import directly from the file, not from index.ts

4. Commit Conventions

This project enforces Conventional Commits and atomic commits.

Commit Message Format

<type>(<scope>): <short description>

[optional body]

[optional footer]

Allowed Types

Type	When to use
feat	New feature or component
fix	Bug fix
docs	Documentation only
style	Formatting, no logic change
refactor	Code restructuring, no behavior change
perf	Performance improvement
test	Adding or updating tests
build	Build system or dependency changes
ci	CI configuration changes
chore	Maintenance tasks

Allowed Scopes

auth, wallet, dashboard, marketplace, admin, donation, carbon, ui, layout, nav, config, deps

Examples

feat(wallet): add Stellar wallet connection modal
fix(donation): correct minimum amount validation
docs(contributing): add commit convention section
style(ui): format Button component with Prettier
refactor(dashboard): extract tab components into separate files

Atomic Commit Rules

1. One concern per commit — never mix a bug fix with a new feature
2. Each commit must build — pnpm build must pass at every single commit
3. Each commit must be revertable — reverting one commit must not break unrelated code
4. Order matters — foundation first, then features, then polish

Bad example (one giant commit):

feat: add dashboard with tabs, fix header bug, update colors

Good example (atomic):

feat(dashboard): create dashboard page layout
feat(dashboard): add overview tab component
feat(dashboard): add donations tab component
fix(nav): correct active link highlighting on dashboard
style(dashboard): align tab content padding

5. Pull Request Process

Before Submitting

# Make sure you're up to date with main
git checkout main
git pull origin main
git checkout <your-branch>
git rebase main

# Verify everything passes
pnpm build
pnpm lint

PR Requirements

Every PR must include:

• Linked issue — use Closes #<issue-number> in the PR description
• Screen recording — record your implementation working in the browser and attach it to the PR
• Filled PR template — Summary, What Was Implemented, Implementation Details, How to Test
• Passing CI — build and lint must pass

PRs without a screen recording or without a linked issue will not be reviewed.

PR Template

When you open a PR, the template will auto-populate. Fill out every section:

## Summary

<!-- 1-3 sentences: What does this PR do and why? -->

## Related Issue

Closes #<issue-number>

## What Was Implemented

<!-- Detailed list of what was built/changed -->

- [ ] Component X created
- [ ] Styling applied with Stellar tokens
- [ ] Responsive on mobile

## Implementation Details

<!-- Key decisions, patterns used, trade-offs -->

## Screenshots / Recordings

<!-- REQUIRED: Screen recording of your implementation -->

## How to Test

<!-- Step-by-step for reviewers -->

1. Checkout this branch
2. Run `pnpm dev`
3. Navigate to /path
4. Verify X works

6. Code Review

• Expect feedback. Reviews are about improving the code, not criticizing the author.
• Respond to every comment — either make the change or explain why not.
• After addressing feedback, re-request review.
• Maintainers will merge once approved and CI passes.

7. Stay in Sync

While your PR is in review, keep your branch up to date:

git checkout main
git pull origin main
git checkout <your-branch>
git rebase main
git push --force-with-lease

---

License

This project is open source. See LICENSE for details.

🌱 Harvesta — Plant Trees. Track Impact. Offset Carbon.

A decentralised tree-planting platform on Stellar where anyone can pay farmers and individuals to plant trees — anonymously or with full carbon-offset tracking — and planters upload real-world progress with a unique tree ID.

---

What is Harvesta?

Harvesta connects tree sponsors with on-the-ground planters (farmers, community groups, individuals) through a transparent, blockchain-backed payment system built on Stellar using Soroban smart contracts.

You can:

• Sponsor a tree — pay a planter to plant and care for a tree on your behalf.
• Go anonymous — make a one-time donation with no account required.
• Track your forest — create an account, get a unique tree ID for every tree you sponsor, and follow its growth through planter-uploaded photo and GPS updates.
• Measure your impact — the platform calculates estimated CO₂ offset per tree species and shows your cumulative carbon footprint reduction.

Planters receive instant Stellar payments the moment a tree is verified, with no banks, no delays, and no middlemen.

---

How It Works

Sponsor                   Harvesta Platform              Planter
  │                              │                          │
  │── Choose species, qty ──────>│                          │
  │── Pay in XLM / USDC ────────>│                          │
  │                              │── Escrow in contract ───>│
  │                              │                          │── Plant tree
  │                              │                          │── Upload photo + GPS
  │                              │<── Progress update ──────│
  │<── Carbon dashboard update ──│                          │
  │                              │── Release payment ──────>│

1. Sponsor selects tree species, quantity, region, and payment method (XLM or USDC).
2. Smart contract holds funds in escrow, mints a unique Tree NFT ID.
3. Planter receives the job, plants the tree, and uploads timestamped photo + GPS proof.
4. Contract releases payment to planter upon verification.
5. Sponsor dashboard shows live tree progress, species info, and CO₂ offset estimate.

---

Features

Feature	Description
🌳 Sponsor a Tree	Pay any planter to plant a tree on your behalf
👤 Anonymous Donations	One-time payment, no account needed
🆔 Unique Tree ID	Each sponsored tree gets a tamper-proof on-chain ID
📸 Planter Updates	Planters upload photo + GPS progress per tree
📊 Carbon Dashboard	Track estimated CO₂ offset across your entire portfolio
💸 Instant Settlement	Planters paid in XLM/USDC the moment work is verified
🔒 Escrow Protection	Funds held in smart contract until planting is confirmed
🗺️ Regional Selection	Sponsor trees in specific countries or biomes

---

Tech Stack

Layer	Technology
Smart Contracts	Soroban (Rust), Stellar mainnet/testnet
Frontend	React + TypeScript + Vite
Wallet	Freighter, Albedo, xBull
Storage	IPFS (planter photo uploads)
Off-chain API	Node.js / Express
Database	PostgreSQL
Carbon Data	Open-source CO₂ sequestration tables per species

---

Smart Contracts

contracts/
├── tree_registry/      # Mint and manage unique Tree IDs (NFT-like)
├── escrow/             # Hold sponsor funds, release on verification
├── planter_registry/   # Register planters, track reputation score
├── carbon_credits/     # Calculate and record CO₂ offset per tree
└── governance/         # DAO voting for platform parameters

---

Getting Started

Prerequisites

• Rust + cargo (stable)
• stellar-cli ≥ 21
• Node.js ≥ 18
• A Stellar testnet account funded via friendbot

Install

git clone https://github.com/RuhinaCodes/Harvesta.git
cd Harvesta

Build Contracts

cd contracts
cargo build --target wasm32-unknown-unknown --release

Deploy to Testnet

stellar contract deploy \
  --wasm target/wasm32-unknown-unknown/release/tree_registry.wasm \
  --network testnet

Run Frontend

cd frontend
npm install
npm run dev

---

Carbon Offset Methodology

Harvesta uses published biomass growth tables (FAO / IPCC Tier 1) to estimate CO₂ sequestration per tree species per year. Estimates are clearly labelled as projections and updated annually.

Example:

Species	Avg CO₂/year (kg)	Maturity
Teak	22 kg	20 years
Moringa	9 kg	3 years
Eucalyptus	31 kg	10 years
Mangrove	14 kg	15 years

---

For Planters

1. Register your wallet and identity on-chain.
2. Browse open planting jobs in your region.
3. Accept a job — funds are locked in escrow immediately.
4. Plant the tree and upload photo + GPS coordinates using the mobile-friendly uploader.
5. Receive payment to your Stellar wallet instantly upon verification.

---

Roadmap

• Core escrow contract
• Tree registry (unique ID minting)
• Planter reputation scoring
• Mobile planter app (React Native)
• DAO governance for fee parameters
• Satellite verification integration (Sentinel-2)
• Carbon credit marketplace

---

Contributing

Issues are open and labelled — see the Issues tab. Smart contract work is in contracts/, frontend in frontend/, backend in scripts/.

---

License

Apache 2.0