🛒 Flutter Shopping App

A comprehensive Flutter shopping application that demonstrates core Dart programming principles and advanced Flutter development techniques. This project features user authentication, product displays, cart interactions, responsive UI design, and full Arabic localization support.

---

📱 Project Overview

This Flutter shopping app was developed as part of Join Sprints × Microsoft Summer Camp (40 hours).
It simulates a real-world e-commerce interface with welcome screen, authentication system, product browsing, and Arabic localization.
The app demonstrates best practices in Dart programming, Flutter development, modular code structure, and GitHub project publishing.

---

✨ Features

🎨 Aesthetic Welcome Screen

• Custom AppBar with app title
• Two images: one local + one network image
• Suwannaphum-Regular font with bold & colored styling
• Centered layout with spacing
• Navigation buttons: Sign-Up & Sign-In

🔐 Authentication System

Sign-Up

• Full Name validation (first letter uppercase)
• Email validation (must contain @)
• Password validation (≥ 6 characters)
• Confirm password validation (must match)
• Success dialog → navigates to home screen

Sign-In

• Email + Password validation
• Success dialog → navigates to home screen
• Password visibility toggle

🎯 Smooth Page Transitions

• Animated fade-in / fade-out navigation
• Seamless UX with professional look

🏪 Shopping Home Screen

• AppBar with title “Our Products”
• Horizontal PageView with featured products
• Responsive GridView (2 per row) showing products with:
  • Image, title, add-to-cart icon
  • SnackBar feedback on add-to-cart
• Hot Offers section: vertical ListView.builder with 5 items

🌐 Arabic Localization (Bonus)

• Full app localization into Arabic
• RTL layout support
• Dynamic switching between English ↔ Arabic
• Implemented using .arb files with Easy Localization

---

🛠 Technical Implementation

Technologies

• Dart: Core language
• Flutter SDK: Cross-platform UI framework
• Easy Localization: Multi-language support
• Page Transition: Smooth navigation animations
• Material Design: Modern UI components

Code Quality

• Each widget/class in a separate file
• No unused or duplicated code
• Clear naming for variables, functions, and classes
• Well-formatted and clean codebase

---

📸 Screenshots

English

Welcome	Sign-Up	Home

Hot Offers	Add to Cart

---

العربية

Welcome	Sign-Up	Home

Hot Offers	Add to Cart

---

🎥 Demo Video

👉 Watch the full demo on Google Drive

---

📂 Project Structure

🔧 Core Application (lib/)

• main.dart → App entry point and routing configuration
• page_transition_helper.dart → Custom navigation animations

---

📊 Data Layer (data/)

• hot_offer_list.dart → Hot offers data source
• pageview_list.dart → Featured products data
• product_list.dart → Main products catalog

---

🗂 Models (models/)

• hot_offers_model.dart → Hot offers data model
• pageview_model.dart → PageView items model
• product_model.dart → Product entity model

---

🖥 User Interface (screens/)

• welcome_screen.dart → App introduction screen
• sign_in.dart → User authentication (login)
• sign_up.dart → User registration form
• home_screen.dart → Main shopping interface

---

🧩 Reusable Components (widgets/)

• hot_offers_widget.dart → Hot offers display component
• page_view.dart → Featured products carousel
• product_grid_view.dart → Products grid layout

---

🎨 Assets & Resources (assets/)

📑 Localization (translations/)

• en-US.json → English language strings
• ar-EG.json → Arabic language strings

✍ Typography (fonts/)

• Suwannaphum-Regular.ttf → Custom app font

---

🚀 Setup Instructions

Prerequisites

• Flutter SDK 3.0.0+
• Dart SDK 3.0.0+
• Android Studio / VS Code

Steps

git clone https://github.com/doaa153/Flutter-Shopping-App-Project---Sprints.git
cd Flutter-Shopping-App-Project---Sprints
flutter pub get
flutter run