102 lines
No EOL
2.7 KiB
Markdown
102 lines
No EOL
2.7 KiB
Markdown
# <div align="center"><img src="gametime_logo.png" alt="GameTime Logo" width="200"/></div>
|
|
|
|
<div align="center">
|
|
|
|
# 🏈 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)
|
|
|
|
</div>
|
|
|
|
## 🚀 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.
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
**Ready for GameTime?** 🏈
|
|
|
|
*Built with ❤️ for fantasy football fanatics*
|
|
|
|
</div> |