Skip to content

WolfBot2026/fitness-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’ͺ Fitness Tracker

A comprehensive React-based workout tracking application designed for the 12-week Core Strength & Weight Management program.

React Vite

✨ Features

πŸ‹οΈ Workout Tracking

  • Pre-loaded Workout Program: Complete 12-week program with Monday, Wednesday, Friday, and optional Saturday workouts
  • Exercise Details: Sets, reps, rest periods, and form notes for each exercise
  • Live Tracking: Log weight and reps for each set during your workout
  • Phase Progression: Foundation (Weeks 1-4), Build (5-8), Peak (9-12)

πŸ“Š Progress Monitoring

  • Workout History: View all completed workouts with dates and details
  • Weekly Stats: Track workouts by week and day
  • Consistency Streak: See your current workout streak
  • Visual Analytics: Charts and graphs showing progress over time

πŸ’Ύ Data Persistence

  • LocalStorage: All workout data saved automatically in your browser
  • No Account Required: Works offline, no login needed
  • Export/Import: Backup and restore your data (coming soon)

πŸš€ Quick Start

Installation

# Clone the repository
git clone https://github.com/WolfBot2026/fitness-tracker.git
cd fitness-tracker

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:5173 to use the app.

Building for Production

npm run build
npm run preview

πŸ“± How to Use

1. Select Your Workout Day

Click on the day tabs (Mon, Wed, Fri, Sat) to view that day's workout.

2. Track Your Sets

For each exercise:

  • Enter the weight used (in lbs)
  • Log reps or time completed
  • The app saves your progress automatically

3. Complete Your Workout

Hit the "Complete Workout" button when done to log the workout to your history.

4. Monitor Progress

  • History Tab: View all past workouts
  • Stats Tab: See trends, streaks, and weekly breakdowns

πŸ“… Workout Program Structure

Monday: Core Foundation + Upper Body

  • Plank Series
  • Push-ups
  • Pallof Press
  • Dumbbell Rows
  • Overhead Press
  • Finisher Circuit

Wednesday: Lower Body + Core Stability

  • Goblet Squats
  • Romanian Deadlifts
  • Split Squats
  • Plank Shoulder Taps
  • Copenhagen Planks
  • Finisher Circuit

Friday: Full Body Power + Core

  • Circuit format (3-4 rounds)
  • Kettlebell Swings
  • Renegade Rows
  • Reverse Lunges
  • Russian Twists
  • Thrusters
  • Bicycle Crunches

Saturday (Optional)

  • Active Recovery: Walking, stretching, foam rolling
  • Core Blast: 20-minute focused core workout

🎯 12-Week Progression

Weeks 1-4: Foundation Phase

  • Focus on perfect form
  • Use lighter weights
  • Build work capacity

Weeks 5-8: Build Phase

  • Increase weight by 5-10%
  • Add 1-2 reps per set
  • Decrease rest time

Weeks 9-12: Peak Phase

  • Maximize strength gains
  • Push intensity while maintaining form
  • Hit target goals

πŸ’‘ Features Breakdown

LocalStorage Structure

{
  workoutHistory: [
    {
      id: timestamp,
      date: "2026-01-28T...",
      day: "monday",
      week: 1,
      exercises: { ... },
      completed: true
    }
  ],
  currentWeek: 1
}

Responsive Design

  • Mobile-first approach
  • Works on phones, tablets, and desktops
  • Touch-friendly interface

Performance

  • Fast load times with Vite
  • Optimized re-renders with React hooks
  • Minimal dependencies

πŸ› οΈ Technology Stack

  • React 19 - UI library
  • Vite 7 - Build tool and dev server
  • CSS3 - Custom styling (no frameworks)
  • LocalStorage API - Data persistence

πŸ“ Upcoming Features

  • Export workout history as CSV/JSON
  • Import previous workout data
  • Exercise videos and GIFs
  • Personal records (PR) tracking
  • Body weight and measurements logging
  • Dark mode
  • Workout templates/customization
  • Rest timer between sets
  • Mobile app (React Native)

🎨 Customization

The app uses CSS variables for easy theming:

:root {
  --primary: #6366f1;
  --secondary: #8b5cf6;
  --success: #10b981;
  /* ... */
}

🀝 Contributing

This is a personal project, but suggestions and feedback are welcome!

πŸ“„ License

MIT License - Feel free to use this for your own fitness tracking!

πŸ’ͺ Workout Program Credits

Based on the "Core Strength & Weight Management Program" designed specifically for:

  • Age 48+
  • Core strength focus
  • Joint-friendly movements
  • Sustainable fitness

Built by WolfBot2026 β€’ Track your workouts, smash your goals! πŸ”₯

About

πŸ’ͺ Personal fitness and workout tracking app - Track workouts, log progress, stay consistent

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors