Skip to content

BugMaker69/DropZ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

60 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

DropZ

A Full-Featured E-Commerce App (Customer + Seller) โ€“ Amazon & Noon Style

Flutter Platform Status License

A modern, production-grade E-Commerce mobile application built with Flutter, supporting both Customer and Seller flows, inspired by platforms like Amazon & Noon. DropZ is designed to demonstrate how a real-world shopping app is engineered: secure payments, biometric verification, scalable architecture, and clean, maintainable code.

This project is built as a professional portfolio showcase, following patterns and practices used in large-scale mobile products.


๐Ÿš€ What is DropZ?

DropZ simulates a complete online shopping experience โ€” from discovering products to securely paying and contacting support โ€” while focusing heavily on architecture quality, user experience, and security.

The goal is not just to make the app work, but to make it scalable, readable, and production-ready.


โœจ Key Capabilities

  • Full Eโ€‘Commerce flow (Browse โ†’ Cart โ†’ Checkout โ†’ Payment)
  • Secure payments with Paymob
  • Biometric verification before payment confirmation
  • Light & Dark theme with persistence
  • Featureโ€‘based scalable architecture
  • Clean separation of UI, state, and data layers

๐Ÿงฉ Features Breakdown

Authentication

  • Secure login & registration
  • Tokenโ€‘based session handling
  • Persistent authentication state

Product Discovery

  • Home with featured products & categories
  • Product listing with pagination
  • Product details (images, price, description, reviews)

Search

  • Keyword-based product search
  • Optimized result handling
  • Empty & error state support

Wishlist

  • Save products for later
  • Userโ€‘specific persistence

Cart

  • Add, remove, and update items
  • Realโ€‘time price calculation
  • Persistent cart across sessions

Checkout & Payments

  • Structured checkout flow
  • Address selection
  • Biometric authentication (Fingerprint / Face ID)
  • Paymob payment gateway integration
  • Robust success & failure handling

Address Management

  • Add, edit, delete addresses
  • Default address support

Reviews System

  • Product ratings & reviews
  • Average rating calculation

Profile & Settings

  • User profile management
  • Light / Dark theme switching
  • Preferences persistence

Support

  • Inโ€‘app support ticket system
  • Direct communication channel with support

๐Ÿ— Architecture

DropZ follows a Featureโ€‘Based Clean Architecture, inspired by enterprise Flutter applications.

Each feature is isolated, selfโ€‘contained, and independently maintainable.

lib/
 โ”œโ”€โ”€ core/               # Shared & crossโ€‘feature logic
 โ”‚    โ”œโ”€โ”€ network/       # Dio, interceptors
 โ”‚    โ”œโ”€โ”€ storage/       # Local persistence
 โ”‚    โ”œโ”€โ”€ theme/         # App theming
 โ”‚    โ””โ”€โ”€ widgets/       # Reusable UI components
 โ”‚
 โ”œโ”€โ”€ features/           # App features (vertical slices)
 โ”‚    โ”œโ”€โ”€ auth/
 โ”‚    โ”œโ”€โ”€ home/
 โ”‚    โ”œโ”€โ”€ products/
 โ”‚    โ”œโ”€โ”€ cart/
 โ”‚    โ”œโ”€โ”€ checkout/
 โ”‚    โ”œโ”€โ”€ address/
 โ”‚    โ”œโ”€โ”€ wishlist/
 โ”‚    โ”œโ”€โ”€ reviews/
 โ”‚    โ”œโ”€โ”€ profile/
 โ”‚    โ”œโ”€โ”€ settings/
 โ”‚    โ””โ”€โ”€ support/
 โ”‚
 โ””โ”€โ”€ main.dart

Why this architecture?

  • Easy to scale
  • Easy to test
  • Easy for teams to collaborate
  • Avoids massive, tightly coupled codebases

๐ŸŒฑ Git Workflow

Development follows a featureโ€‘branch workflow:

feature/auth
feature/home
feature/products
feature/cart
feature/checkout
feature/address
feature/reviews-system
feature/profile
feature/settings
feature/support

This mirrors how professional teams manage parallel development.


๐Ÿ›  Tech Stack

  • Flutter / Dart
  • Bloc / Cubit โ€“ State management
  • Dio โ€“ Networking & API handling
  • SharedPreferences / Hive โ€“ Local storage
  • Paymob โ€“ Online payments
  • Biometric Authentication โ€“ Payment verification

โ–ถ๏ธ Running the Project

git clone https://github.com/BugMaker69/DropZ.git
cd DropZ
flutter pub get
flutter run

๐ŸŽฅ Demo & Screenshots

๐ŸŽฅ Demo Videos

๐Ÿง‘โ€๐Ÿ’ผ Customer App Demo

A short walkthrough showcasing the customer experience:

  • Browsing products
  • Adding items to cart
  • Checkout & secure payment
  • Biometric verification

โ–ถ๏ธ Watch Customer Demo


๐Ÿช Seller App Demo

A walkthrough demonstrating the seller-side workflow:

  • Managing products
  • Viewing orders
  • Handling customer requests
  • Order status updates

Seller Demo

๐Ÿ–ผ๏ธ Screenshots

Browse Products Add Product Cart


๐Ÿ”ฎ Planned Enhancements

  • Order history & tracking
  • Push notifications
  • Unit & widget testing
  • CI/CD pipeline

๐Ÿ‘ค Author

Omar Mobile Developer (Flutter & Android)

GitHub: BugMaker69


โญ If you find this project valuable, consider giving it a star.

About

Dropz is a multi-sided e-commerce platform designed to connect Egyptian buyers with local suppliers and shipping companies in a seamless and efficient digital marketplace.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors