https://github.com/itskovacs/wingfit

Minimalist fitness app to plan your workouts, track your personal records and leverage smartwatch data
https://github.com/itskovacs/wingfit

fitness fitness-app health selfhosted sport sports workout workout-tracker

Last synced: 4 months ago
JSON representation

Minimalist fitness app to plan your workouts, track your personal records and leverage smartwatch data

• Host: GitHub
• URL: https://github.com/itskovacs/wingfit
• Owner: itskovacs
• License: other
• Created: 2025-02-10T16:29:51.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-08-11T15:52:36.000Z (10 months ago)
• Last Synced: 2025-08-24T04:05:35.268Z (9 months ago)
• Topics: fitness, fitness-app, health, selfhosted, sport, sports, workout, workout-tracker
• Language: TypeScript
• Homepage: https://wingfit.fr
• Size: 3.65 MB
• Stars: 229
• Watchers: 2
• Forks: 9
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: license.txt
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-health-fitness-oss - GH

README

          


Wingfit




![Status](https://img.shields.io/badge/status-active-success?style=for-the-badge)

[![GitHub Issues](https://img.shields.io/github/issues/itskovacs/wingfit?style=for-the-badge&color=ededed)](https://github.com/itskovacs/wingfit/issues)

[![License](https://img.shields.io/badge/license-_CC_BY_NC_SA_4.0-2596be?style=for-the-badge)](/LICENSE)





🏋️ The wingman for your fitness 






![Wingfit Planning](./.github/screenshot.png)



## 📝 Table of Contents

- 📦 [About](#about)

- 🌱 [Getting Started](#getting_started)

- 📸 [Demo](#Demo)

- 🚧 [Roadmap](#Roadmap)

- 📜 [License](#License)

- 🤝 [Contributing](#Contributing)

- 🛠️ [Tech Stack](#techstack)

## 📦 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](#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](https://github.com/itskovacs/wingfit/issues).

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:

```bash

docker-compose up -d

```

### Option 2: Docker Run

```bash

# 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](https://github.com/itskovacs/wingfit/tree/main/docs/config.md) to set up OIDC authentication and other settings.




## 📸 Demo 

A demo is available at [Wingfit.fr](https://wingfit.fr).



|         |         |

|:-------:|:-------:|

| ![](./.github/sc_planning.png) | ![](./.github/sc_blocs.png) |

| ![](./.github/sc_pr.png) | ![](./.github/sc_statistics.png) |

| ![](./.github/sc_programs.png) | ![](./.github/sc_program.png) |






## 🚧 Roadmap 

New features coming soonTM, check out the development plan in the [Roadmap Wiki](https://github.com/itskovacs/wingfit/wiki/Roadmap). 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](#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






If you like Wingfit, consider giving it a **star** ⭐!  

Made with ❤️ in BZH