███████╗██╗   ██╗███████╗███╗   ██╗████████╗██╗███████╗██╗   ██╗
██╔════╝██║   ██║██╔════╝████╗  ██║╚══██╔══╝██║██╔════╝╚██╗ ██╔╝
█████╗  ██║   ██║█████╗  ██╔██╗ ██║   ██║   ██║█████╗   ╚████╔╝ 
██╔══╝  ╚██╗ ██╔╝██╔══╝  ██║╚██╗██║   ██║   ██║██╔══╝    ╚██╔╝  
███████╗ ╚████╔╝ ███████╗██║ ╚████║   ██║   ██║██║        ██║   
╚══════╝  ╚═══╝  ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝╚═╝        ╚═╝   
                                                FRONTEND APP

🎟️ Eventify Frontend

A beautifully crafted, fully responsive Flutter application for event management, discovery, and attendance.

---

🌟 Overview

Eventify Frontend is the official Flutter mobile and desktop application counterpart of the Eventify Dashboard (React). Built with performance and elegance in mind, it delivers a dynamic native experience offering the same powerful features as its web counterpart.

Whether you're an attendee looking for the next big conference or an administrator managing your personal agenda, Eventify has you covered. The application seamlessly adapts its UI between mobile and desktop form-factors.

✨ Key Features & Capabilities

• 📱 Fully Responsive Dual-Layouts: Distinct, optimized UI layouts for both Mobile and Desktop screens (DesktopLoginScreen vs LoginScreen, HomeDesktopScreen vs HomeScreen) utilizing a strict breakpoint system.
• 🌗 Native Theming & Dark Mode: Integrated ThemeManager supporting real-time reactive toggles between fully customized Light and Dark modes.
• 📅 Interactive Calendars & Booking: Effortlessly browse and manage your events and tickets using integrated calendar views (table_calendar).
• 📍 Location Services: Precise event mapping and real-time location detection powered by cutting-edge geo-packages (geocoding & geolocator).
• 📸 Media Integration: Instantly share moments or update your profile via secure native image picking (image_picker).
• 💾 Fast & Reliable Local Storage: Lightning-fast offline-ready credential and preference caching using shared_preferences.
• 🎨 Sleek UI/UX: A pixel-perfect interface translated beautifully into a responsive application, complete with deep profile management, customized settings, and ticket overview screens.
• 🚀 Polished Details: Brand-aligned custom launcher icons (flutter_launcher_icons) and native splash screens (flutter_native_splash) built right in.

🛠️ Architecture & Tech Stack

This project strictly adheres to a modularized folder structure designed for scalability:

• Core Framework: Flutter (SDK: ^3.0.0 target)
• Local Data Caching: shared_preferences
• Media Management: image_picker
• Date Management: table_calendar
• Location & Analytics: geolocator & geocoding

🏗️ Directory Organization

lib/
├── core/
│   ├── api/              # API interceptors and client setup
│   ├── storage/          # Local caching implementations
│   ├── constants.dart    # Environment constants and static keys
│   ├── theme_manager.dart# Dark/Light mode state management
│   └── app_decoration.dart
├── features/
│   ├── auth/             # Authentication BLOC/Services
│   └── events/           # Core event manipulation logic
├── screens/
│   ├── booking_screen.dart       # Event booking flow
│   ├── calendar_screen.dart      # Interactive calendar tools
│   ├── home_screen.dart          # Mobile Home Feed
│   ├── home_desktop_screen.dart  # Desktop Home Dashboard
│   ├── login_screen.dart         # Mobile Login
│   ├── desktop_login_screen.dart # Desktop Login
│   ├── profile_screen.dart       # User user settings
│   ├── search_screen.dart        # Event lookups
│   ├── responsive_layout.dart    # Core Layout Builder
│   └── ...
└── main.dart             # Application Entry Point & Route Builder

🚀 Getting Started

Follow these steps to get your development environment set up and running locally.

Prerequisites

• Flutter SDK installed on your machine.
• An IDE with Flutter support (VS Code, Android Studio, IntelliJ).
• An active iOS Simulator, Android Emulator, or a Web/Desktop target enabled.

Installation

1. Clone the repository

   git clone https://code.bshtech.net/Sicherhaven/Eventify-frontend.git
   

2. Navigate to the directory

   cd Eventify-frontend
   

3. Install dependencies

   flutter pub get
   

4. Regenerate Assets (Optional but recommended) If you have updated icons or splash screens, run:

   flutter pub run flutter_launcher_icons:main
   flutter pub run flutter_native_splash:create
   

5. Run the app

   flutter run
   

🔐 Authentication & State

The app uses an initialization check in main.dart that intercepts the launch view to determine if the user has an existing cached session (email stored via SharedPreferences).

• If authenticated: Safely navigates the user to the HomeScreen / HomeDesktopScreen.
• If unauthenticated: Routes the user to the LoginScreen / DesktopLoginScreen.

---

📋 Changelog

See CHANGELOG.md for a full history of changes.

Latest (v1.4.0 — Preview)

• Desktop Contribute Dashboard rebuilt to match the web version (Contributor Dashboard, 3-tab nav, two-column form, leaderboard, achievements, reward shop)
• Gamification module — EP, RP, leaderboard, achievements, shop with Provider state management
• Profile screen redesigned to match the web app layout with animations
• Enhanced animations, responsive improvements, Gilroy font suite, and API updates

---

_{Built with ❤️ by the Eventify Team}