Groupy - Multiplayer Agenda 📅

Groupy is a collaborative group planning application built with Flutter and Firebase. It was born from the idea of creating a "multiplayer agenda" — a place where friends, families, or teams can sync their schedules and plan events seamlessly in real-time.

🚀 Motivation

The project started as a personal journey into mobile app development. The goal was to solve a common friction point: coordinating schedules across a group without the back-and-forth of messaging apps. Groupy allows users to create groups, see a shared calendar, and manage collective "agendas" in one place.

✨ Key Features

• Real-time Sync: Instant updates across all group members using Cloud Firestore.
• Shared Calendar: A unified view of all group events (powered by table_calendar).
• Group Management: Create, join, and manage multiple groups with unique invite codes.
• User Profiles: Personalized experience with profile management.
• Dynamic Deep Linking: Seamless group joining via shared links.
• Multi-platform Native: Consistent experience across iOS and Android.

🛠️ Tech Stack

• Framework: Flutter
• State Management: Provider
• Backend: Firebase (Auth, Firestore, Storage, Analytics, Crashlytics)
• UI Components: awesome_snackbar_content, quickalert, iconly
• Utilities: shared_preferences, url_launcher, share_plus, intl

🏗️ Architecture

The project follows a modular structure:

• lib/screens/: UI-heavy widgets organized by feature (Auth, Agenda, Team, User).
• lib/providers/: Business logic and state management.
• lib/services/: Abstracted backend interactions (Firebase, Fetching).
• lib/models/: Data structures for Events, Groups, and Users.

⚠️ Project Status (Legacy)

Note

This project is currently in a legacy/paused state. It is not actively maintained and some features (like Firebase Dynamic Links) may require updates to work with current API standards. It is shared here as a reflection of my mobile development journey and architectural decisions.

⚙️ Setup & Installation

Since this project requires a Firebase configuration, follow these steps to run it locally:

1. Clone the repository: git clone https://github.com/yourusername/groupy.git
2. Install dependencies: flutter pub get
3. Set up a Firebase Project.
4. Add your google-services.json (Android) and GoogleService-Info.plist (iOS) to the respective directories.
5. Update lib/firebase_options.dart with your project's credentials.
6. Run the app: flutter run

📄 License

Distributed under the MIT License. See LICENSE for more information.