swim-data-analyser

The swim-data-analyser is a tool to manipulate and analyze swim workouts from FIT files as provided by Garmin devices. It is heavily inspired by Swimming Watch Tools.

The goal is to provide full client-side parsing and handling of the data, ensuring that no data is transmitted to the server. Your files are processed entirely in your browser.

development

The project uses Nix flakes to manage development dependencies.

dev environment:

nix develop

getting started:

npm install

spin up dev server (with HMR):

npm run dev

deployment

The project is a pure static site. It can be built and served via any web server.

Build

npm run build

The output will be in the dist/ directory.

Docker

1. Build the Docker Image:

docker build -t swim-data-analyser:latest .

2. Run the container:

docker run -d --restart=unless-stopped -p 8080:80 swim-data-analyser:latest

The app will be available at http://localhost:8080.

used libraries

• parsing and encoding of .fit files: @garmin/fitsdk
• plots: plotly.js
• build tool: Vite