Where seamless shopping meets smart architecture

A dual-interface Flutter application engineered for efficiency, scalability, and delightful UX — serving both Admins and Users in one cohesive ecosystem.

---

🌐 Overview

Shop Smart is not just an app—it's a system. Two interfaces. One vision. Zero chaos.

• 🧑‍💼 Admins manage the platform effortlessly
• 🛒 Users enjoy a frictionless shopping experience
• ⚡ Built with performance-first Flutter architecture

---

🧭 System Architecture

flowchart TD
    A[User App 📱] -->|Browse / Order| B[Firebase Backend 🔥]
    C[Admin Panel 🧑‍💻] -->|Manage Data| B
    B --> D[(Database)]
    B --> E[Authentication 🔐]
    B --> F[Cloud Storage ☁️]

Loading

---

📁 Project Structure

graph TD
    A[Shop Smart Repo 🛍️]
    A --> B[shopsmart_admin 🧑‍💼]
    A --> C[shopsmart_user 🛒]

    B --> B1[Dashboard]
    B --> B2[Order Management]
    B --> B3[Product Editing]
    B --> B4[Search System]

    C --> C1[Authentication]
    C --> C2[Product Browsing]
    C --> C3[Cart & Orders]
    C --> C4[Wishlist]
    C --> C5[Profile Management]
    C --> C6[Search Engine]

Loading

---

🧑‍💼 Admin Panel (shopsmart_admin)

Control. Visibility. Efficiency.

✨ Features:

• 📊 User Dashboard — monitor activity like a boss
• 📦 Order Management — track, update, fulfill
• 🛠️ Product Editing — real-time updates
• 🔍 Search Functionality — find anything instantly

---

🛒 User Application (shopsmart_user)

Smooth. Personal. Addictive (in a good way).

✨ Features:

• 🔐 Authentication System

  • Login / Register / Forgot Password

• 🛍️ Product Exploration

  • Detailed views, intuitive UI

• 🛒 Cart & Orders

  • Seamless checkout flow

• ❤️ Wishlist & Recently Viewed

  • Memory that never forgets

• 👤 Profile Management

  • Full user control

• 🔎 Advanced Search

  • Fast, responsive, relevant

---

⚙️ Tech Stack

mindmap
  root((Tech Stack 🚀))
    Flutter 📱
    Firebase 🔥
      Authentication
      Firestore DB
      Storage
    Scalable UI/UX
    Modular Architecture

Loading

• Flutter → Cross-platform UI magic
• Firebase → Backend power (optional integration-ready)

---

🚀 Getting Started

# Clone the repository
git clone https://github.com/your-username/shopsmart.git

# Navigate into project
cd shopsmart

# Run Admin Panel
cd shopsmart_admin
flutter pub get
flutter run

# Run User App
cd ../shopsmart_user
flutter pub get
flutter run

---

👥 Maintainers

This project is collaboratively built and maintained by:

• Osama Noor
• Ruby Poddar

📧 Osama Noor mosamanoor17@gmail.com

📧 Ruby Poddar rubypoddarr@gmail.com

---

🔐 License

📌 Open for:

• Learning
• Personal projects

🚫 For commercial use → Permission required via email

---

🌟 Final Note

This project isn’t just about shopping it’s about crafting a scalable digital experience with clean architecture and user-first thinking.

Build smart. Ship fast. Stay elegant.

---