README.md

Wingfit

🏋️ The wingman for your fitness

📝 Table of Contents

• 📦 About
• 🌱 Getting Started
• 📸 Demo
• 🚧 Roadmap
• 📜 License
• 🤝 Contributing
• 🛠️ Tech Stack

📦 About

Wingfit is a minimalist fitness app to plan your workouts, track your personal records and leverage smartwatch data.

Demo is worth a thousand words, head to 📸 Demo.

🔒 Privacy-First – No telemetry, no tracking, fully self-hostable. You own your data. Inspect, modify, and contribute freely.

🌱 Getting Started

If you need help, feel free to open an issue.

Deployment is designed to be simple using Docker.

Option 1: Docker Compose (Recommended)

Use the docker-compose.yml file provided in this repository. No changes are required, though you may customize it to suit your needs.

Run the container:

docker-compose up -d

Option 2: Docker Run

# Ensure you have the latest image
docker pull ghcr.io/itskovacs/wingfit:5

# Run the container
docker run -d -p 8080:8000 -v ./storage:/app/storage ghcr.io/itskovacs/wingfit:5

Refer to the configuration documentation to set up OIDC authentication and other settings.

📸 Demo

A demo is available at Wingfit.fr.

🚧 Roadmap

New features coming soon^TM, check out the development plan in the Roadmap Wiki. If you have ideas 💡, feel free to open an issue.

If you want to develop new feature, feel free to open a pull request (see 🤝 Contributing).

📜 License

I decided to license Wingfit under the CC BY-NC-SA 4.0 – You may use, modify, and share freely with attribution, but commercial use is prohibited.

🤝 Contributing

Contributions are welcome! Feel free to open issues if you find bugs and pull requests for your new features!

1. Fork the repo
2. Create a new branch (my-new-wingfit-feature)
3. Commit changes
4. Open a pull request

🛠️ Tech Stack

Frontend

• 🅰️ Angular 19
• 🏗️ PrimeNG 19
• 🎨 Tailwind CSS 4

Backend

• 🐍 FastAPI, SQLModel
• 🗃️ SQLite