Skip to content

Ugarba202/Grabby

Repository files navigation

🛒 Grabby - Smart E-Commerce Platform

A modern e-commerce mobile application built with Flutter, designed to redefine the online shopping experience in Nigeria 🇳🇬.
Grabby lets users shop, schedule orders, choose dispatch riders, and track deliveries — all in one seamless experience.

Grabby Logo

Shop Smart, Shop Fast

Flutter Firebase License


📱 About Grabby

Grabby is a full-stack mobile e-commerce application designed to revolutionize online shopping in Nigeria. Built with Flutter, Grabby addresses critical gaps in existing e-commerce platforms by offering:

  • Fast & Reliable Delivery - Choose your own dispatch provider
  • Scheduled Orders - Plan your shopping ahead of time
  • Real-time Tracking - Know exactly where your order is
  • Secure Payments - Integration with trusted Nigerian payment gateways
  • Smart Recommendations - Personalized shopping experience based on location and preferences

✨ Key Features

For Customers

  • 🔍 Smart Search & Discovery - Find products and merchants easily
  • 🛍️ Multi-Vendor Shopping - Browse products from multiple merchants
  • 📅 Order Scheduling - Schedule deliveries for later
  • 🚚 Custom Dispatch Selection - Choose your preferred delivery service
  • 📍 Location-Based Recommendations - Discover merchants near you
  • 💳 Secure Payments - Paystack/Flutterwave integration
  • Reviews & Ratings - Rate products, merchants, and delivery services
  • 🔔 Real-time Notifications - Stay updated on order status
  • 📦 Order Tracking - Live tracking with dispatch contact access

For Merchants

  • 📊 Dashboard Analytics - Track sales and inventory
  • 📦 Inventory Management - Easy product management
  • 📱 Order Management - Process orders efficiently
  • 💰 Revenue Tracking - Monitor earnings in real-time

For Dispatch Providers

  • 🗺️ Route Optimization - Efficient delivery planning
  • 📍 Real-time Location Sharing - Customer tracking capability
  • 💵 Earnings Dashboard - Track deliveries and payments

🏗️ Project Structure

grabby/
├── lib/
│   ├── core/                    # Core functionality
│   │   ├── constants/          # App-wide constants
│   │   ├── theme/              # App theme and styling
│   │   └── utils/              # Helper functions
│   ├── models/                 # Data models
│   ├── providers/              # State management (Provider)
│   ├── screens/                # UI screens
│   ├── services/               # API & Firebase services
│   └── widgets/                # Reusable widgets
├── assets/
│   ├── images/                 # Image assets
│   └── icons/                  # Icon assets
├── test/                       # Unit & widget tests
└── docs/                       # Documentation


## 🛠️ Tech Stack

### Frontend
- **Flutter** - Cross-platform mobile framework
- **Dart** - Programming language
- **Provider** - State management

### Backend
- **Firebase Authentication** - User authentication
- **Cloud Firestore** - NoSQL database
- **Firebase Storage** - File storage
- **Firebase Cloud Messaging** - Push notifications
- **Node.js + Express** (Coming Soon) - Custom API server

### Third-Party Services
- **Paystack/Flutterwave** - Payment processing
- **Google Maps API** - Location services
- **Firebase Analytics** - App analytics

### Tools & DevOps
- **Git & GitHub** - Version control
- **GitHub Actions** (Coming Soon) - CI/CD
- **Firebase Hosting** (Coming Soon) - Web deployment

---


📸 Screenshots

Coming soon! Screenshots will be added as features are completed.


📝 Development Blog

Follow my development journey on:


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.



📧 Contact

Your email - Usman Umar Garba ([email protected]) - [email protected]

Project link: https://github.com/techusman-codes/Grabby


⭐ Star this repo if you find it interesting!

Made with Flutter❤️ and lots of ☕

About

A full-stack mobile e-commerce platform built with Flutter, designed for the Nigerian market.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors