🏋 WorkoutTrackerLib

A small JavaScript library for tracking strength and endurance workouts.
This module lets developers add workouts, log sets, and calculate stats such as total volume, pace, and personal records (1RM).

🧩 Note: This is a developer library — meant to be imported into your own app, not a full workout tracker UI.

🌟 Features

• Add workouts with exercises and sets (strength & endurance).
• Compute workout stats (strength volume, endurance totals, best 1RM).
• Weekly summaries (aggregate stats per week).
• Track personal records (estimated 1RM per exercise).
• Count workout streaks (consecutive days).
• Display workouts in a readable text format.

📦 Installation

Install directly from npm:

npm install workouttrackerlib

Or with yarn:

npm install workouttrackerlib

Your project must be using ES Modules - either name your file .mjs or add "type": "module" to your package.json.

🚀 Usage Example

import { WorkoutTracker } from "workouttrackerlib";

const wt = new WorkoutTracker();

// Add a workout
wt.addWorkout({ id: "w1", date: "2025-09-20", type: "strength" });

// Add an exercise and sets
wt.addExercise("w1", "Bench Press");
wt.addStrengthSet("w1", "Bench Press", { reps: 5, weightKg: 80 });

// Get stats
console.log(wt.workoutStats("w1"));

Output:

{
  id: "w1",
  date: "2025-09-20",
  type: "strength",
  strengthVolumeKg: 400,
  endurance: null,
  details: [
    { exercise: "Bench Press", volumeKg: 400, best1RM: 93.3 }
  ]
}

🧠 API Overview

Class: WorkoutTracker

🧪 Development & Testing

Manual tests: Run the demo app

node examples/demo.js

Automated tests (Jest):

npm test

See testrapport.md for detailed test report.

📚 Documentation

• reflektion.md: Reflections on Clean Code (chapters 2 & 3).
• testrapport.md: Test strategy and results.

📜 License

MIT License © 2025 Anton Wretenberg