sbuncele-del/amana-marketplace
Domaine:
socioeconomicType de record:
software
Créateur:
sbu
Hôte:
# 🌍 Amana — African Cross-Border Marketplace
**Amana** (meaning *trust* in Swahili) is a secure cross-border marketplace connecting African sellers with buyers worldwide. Built with escrow-first payments, verified sellers, and multi-currency support.
> Part of the ATG Group of Companies ecosystem.
---
## ✨ Features
- **Buyer Protection** — Vesicash escrow holds funds until delivery is confirmed
- **Secure Payments** — Flutterwave gateway supporting cards, mobile money, bank transfers
- **Seller Verification** — KYC/business document verification with trust scores
- **Product Marketplace** — Categories, search, filtering, reviews & ratings
- **Order Tracking** — Full lifecycle from purchase to delivery
- **Seller Dashboard** — Analytics, product management, order fulfillment, settings
- **Multi-Currency** — USD, ZAR, NGN, KES, and more
- **Responsive UI** — Radix UI + Tailwind CSS, mobile-first design
## 🛠 Tech Stack
| Layer | Technology |
|-------|-----------|
| Framework | Next.js 16 (App Router, TypeScript) |
| Database | PostgreSQL 16 + Prisma ORM |
| Auth | NextAuth v5 (credentials) |
| Payments | Flutterwave |
| Escrow | Vesicash |
| UI | Radix UI + Tailwind CSS |
| Validation | Zod |
| Deployment | Docker + Nginx (Vultr VPS) |
## 📁 Project Structure
```
src/
├── app/
│ ├── (auth)/ # Login, Register
│ ├── (main)/ # All public pages + dashboard
│ └── api/ # REST endpoints (auth, products, orders, webhooks)
├── components/ # Reusable UI (navbar, footer, product card, auth forms)
├── lib/ # Prisma client, auth config, payment integrations
└── middleware.ts # Route protection
prisma/
├── schema.prisma # Database schema
└── seed.ts # Seed data
```
## 🚀 Getting Started
### Prerequisites
- Node.js 20+
- PostgreSQL 16 (or use Docker)
### Local Development
```bash
# Clone
git clone github.com
cd amana-marketplace
# Install depe …