#
GameTime Logo
# 🏈 GameTime **Your Fantasy Football Command Center** *Track all your leagues, matchups, and players in one sleek dashboard* [![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://python.org) [![Flask](https://img.shields.io/badge/Flask-2.3.3-green.svg)](https://flask.palletsprojects.com/) [![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://docker.com)
## 🚀 What is GameTime? GameTime is your all-in-one fantasy football dashboard that connects to Sleeper and ESPN to give you the ultimate game day experience. See all your leagues, matchups, and live scores in one beautiful interface. ### ✨ Features - 📊 **Multi-League Dashboard** - View all your Sleeper leagues at once - 🔴 **Live Score Updates** - Real-time score refreshes during game day - 📅 **NFL Schedule Integration** - See when your players are playing - 🌙 **Dark/Light Theme** - Switch themes for day or night viewing - 📱 **Mobile Responsive** - Looks great on all devices - 🐳 **Docker Ready** - Easy deployment with containers ## 🏃‍♂️ Quick Start ### Option 1: Local Development ```bash # Install dependencies pip install -r requirements.txt # Run the app python app.py # Visit http://localhost:5000 ``` ### Option 2: Docker ```bash # Build and run docker-compose up # Or run detached docker-compose up -d ``` ## 🎮 How to Use 1. **Enter your Sleeper username** on the homepage 2. **View your dashboard** - see all leagues and current week matchups 3. **Navigate weeks** - check past weeks or look ahead 4. **Live updates** - scores refresh automatically during games 5. **Theme switching** - toggle between light and dark modes ## 🛠 Tech Stack - **Backend**: Flask (Python) - **APIs**: Sleeper API, ESPN API - **Frontend**: HTML, CSS, JavaScript - **Deployment**: Docker + Docker Compose ## 📁 Project Structure ``` gametime/ ├── app.py # Main Flask application ├── config.py # App configuration ├── services/ # API integrations │ ├── sleeper_api.py # Sleeper API client │ └── espn_api.py # ESPN API client ├── templates/ # HTML templates ├── static/ # CSS and assets └── ContainerFile # Docker build config ``` ## 🤝 Contributing Got ideas for GameTime? We'd love to hear them! 1. Fork the repo 2. Create a feature branch 3. Make your changes 4. Submit a pull request ## 📜 License This project is open source and available under the MIT License. ---
**Ready for GameTime?** 🏈 *Built with ❤️ for fantasy football fanatics*