Cross-border micro-payments, powered by the Stellar blockchain.

Stellar MicroPay is an open-source platform that lets anyone send small payments across borders instantly using XLM on the Stellar network. No banks. No high fees. No waiting.

• 🔗 Connect Wallet — Freighter browser wallet integration
• 💸 Send XLM — Send micro-payments to any Stellar address globally
• 📜 Transaction History — View your recent payment activity
• 🌍 Cross-border — Works anywhere in the world, near-zero fees

stellar-micropay/
├── frontend/          # Next.js + React + Tailwind CSS
├── backend/           # Node.js + Express API
├── contracts/         # Stellar Soroban smart contracts (Rust)
├── docs/              # Architecture & API documentation
├── scripts/           # Deployment & utility scripts
├── .github/           # CI/CD workflows & issue templates
├── CONTRIBUTING.md
├── ROADMAP.md
└── LICENSE

git clone https://github.com/your-org/stellar-micropay.git
cd stellar-micropay

The fastest way to get a fully working dev environment with hot-reload:

docker compose up

• Frontend (HMR): http://localhost:3000
• Backend (nodemon): http://localhost:4000

Editing any frontend or backend file reflects instantly without restarting containers.

For a production build:

docker compose -f docker-compose.prod.yml up --build

Run the setup script to install all dependencies and copy env files:

chmod +x scripts/setup-dev.sh
./scripts/setup-dev.sh

Then start each service in a separate terminal:

# Terminal 1
cd frontend && npm run dev   # → http://localhost:3000

# Terminal 2
cd backend && npm run dev    # → http://localhost:4000

cd contracts/stellar-micropay-contract
cargo build --target wasm32-unknown-unknown --release

NEXT_PUBLIC_STELLAR_NETWORK=testnet
NEXT_PUBLIC_HORIZON_URL=https://horizon-testnet.stellar.org
NEXT_PUBLIC_API_URL=http://localhost:4000

PORT=4000
STELLAR_NETWORK=testnet
HORIZON_URL=https://horizon-testnet.stellar.org

1. Install Freighter Wallet
2. Switch to Testnet in Freighter settings
3. Visit Stellar Friendbot and paste your public key
4. You'll receive 10,000 test XLM instantly

We love contributions! See CONTRIBUTING.md to get started.

See ROADMAP.md for planned features.

MIT — see LICENSE