Welcome
Overview
Full stack fitness tracking application using TinyDB, FastAPI, Svelte and Docker.
Store weight-training records in year-based <YEAR>_workouts.yml files, each
containing a TinyDB weight_training_log table. Import logs into the year of
each workout, then browse the data through the read-only FastAPI service and
Svelte frontend.
The browser opens the latest available year and supports date ordering, pagination, and exercise-set details. Workouts have permanent UUIDs, so multiple sessions on the same day remain distinct. Imports validate calendar dates and record structure before writing; malformed legacy records are logged and omitted from API results.
The API caches parsed records and indexes workout IDs. File identity, size, and modification/change timestamps invalidate changed data without a server restart. API reads do not modify the workout files. Browser responses can remain cached for up to 60 seconds under the existing private cache policy.
Most of the project, in particular src supports all major platforms (Windows, Linux and MacOS), but the cli bin/fitcli.sh currently supports Linux and MacOS only.
Getting Started
Follow the examples to install dependencies, import logs, and run the application. For an existing data directory, follow the workout ID migration guide before editing or renumbering legacy records.
See the browser workflow checks for desktop and mobile testing, the OpenAPI reference for the API contract, and the changelog for recent changes and verification status.
References
The development and concepts behind this fitness tracker are influenced by the following references:
Book
The book "Exercise Physiology: Nutrition, Energy, and Human Performance" provides detailed information on exercise physiology, nutrition, energy, and human performance, which, together with other textbooks and articles, form the foundation of the algorithms and recommendations used in this application.
Education
My formal education as both a fitness instructor at the "At Work" school as well as a Running Coach at the "DGI" school has provided me with the theoretical and practical knowledge necessary to design effective fitness programs and tracking systems. In addition, I hold the instructor certificate in Leung Ting Wing Tsun from "Wing Tsun Instructor Academy" which besides main focus on this discipline, incorporated elements of strength and cardio training, nutrition, yoga and more.
Professional Experience
My hands-on experience working as a fitness instructor at SATS for two years has given me valuable insights into the practical aspects of fitness training and client management. This experience has been instrumental in shaping the user experience and functionality of this application. I furthermore had the priveledge to teach classes at various martial arts gyms across different styles, across greater Copenhagen for a number of years.
Similar projects
If you liked this fitness tracker then you might also be interested in
the workout-generator Django project,
the nutrition-planner Streamlit project, with associated development guide:
medium,
the athlete project,
or the Dojo martial arts project
which can be found on GitLab and is a Rust & TypeScript based general purpose martial arts desktop application