Sports Aggregator Mobile App

📱 Overview

A sports aggregator mobile application built with Flet, a Flutter-powered framework for Python. This app allows users to discover sports events, book sports venues, create teams, and interact with other sports enthusiasts.

🏗️ Architecture

The application follows a structured architecture:

Sports_Aggregator_MobileApp_Flet/
├── main.py                  # Entry point
├── navigation/              # Navigation components
│   ├── FletRouter.py        # Route management
│   └── bar.py               # Bottom navigation bar
├── pages/                   # UI screens
│   ├── login.py             # Authentication screen
│   ├── main.py              # Main dashboard
│   ├── events.py            # Sports events listing
│   ├── event_detail.py      # Event details
│   ├── platforms.py         # Sports venues listing
│   ├── platform_details.py  # Venue details
│   ├── profile.py           # User profile
│   └── other/               # Additional screens
├── other                    # and other files and folders
└── api.py                   # Backend API integration

✨ Features

• User Authentication: Login and registration system
• Events Discovery: Browse and filter sports events
• Venue Booking: Find and book sports venues
• Team Management: Create and join sports teams
• Social Interaction: Follow users and like events
• Profile Management: View and update user profile

🔧 Technology Stack

• Frontend: Flet (Python-based Flutter framework)
• Backend: FastAPI
• Environment: pipenv for virtual environment management
• API Communication: httpx for HTTP requests

🚀 Getting Started

Prerequisites

• Python 3.11.4 or newer
• pipenv

Installation

1. Clone the repository:

   git clone https://github.com/Ambassador-of-programming/Sports_Aggregator_MobileApp_Flet.git
   cd Sports_Aggregator_MobileApp_Flet
   

2. Set up the virtual environment:

   pipenv install
   pipenv shell
   

3. Run the application:

   pipenv run python main.py
   

🔌 API Integration

The application integrates with a FastAPI backend. The API client is implemented in rest_api/api.py and provides functions for:

• User management
• Event discovery and registration
• Sports venue booking
• Team management
• Feed and content interaction

Backend repository: Sports_Aggregator_FastAPI

📋 Component Details

Navigation

• FletRouter: Manages screen transitions and route handling
• Appbar: Custom bottom navigation bar with icons and labels

Screens

• Login: User authentication
• Main Menu: Dashboard with quick access to features
• Events: List of upcoming sports events
• Platforms: Available sports venues for booking
• Profile: User information and statistics

📱 Screenshots

Main Screens

Main Page

Events List

Events View

Event Details

Event Details

Matches

Tournament Bracket

Venue Booking

Venue Details	Service Selection	Date & Time Selection
Booking Confirmation

Team Management

Team Search	Create Team	Team Selection
Team Selection View

Event Registration

Solo Sports Registration

Team Sports Registration

Match Statistics

Match Overview

Match Statistics

Team Composition

Note: The screenshots above are examples. The actual app interface may vary based on the latest updates.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Related Projects

• Sports Aggregator FastAPI Backend