StreamFund — Real-Time Crowdfunding Protocol on Stellar

🚀 Core Feature

StreamFund enables continuous crowdfunding where supporters fund projects in real time through micro-payment streams. Backers retain full control and can adjust or terminate contributions instantly.

🏗 Architecture Overview

Client (React) → API (Node.js) → Database (PostgreSQL/Redis) → Stellar Network

📂 Repository Structure

streamfund/
├── client/
├── server/
├── database/
├── scripts/
├── docs/
├── docker/
├── tests/
└── README.md

⚙️ Setup Instructions

Prerequisites

• Node.js ≥ 18
• PostgreSQL ≥ 14
• Stellar testnet account

Installation

git clone https://github.com/your-org/streamfund.git
cd streamfund
npm install

Environment (.env)

PORT=3000
DATABASE_URL=postgres://user:password@localhost:5432/streamfund
STELLAR_NETWORK=testnet
HORIZON_URL=https://horizon-testnet.stellar.org
JWT_SECRET=change_me
REDIS_URL=redis://localhost:6379

Run

Backend:

npm run dev

Frontend:

cd client && npm run dev

🏁 Getting Started

1. Connect wallet
2. Create campaign
3. Share link
4. Receive live funding

🧑‍💻 Coding Standards

TypeScript strict mode, ESLint, Prettier, unit tests required.

🔀 Pull Request Guidelines

Fork → Branch → PR with tests and docs.

🗺 Roadmap

Q1: MVP & campaigns
Q2: Milestones & mobile

📜 License

MIT