🚀 UZA LEARN APPS — Flutter & Dart Cross-Platform Showcase

The Official Portfolio & Applications Showcase by Ubayda Ali

---

📖 Overview | نبذة عن المشروع

UZA LEARN APPS is a modern, high-performance cross-platform application developed with Flutter & Dart. It acts as an interactive, production-style developer showcase modeled after the Google Play Store aesthetic (#01875F). It allows users to browse published mobile apps, explore technical software engineering projects, search in real-time, view interactive screenshots, and connect directly with the developer.

مشروع UZA LEARN APPS هو تطبيق متكامل متعدد المنصات (Cross-Platform) مبني بأحدث معايير Flutter & Dart لتقديم معرض أعمال وتطبيقات احترافي مصمم بهوية بصرية مستلهمة من متجر Google Play. يتيح للمستخدمين استعراض التطبيقات المنشورة، فحص لقطات الشاشة التفاعلية، البحث والفلترة الفورية، والتواصل المباشر مع المطور.

---

✨ Key Features | المميزات الرئيسية

• 🌐 Full Bilingual & Directional Engine (RTL / LTR):
  • Instant toggle between Arabic (RTL) and English (LTR).
  • Dynamic typography: Arabic uses Google Fonts Cairo, while English uses Plus Jakarta Sans.
• 🌓 Adaptive Dual Theme (Light & Dark Mode):
  • Seamless switching between sleek Dark and crisp Light palettes tailored with Material 3.
• 📱 Google Play-Style App Showcase:
  • Cards displaying app icons, titles, ratings, download metrics, categories, and direct store links.
  • In-depth detail screen with an interactive zoomable screenshot carousel (Lightbox).
• 💻 Engineering Projects Catalog:
  • Curated software projects with tech stack chips, source code (GitHub), and live preview links.
• ⚡ Real-Time Live Search & Category Filtering:
  • Instant search across apps, projects, and tech stacks with zero lag.
• 📬 Interactive Contact Modal:
  • Direct communication sheet with form validation and instant feedback.
• 🛠️ In-App Administration Panel:
  • Interactive management screen allowing quick on-the-fly additions to the apps and projects catalog.
• 🛡️ Store-Ready Legal Compliance:
  • Built-in Privacy Policy and Terms of Use screens conforming to Google Play requirements.

---

🏗️ Architecture & Technology Stack

uza_learn_flutter/
├── android/                      # Android Native Configuration & Manifest
├── web/                          # Flutter Web Shell & Manifest
├── assets/                       # Static Assets & Icons
├── lib/
│   ├── main.dart                 # Application Bootstrap & MultiProvider Setup
│   ├── constants/
│   │   ├── app_colors.dart       # Material 3 & Google Play Theme Palette
│   │   ├── app_strings.dart      # Bilingual Localization Dictionary
│   │   └── app_theme.dart        # Light/Dark Theme Definitions & Typography
│   ├── models/
│   │   ├── app_entry.dart        # Immutable App Data Model (JSON serializable)
│   │   ├── project_entry.dart    # Immutable Project Data Model
│   │   └── developer_profile.dart# Developer Profile & Skills Model
│   ├── providers/
│   │   ├── theme_provider.dart   # Reactive Theme Mode State Manager
│   │   ├── locale_provider.dart  # Reactive Language & RTL/LTR State Manager
│   │   └── portfolio_provider.dart# Search, Filtering, and Data Mutation State
│   ├── widgets/
│   │   ├── nav_header.dart       # Responsive App Bar with Language/Theme Controls
│   │   ├── app_card.dart         # Google Play Store Item Card
│   │   ├── project_card.dart     # Tech Project Showcase Card
│   │   ├── screenshot_carousel.dart # Interactive Lightbox Carousel
│   │   ├── stat_card.dart        # Metric & Statistics Counter
│   │   └── contact_bottom_sheet.dart# Form Modal for Inquiries
│   └── screens/
│       ├── home_screen.dart      # Hero Banner, Metrics, and Dynamic Slivers
│       ├── app_details_screen.dart # Detailed App View & Direct Download
│       ├── project_details_screen.dart # Technical Breakdown of Projects
│       ├── admin_screen.dart     # Catalog Management Dashboard
│       ├── privacy_screen.dart   # Legal Privacy Policy Screen
│       └── terms_screen.dart     # Terms of Use Screen
├── pubspec.yaml                  # Dependencies & SDK Configuration
└── analysis_options.yaml         # Dart Analyzer & Linter Rules

Core Libraries & Dependencies:

Package	Version	Purpose
provider	^6.1.2	Clean, decoupled state management
google_fonts	^6.2.1	Dynamic typography (Cairo & Plus Jakarta Sans)
cached_network_image	^3.4.0	High-performance image caching & memory management
url_launcher	^6.3.2	Deep-linking to Google Play, GitHub, and email
flutter_localizations	SDK	Native RTL/LTR handling and standard localization
intl	^0.20.2	Internationalization and date formatting
share_plus	^9.0.0	Native cross-platform content sharing

---

🚀 Getting Started | كيفية التشغيل

Prerequisites

• Flutter SDK (>= 3.0.0)
• Dart SDK (>= 3.0.0)
• Google Chrome (for Web) or Android Studio / VS Code with Android Emulator.

Installation

1. Clone the repository:

   git clone https://github.com/ubaydaali/uza_learn_apps_flutter.git
   cd uza_learn_apps_flutter/uza_learn_flutter

2. Fetch all dependencies:

   flutter pub get

3. Run on Web (Google Chrome):

   flutter run -d chrome --web-port 8080

4. Run on Android Emulator / Physical Device:

   flutter run

Building for Production

• Generate Android Release APK:

  flutter build apk --release

• Generate Google Play App Bundle (AAB):

  flutter build appbundle --release

• Generate Web Production Bundle:

  flutter build web --release

---

👨‍💻 Author & Contact | المطور والتواصل

Ubayda Ali (عبيدة علي)
Senior Mobile Solutions & Flutter Software Engineer

• 📧 Email: ubaydaali@onws.net
• 🐙 GitHub: @ubaydaali
• 💼 LinkedIn: Ubayda Ali
• 🛍️ Google Play Developer Console: UZA LEARN

---

📄 License

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