🛍️ BuyerHub

📲 A clean, modern Flutter shopping app for buyers – complete with authentication, cart, profile & Stripe payments.

---

🌟 Overview

BuyerHub is a full-featured Flutter mobile application that simulates the buyer journey in an e-commerce app. Built with scalability, performance, and aesthetics in mind, it allows users to:

• 🔐 Secure login/sign-up via Firebase
• 🛒 Browse and search for categorized products
• ➕ Add items to cart with quantity control
• 💳 Checkout using Stripe (test keys)
• 👤 Manage profile and update account info

---

✨ Features

Feature	Description
🔐 Authentication	Secure login/signup with Firebase
📦 Product Listing	Real-time product display using Firestore
🔍 Search & Filter	Search bar with category-based filtering
🛒 Cart System	Add to cart, quantity adjust, remove items
💳 Stripe Checkout	Online payments using test Stripe API
👤 Profile Management	Edit user info, update password, profile image
📱 Responsive UI	Smooth UI built with Flutter + VelocityX
⚙️ State Management	Efficient navigation and data flow via GetX

---

📊 Buyer Journey Diagram

graph TD;
    A[🔍 Browse Products] --> B[🛒 Add to Cart];
    B --> C[🧾 Checkout];
    C --> D[💳 Make Payment];
    D --> E[✅ Order Confirmation];

Loading

---

📈 Mobile Commerce Usage Graph

🧠 Insight: Over 65% of global e-commerce happens on mobile – validating BuyerHub’s mobile-first focus.

📦 Tech Stack

Layer	Technology
💻 Frontend	Flutter (Dart)
🔙 Backend	Firebase (Auth + Firestore)
💼 Payments	Stripe (via REST API)
🎨 UI Toolkit	VelocityX, Custom Widgets
⚙️ State Mgmt	GetX

---

🚀 Getting Started

✅ Prerequisites

• Flutter SDK
• Firebase Project (Firestore + Auth enabled)
• Stripe Developer Account (test mode)

📦 Installation

git clone https://github.com/Hifza-Khalid/BuyerHub.git
cd BuyerHub
flutter pub get

🔧 Firebase Setup

1. Create Firebase project
2. Enable Email/Password Authentication
3. Add google-services.json to:

android/app/google-services.json

4. Create Firestore collections:

   • users
   • products

💳 Stripe Setup

Update the following in lib/services/payment_service.dart:

static const String stripePublishableKey = 'pk_test_...';
static const String stripeSecretKey = 'sk_test_...';

---

🗂️ Project Structure

lib/
├── consts/             # Constants (colors, images, strings)
├── controllers/        # Business logic (GetX)
├── models/             # Data models (e.g. Category)
├── services/           # Firestore + Payment services
├── views/              # UI Screens
├── widgets_common/     # Reusable components
└── main.dart           # Entry point

---

## 💡 Upcoming Features

* ❤️ Wishlist & Favorites
* 🔔 Push Notifications (via Firebase Cloud Messaging)
* 📦 Seller/Admin Module
* 🧾 Order History + Invoicing
* 🌐 Multi-language Support

---

## 🤝 Contributing

```bash
🍴 Fork the repo
🔧 Create your branch: git checkout -b feature/YourFeature
✅ Commit changes: git commit -m "Add feature"
📤 Push to GitHub: git push origin feature/YourFeature
🔃 Open a pull request

---

🧑‍💻 Authors

Name	Email	GitHub
👩‍💻 Hifza Khalid	su92-bssem-f22-202@superior.edu.pk	GitHub
👨‍💻 Baqir Sultan	su92-bssem-f22-201@superior.edu.pk	–
👨‍💻 Hafiz Muhammad Zubair	su92-bssem-f22-196@superior.edu.pk	–

🎓 BS Software Engineering (2022–2026), Superior University, Lahore

---

📚 References

• Flutter Docs
• Firebase Docs
• Stripe Docs
• VelocityX Docs
• Dribbble – UI Inspiration

---

📜 License

📌 Academic Use Only — This project is developed for educational purposes and not intended for commercial deployment.