Don't forget to star our repository

🏋️ Athletix

Athletix is a Flutter-based mobile application designed to streamline collaboration between athletes, coaches, doctors, and sports organizations. It offers a centralized platform to manage tournaments, track performance and injuries, maintain schedules, and facilitate communication while respecting user roles.

---

🚀 Features

🔐 Authentication & Role-based Access

• Firebase Authentication: Secure login for all users.
• Role-based Access (RBA):
  • Four user roles: Athletes, Doctors, Coaches, and Organizations
  • Each role has a distinct dashboard with specific permissions.
  • Role checked via Firestore role field, redirecting users post-login.
• Signup & Login:
  • Separate signup and login flows for Athletes, Doctors, and Coaches.
  • Login-only access for Organizations.

📋 Profiles

• Athletes: Includes personal details and their sport.
• Doctors: Includes personal details and specialization.
• Coaches: Includes their sport.
• Organizations: Associated with a specific sport.

🗓️ Timetable & Notifications

• Users can create and save activity timetables in Firestore.
• Push notifications sent via Firebase Cloud Messaging (FCM) at the start of each activity.

📈 Injury & Performance Logs

• Athletes can log:
  • Injury logs: Details for doctors and monitoring.
  • Performance logs: Track progress over time.
• Logs are securely stored in Firestore and accessible to doctors and coaches.

🗺️ Tournaments with Google Maps

• Organizations can create tournaments with:
  • Name, level (District, State, National, International), date, time, and location using Google Maps SDK.
  • Data stored in Firestore under the tournaments collection.
• Athletes can:
  • View upcoming tournaments filtered by their sport.
  • See tournaments as markers on an interactive map.
  • Tap markers to view tournament details (level, date, time, address) in a modal.

---

🛠️ Setup Guide

✅ Prerequisites

• Flutter SDK
• Git
• A physical Android device (recommended)

---

📥 Clone Your Fork

git clone https://github.com/<your-username>/Athletix.git
cd Athletix

📦 Install Dependencies

flutter pub get

▶️ Run the App

flutter run

📱 Tip: It's recommended to use a physical Android device for better performance during development.

---

🧱 Tech Stack

Technology	Description
📱 Flutter	Cross-platform UI toolkit
🔥 Firebase	Auth | Firestore | FCM (notifications)
🗺️ Google Maps SDK	Interactive maps for tournaments
📦 Flutter Local Notifications	For scheduling reminders

---

🗂️ Project Structure

Athletix/
├── android/
├── assets/
│   ├── applogo.png
│   └── Running_Boy.json
├── functions/
├── ios/
├── lib/
│   ├── components/
│   │   ├── bottom_nav_bar.dart
│   │   └── fcm_listener.dart
│   ├── screens/
│   │   ├── athlete/
│   │   │   ├── athlete_dashboard.dart
│   │   │   ├── calendar_screen.dart
│   │   │   ├── injury_tracker_screen.dart
│   │   │   ├── performance_logs_screen.dart
│   │   │   └── tournaments_screen.dart
│   │   ├── coach/
│   │   │   └── coach_dashboard.dart
│   │   ├── doctor/
│   │   │   └── doctor_dashboard.dart
│   │   ├── organization/
│   │   │   ├── add_tournament_screen.dart
│   │   │   ├── manage_players_screen.dart
│   │   │   └── organization_dashboard.dart
│   │   ├── auth_screen.dart
│   │   ├── profile_screen.dart
│   │   └── splash_screen.dart
│   └── main.dart
├── linux/
├── macos/
├── test/
├── web/
├── windows/
├── .firebaserc
├── .gitignore
├── .metadata
├── analysis_options.yaml
├── CODE_OF_CONDUCT.md
├── DEVELOPMENT.md
├── CONTRIBUTING.md
├── firebase.json
├── LICENSE
├── pubspec.lock
├── pubspec.yaml
└── README.md

---

🧩 Troubleshooting

1. 🔥 Firebase Configuration Missing

Issue: App throws Firebase initialization error. Solution: -Download your google-services.json file from Firebase Console. -Place it in android/app/ directory.

2. 📦 Plugin Issues

Issue: Plugin not found or version mismatch. Solution: -Run flutter pub get to reinstall dependencies. -Check for version conflicts in pubspec.yaml.

3. 🗺️ Google Maps Not Showing

Issue: Map doesn't load or crashes. Solution: -Ensure you've added your Google Maps API key in the android/app/src/main/AndroidManifest.xml. -Enable Maps SDK in your Google Cloud console.

4. 🚫 Emulator Permission Issues

Issue: Notifications or Maps don't work on emulator. Solution: -Use a real device when possible. -Emulators may lack Play Services or required permissions.

🧪 How to Run Tests

To run the Flutter tests:

flutter test

This will execute all unit and widget tests in the test/ directory.

---

🤝 How to Contribute

We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to get started, report issues, or submit pull requests.

---

📫 Contact / Support

For questions, suggestions, or support, please open an issue on GitHub or contact the maintainers via the repository.

📜 License

This project is licensed under the MIT License

⬆️ Back to Top