#
# 🏈 GameTime
**Your Fantasy Football Command Center**
*Track all your leagues, matchups, and players in one sleek dashboard*
[](https://python.org)
[](https://flask.palletsprojects.com/)
[](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*