About this project

Fiestaaa Front is a Flutter 3.44 / Dart 3.11 frontend application for organizing private events with friends and family. It is licensed under MPL-2.0 and integrates with Firebase. Features include: - Authentication via Google Sign-In, Sign in with Apple, and email/password - Event creation and full event management with custom details - Invitations sent and managed via email - Collaborative item/shopping lists - Carpool organization with participants - Shared expense tracking and splitting among attendees - Access QR codes for entry management - Push notifications via Firebase Cloud Messaging (FCM) - User preferences customization The app targets web, Android, and iOS. Local development requires configuring environment variables (API URL, OAuth client IDs, Firebase config, FCM VAPID key) in a .env file. A Firebase web service worker is generated from a template and environment variables via a Dart tool. Development tooling includes dart format, flutter analyze, and flutter test with coverage reporting. CI enforces a 22% line-coverage floor. Security scans in CI include workflow linting, Dockerfile checks, and a full-history Gitleaks scan. Production web builds use a Dockerfile with Nginx serving. Android release builds use local signing files if present. Signed IPA builds and official web image publication are handled in a private operations repository; this public repository provides source code, local build instructions, and public CI only. A companion Rust backend repository (fiestaaa_back) exists separately. Project documentation includes architecture, first contribution, roadmap, third-party notices, governance, and trademark guidelines.