sbuncele-del/amana-marketplace

# 🌍 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 …