- Commit untracked posthog_service.dart (fire-and-forget HTTP client,
EU data residency, already used by auth for identify/reset)
- screen() calls: Home, Contribute, Profile, EventDetail (with event_id)
- capture('event_tapped') on hero carousel card tap (source: hero_carousel)
- capture('book_now_tapped') in _navigateToCheckout (event_id + name)
- capture('review_submitted') in _handleSubmit (event_id + rating)
- Covers all 4 expansion items from security audit finding 8.2
███████╗██╗ ██╗███████╗███╗ ██╗████████╗██╗███████╗██╗ ██╗
██╔════╝██║ ██║██╔════╝████╗ ██║╚══██╔══╝██║██╔════╝╚██╗ ██╔╝
█████╗ ██║ ██║█████╗ ██╔██╗ ██║ ██║ ██║█████╗ ╚████╔╝
██╔══╝ ╚██╗ ██╔╝██╔══╝ ██║╚██╗██║ ██║ ██║██╔══╝ ╚██╔╝
███████╗ ╚████╔╝ ███████╗██║ ╚████║ ██║ ██║██║ ██║
╚══════╝ ╚═══╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═╝╚═╝ ╚═╝
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 (
DesktopLoginScreenvsLoginScreen,HomeDesktopScreenvsHomeScreen) utilizing a strict breakpoint system. - 🌗 Native Theming & Dark Mode: Integrated
ThemeManagersupporting 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.0target) - 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
-
Clone the repository
git clone https://code.bshtech.net/Sicherhaven/Eventify-frontend.git -
Navigate to the directory
cd Eventify-frontend -
Install dependencies
flutter pub get -
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 -
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