🌟 A Modern Flutter E-Commerce Experience for Fresh Fruit Shopping 🌟

Dive into a vibrant world of fresh fruit shopping with seamless user experience, secure payments, and modern architecture!

• ✨ Key Highlights
• 🚀 Features
• 🛠️ Tech Stack
• 📱 Screenshots
• 🔧 Installation
• 📖 Usage Guide
• 🏗️ Project Structure
• 🤝 Contributing
• 📄 License
• 📬 Contact

Flutter Powered Cross-platform perfection

Firebase Backend Real-time & scalable

Secure Payments PayPal integration

BLoC Architecture Clean & maintainable

• 🔐 Multi-Auth System - Email/Password, Google, and Facebook authentication
• 👤 Personalized Profiles - Comprehensive user management with order history and preferences
• 🔍 Smart Search & Filters - Advanced product discovery with real-time search suggestions
• 🛒 Dynamic Shopping Cart - Real-time updates with instant total calculations and quantity management
• ⭐ Review System - Rate and review products with photo uploads and helpful voting
• 🔔 Push Notifications - Real-time order updates and promotional alerts

• 🌈 Adaptive Themes - Light ☀️, dark 🌙, and system-based theme switching
• 🌍 Multi-Language Support - Arabic 🇪🇬 and English 🇺🇸 with RTL/LTR text direction
• 🎭 Smooth Animations - Engaging transitions and micro-interactions throughout the app
• 📱 Responsive Design - Optimized for all screen sizes and orientations
• ♿ Accessibility Ready - Screen reader support and high contrast mode

• 💰 Smart Discounts - Dynamic pricing with seasonal offers and bulk discounts
• 📦 Order Management - Complete order tracking from cart to delivery
• 💳 Secure Checkout - PayPal integration with fraud protection
• 🍎 Best Selling Products - Curated selection of popular fruits
• 🛍️ Persistent Shopping Cart - Cart items saved across app sessions

Category	Technology	Purpose
Framework		Cross-platform mobile development
Language		Primary programming language
Backend		Database, authentication & real-time features
Payments		Secure payment processing
State Management		Business logic separation
Localization		Multi-language support

dependencies:
  animate_do: ^4.2.0
  another_flushbar: ^1.12.30
  cached_network_image: ^3.4.1
  cloud_firestore: ^5.6.7
  cupertino_icons: ^1.0.8
  dartz: ^0.10.1
  dots_indicator: ^4.0.1
  easy_localization: ^3.0.7+1
  easy_refresh: ^3.4.0
  equatable: ^2.0.7
  firebase_auth: ^5.5.2
  firebase_core: ^3.13.0
  firebase_messaging: ^15.2.5
  flutter: sdk
  flutter_bloc: ^9.1.0
  flutter_facebook_auth: ^7.1.1
  flutter_local_notifications: ^19.4.0
  flutter_localizations: sdk
  flutter_paypal_payment: ^1.0.8
  flutter_rating_bar: ^4.0.1
  flutter_svg: ^2.0.17
  flutter_svg_provider: ^1.0.7
  flutter_switch: ^0.3.2
  get_it: ^8.0.3
  google_sign_in: ^6.3.0
  hive: ^2.2.3
  hive_flutter: ^1.1.0
  http: ^1.4.0
  image_picker: ^1.1.2
  modal_progress_hud_nsn: ^0.5.1
  path: ^1.9.1
  permission_handler: ^12.0.1
  persistent_bottom_nav_bar: ^6.2.1
  provider: ^6.1.5
  shared_preferences: ^2.5.3
  skeletonizer: ^1.4.3
  supabase_flutter: ^2.9.1
  url_launcher: ^6.3.2
  widget_and_text_animator: ^1.1.5

☀️ Light Mode Screenshots (Click to expand)

🔐 Authentication & Onboarding

🏠 Home, Navigation & Search

🍊 Product Display & Reviews

🛍️ Cart & Checkout

👨‍💼 User Profile

🔔 Notifications

🛠️ App Utilities

➕ Additional Features

🌙 Dark Mode Screenshots (Click to expand)

🔐 Authentication & Onboarding

🏠 Home, Navigation & Search

🍊 Product Display & Reviews

🛍️ Cart & Checkout

👨‍💼 User Profile

🔔 Notifications

🛠️ App Utilities

➕ Additional Features

• Flutter SDK (3.0 or higher)
• Dart SDK (2.18 or higher)
• Android Studio / VS Code
• Firebase project
• Supabase account
• PayPal Developer account

1. Clone the Repository

   https://github.com/sayedmostaf/fruits_hub
   cd fruits_hub

2. Install Dependencies

   flutter pub get

3. Firebase Setup

   • Create a Firebase project
   • Add your Android/iOS app to the project
   • Download google-services.json (Android) and GoogleService-Info.plist (iOS)
   • Place them in the appropriate directories

4. Environment Setup

   # Create .env file in root directory
   cp .env.example .env

   Update .env with your credentials:

   SUPABASE_URL=your_supabase_url
   SUPABASE_ANON_KEY=your_supabase_anon_key
   PAYPAL_CLIENT_ID=your_paypal_client_id
   PAYPAL_CLIENT_SECRET=your_paypal_client_secret

5. Run the App

   flutter run

1. Getting Started: Download and install the app, then create your account
2. Browse Products: Use the search and filter features to find your favorite fruits
3. Add to Cart: Select quantity and add items to your shopping cart
4. Secure Checkout: Complete your purchase using PayPal integration
5. Track Orders: Monitor your order status through notifications

lib/
├── 📁 core/
│   ├── entities/          # Business entities and domain models
│   ├── errors/            # Error handling and custom exceptions
│   ├── functions/         # Utility functions and business logic
│   ├── locale/            # Localization files and translations
│   ├── managers/          # State managers and controllers
│   ├── models/            # Data models and DTOs
│   ├── repos/             # Repository pattern implementations
│   ├── services/          # External services and API integrations
│   ├── themes/            # App themes and styling configurations
│   └── utils/             # Helper functions and constants
├── 📁 features/
│   ├── auth/              # Authentication logic and screens
│   ├── best_selling/      # Best selling products feature
│   ├── checkout/          # Checkout and payment flow
│   ├── home/              # Home screen and navigation
│   ├── notifications/     # Push notifications management
│   ├── on_boarding/       # App onboarding screens
│   ├── products/          # Product display and management
│   ├── reviews/           # Product reviews and ratings
│   ├── search/            # Search and filter functionality
│   ├── settings/          # App settings and preferences
│   ├── shopping_cart/     # Shopping cart functionality
│   └── splash/            # Splash screen
└── main.dart              # App entry point

We welcome contributions from the community! Here's how you can help make this project even better:

1. 🍴 Fork the Repository

   git clone https://github.com/yourusername/fruits_ecommerce_app.git

2. 🌿 Create a Feature Branch

   git checkout -b feature/amazing-new-feature

3. 💻 Make Your Changes

   • Follow the existing code style and conventions
   • Add tests for new functionality
   • Update documentation as needed

4. ✅ Test Your Changes

   flutter test
   flutter analyze

5. 📝 Commit Your Changes

   git commit -m "✨ Add amazing new feature"

6. 🚀 Push and Create PR

   git push origin feature/amazing-new-feature

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

Note: This project is actively maintained and regularly updated. Check the releases page for the latest updates and features.