sadinho0samuel-maker/KampalaCart

The largest online marketplace in Uganda. # KampalaCart - E-Commerce Platform for Uganda A production-ready, full-featured e-commerce platform designed specifically for Uganda, built with Flutter, NestJS, PostgreSQL, and Firebase. ## 🚀 Features ### Core Features - **Multi-platform Support**: Android, iOS, and Web from a single Flutter codebase - **User Management**: Buyers, sellers, and admin accounts with role-based access - **Product Catalog**: Complete product management with categories and filtering - **Advanced Search**: Full-text search with multiple filters and sorting - **Shopping Experience**: Cart, wishlist, and secure checkout - **Payment Integration**: MTN Mobile Money, Airtel Money, and Flutterwave (cards) - **Order Management**: Order tracking, delivery updates, and history - **Reviews & Ratings**: Product and seller reviews with ratings - **Discounts & Coupons**: Promotional codes and seasonal discounts - **Notifications**: Real-time push notifications and in-app alerts - **Chat System**: Direct messaging between buyers and sellers - **Analytics Dashboard**: Sales metrics, user behavior, and performance insights - **AI Recommendations**: Personalized product recommendations - **Admin Dashboard**: Complete platform management and moderation ## 📁 Project Structure ``` KampalaCart/ ├── backend/ # NestJS backend application ├── frontend/ # Flutter mobile & web app ├── docker-compose.yml # Development environment setup ├── .github/ # GitHub Actions workflows └── docs/ # Documentation ``` ## 🏗️ Tech Stack **Backend** - NestJS (Node.js framework) - PostgreSQL (relational database) - TypeORM (ORM) - Passport.js (authentication) - Firebase Admin SDK - Socket.io (real-time communication) - Flutterwave API (payment processing) **Frontend** - Flutter 3.x - Riverpod (state management) - Firebase SDK - Google Maps Flutter - Flutterwave Flutter **Infrastructure** - Docker & Docker Compose - Firebase (Auth, Storage, FCM) - Postg …