A hyperlocal community platform where verified members participate in local marketplaces and transparent community funds using Stellar.
🎥 Watch Demo | 📖 Documentation | 🤝 Contributing | 🗺️ Roadmap
Stellar Local empowers neighborhoods to build self-sustaining local economies through blockchain-backed marketplaces and transparent community funding—all powered by Stellar's fast, low-cost network and Soroban smart contracts.
Local communities face fragmented commerce and opaque community funding:
- Marketplaces lack trust systems for neighbor-to-neighbor transactions
- Community funds lack transparency in contributions and distributions
- Local economies have no unified digital infrastructure
Stellar Local uses Stellar as the settlement layer for local marketplace transactions and community funds, while Soroban provides programmable logic for membership verification, marketplace rules, and community financial workflows.
Key Benefits:
- ⚡ Fast settlements — transactions confirm in 3-5 seconds
- 💰 Low fees — fractions of a cent per transaction
- 🔗 Smart contracts — Soroban enables programmable community logic
- 🌍 Global reach, local focus — Stellar's network with hyperlocal rules
- Community membership Soroban contract
- Community fund Soroban contract with deposit/payment flows
- Marketplace Soroban contract with listing/purchase logic
- Contract test suite (community, fund, marketplace)
- Stellar SDK integration (payments, accounts, assets)
- PostgreSQL schema for off-chain data
- CI/CD pipeline (lint, build, test)
- Frontend marketplace UI
- Wallet connection (Freighter)
- Community fund dashboard
- End-to-end marketplace transaction flow
- Resource sharing module
- Mutual aid system
- Local governance (proposals + voting)
- Mobile application
- Cross-community features
STELLAR LOCAL
│
┌────────────┴────────────┐
│ │
Web / Mobile External APIs
│
▼
Application Layer
│
┌──────┼───────┐
│ │ │
Membership Marketplace Community Fund
│ │ │
└──────┼───────┘
▼
Soroban Contracts
│
▼
Stellar Network
│
▼
Settlement Layer
| Layer | Purpose |
|---|---|
| Application | Next.js frontend + Node.js microservices |
| Soroban Contracts | Membership verification, marketplace logic, fund management |
| Stellar Network | Payment settlement, account management, asset transfers |
- Node.js >= 20
- Rust (for Soroban contracts)
- Docker & Docker Compose
- Stellar CLI
# Clone the repository
git clone https://github.com/Fayedamz/Stellar-Local.git
cd Stellar-Local
# Install dependencies
npm install
# Copy environment variables
cp .env.example .env
# Start infrastructure (PostgreSQL, Redis, MongoDB)
docker-compose up -d
# Build Soroban contracts
cd contracts/membership && cargo build --target wasm32-unknown-unknown --release
cd ../marketplace && cargo build --target wasm32-unknown-unknown --release
cd ../community-fund && cargo build --target wasm32-unknown-unknown --release
# Run tests
npm test
# Start development servers
npm run devThe web app runs at http://localhost:3000
API Gateway runs at http://localhost:4000
- Community membership contract
- Marketplace contract (listing + purchase)
- Community fund contract (deposit + distribution)
- Stellar payment integration
- Wallet connection (Freighter)
- Frontend marketplace
- Community fund dashboard
- Resource sharing module
- Mutual aid system
- Community proposal system
- Reputation & trust scoring
- Multi-community support
- Mobile application (React Native)
- Local business onboarding
- API for external integrations
- Cross-community transactions
- Advanced governance (DAO-style)
We welcome contributions from the community! Stellar Local is designed to be contributor-friendly with well-scoped issues.
- Browse Issues — Check open issues labeled
good first issueorhelp wanted - Pick an Issue — Comment to let us know you're working on it
- Fork & Branch — Create a feature branch from
develop - Build & Test — Ensure all tests pass
- Submit PR — Reference the issue number in your pull request
📖 Read full contribution guide
| Area | Example Issues |
|---|---|
| Soroban Contracts | Membership contract, community fund logic |
| Frontend | Marketplace UI, wallet integration |
| Backend | Listing API, payment webhooks |
| Testing | Contract test coverage, integration tests |
| Documentation | Developer guides, API docs |
| DevOps | CI/CD improvements, Docker optimization |
See Wave Contribution Map for detailed guidance.
🎥 Coming Soon — Watch a 3-minute demo of Stellar Local in action
The demo will show:
- Connect Stellar wallet
- Join a community
- Browse marketplace listings
- Make a purchase with Stellar payment
- View community fund dashboard
MIT License — see LICENSE for details.
Built with ❤️ for local communities on Stellar