Skip to content

Abhi-MS/gymApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

45 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’ͺ GymApp - Your Personal Fitness Tracker

React JavaScript CSS3 GitHub Pages

A comprehensive fitness tracking application with advanced analytics, weekly planning, and interactive workout management

🌐 Live Demo | πŸ“± Features | πŸš€ Getting Started


πŸŽ₯ App Demo

Live Demo Video

See the app in action - tracking reps and managing workouts

RepTrack.1.mp4
RepTrack.2.mp4
RepTrack.3.mp4

Note: The video above demonstrates the app's core features including exercise tracking, rep counting, and workout management.


✨ Features

🎯 Core Functionality

  • πŸ“ˆ Advanced Progress Tracking - Interactive charts with multiple metrics (weight, reps, sets, duration, distance, calories)
  • πŸ“… Interactive Workout Calendar - Full-featured calendar with FullCalendar integration
  • πŸ’Ύ Intelligent Data Persistence - Smart local storage with workout history and plans
  • πŸ“± Fully Responsive Design - Optimized for desktop, tablet, and mobile devices

πŸ‹οΈ Comprehensive Exercise Library

  • ❀️ Cardio - 25+ activities including running, cycling, HIIT, and swimming
  • πŸ’ͺ Upper Body - 60+ exercises covering biceps, triceps, chest, shoulders, and back
  • 🦡 Lower Body - 40+ exercises for quads, hamstrings, glutes, and calves
  • πŸ”₯ Abs - 30+ core exercises including planks, crunches, and oblique workouts

πŸ“‹ Advanced Workout Management

  • πŸ—“οΈ Smart Weekly Planning - Comprehensive weekly workout scheduler with visual timeline
  • οΏ½ Default Workout Splits - Pre-configured Upper/Lower split with customization options
  • πŸ“Š Multi-Day Planning - Plan multiple workout types per day with easy toggle system
  • 🎨 Color-Coded System - Visual workout identification with consistent theme colors
  • ⚑ One-Click Actions - Quick workout planning and clearing with confirmation dialogs
  • πŸ”„ Real-time Sync - Instant updates across calendar and weekly plan views

🎨 Enhanced User Experience

  • οΏ½ Stellar Dark Theme - Modern glassmorphism design with space-inspired gradients
  • πŸ’« Fluid Animations - Smooth transitions, hover effects, and micro-interactions
  • πŸ“± Mobile-First Design - Touch-optimized controls and responsive grid layouts
  • 🧭 Intuitive Navigation - Week navigation, quick access tabs, and breadcrumb trails
  • ⚑ Performance Optimized - Fast loading with efficient data handling

πŸ› οΈ Tech Stack

Technology Purpose Version
React Frontend Framework ^18.2.0
React Router DOM Navigation & Routing ^6.22.3
FullCalendar Interactive Calendar Component ^6.1.15
FullCalendar React React Integration ^6.1.15
FullCalendar DayGrid Calendar Day View ^6.1.15
FullCalendar Interaction User Interactions ^6.1.15
React Calendar Date Picker Component ^5.0.0
PapaParse CSV Data Processing ^5.4.1
CSS3 Advanced Styling & Animations Latest
Local Storage API Client-side Data Persistence Browser Native
GitHub Pages Static Site Deployment Latest

πŸš€ Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn
  • Modern web browser

Installation

  1. Clone the repository

    git clone https://github.com/Abhi-MS/gymApp.git
    cd gymApp
  2. Navigate to client directory

    cd client
  3. Install dependencies

    npm install
  4. Start the development server

    npm start
  5. Open your browser

    http://localhost:3000
    

Build for Production

npm run build

Deploy to GitHub Pages

npm run deploy

πŸ“± How to Use

🏠 Getting Started

  1. Home Dashboard - View progress overview, workout categories, and interactive calendar
  2. Progress Analytics - Click the featured progress card to access detailed workout analytics
  3. Choose Category - Select from Cardio, Upper Body, Lower Body, or Abs workout types
  4. Track Progress - Use +/- buttons to log weights, reps, sets, and other metrics

πŸ“… Advanced Workout Planning

  1. Interactive Calendar - Click any date to plan workouts with multi-selection support
  2. Weekly Planner - Navigate between weeks with intuitive previous/next controls
  3. Smart Default Splits - Apply proven workout splits (Upper/Lower/Cardio/Abs rotation)
  4. Flexible Scheduling - Add multiple workout types per day or clear entire weeks
  5. Visual Confirmation - Color-coded calendar events and planning confirmations

πŸ“Š Progress Analytics

  1. Exercise Selection - Choose from all tracked exercises in dropdown menu
  2. Metric Analysis - Switch between weight, reps, sets, duration, distance, and calories
  3. Interactive Charts - Hover for detailed workout information with date tooltips
  4. Trend Tracking - Monitor improvement over time with visual progress indicators
  5. Workout History - Complete chronological record of all exercise sessions

πŸ’Ύ Data Management

  • Automatic Saving - All data persists instantly to browser local storage
  • Workout History - Complete log of exercise sessions with detailed metrics
  • Plan Persistence - Weekly plans and calendar events saved between sessions
  • No Account Required - Everything stored locally for privacy and offline access

πŸ“Š Exercise Database

πŸ’ͺ Upper Body (60+ exercises)

  • Biceps: Dumbbell curls, hammer curls, barbell curls, cable curls, concentration curls
  • Triceps: Tricep dips, overhead extensions, pushdowns, close-grip push-ups, diamond push-ups
  • Chest: Bench press, incline press, push-ups, flyes, dips, chest press variations
  • Shoulders: Overhead press, lateral raises, rear delts, front raises, upright rows
  • Back: Pull-ups, chin-ups, rows, lat pulldowns, deadlifts, reverse flyes

🦡 Lower Body (40+ exercises)

  • Quads: Squats, front squats, leg press, lunges, step-ups, Bulgarian split squats
  • Hamstrings: Romanian deadlifts, leg curls, good mornings, stiff-leg deadlifts
  • Glutes: Hip thrusts, glute bridges, clamshells, lateral walks, donkey kicks
  • Calves: Standing calf raises, seated calf raises, single-leg raises, wall sits

❀️ Cardio (25+ activities)

  • Running: Treadmill intervals, outdoor runs, sprints, tempo runs, long distance
  • Cycling: Stationary bike, spin classes, outdoor cycling, mountain biking
  • HIIT: High-intensity intervals, circuit training, tabata, burpees, mountain climbers
  • Swimming: Freestyle, backstroke, breaststroke, water aerobics, pool running
  • Other: Rowing, elliptical, stair climbing, jumping rope, dancing

πŸ”₯ Abs & Core (30+ exercises)

  • Core Stability: Planks, side planks, dead bugs, bird dogs, hollow holds
  • Upper Abs: Crunches, sit-ups, reverse crunches, V-ups, toe touches
  • Lower Abs: Leg raises, knee raises, scissors, flutter kicks, hanging leg raises
  • Obliques: Russian twists, bicycle crunches, wood chops, side bends, oblique crunches
  • Functional: Mountain climbers, bear crawls, Turkish get-ups, farmers walks

πŸš€ Recent Updates

πŸ†• Latest Features

  • πŸ“Š Enhanced Progress Analytics - Interactive charts with multiple metrics tracking
  • πŸ—“οΈ Advanced Weekly Planning - Comprehensive weekly workout scheduler with navigation
  • 🎯 Smart Default Splits - Pre-configured workout routines with Upper/Lower body rotation
  • πŸ’« Improved User Interface - Redesigned with stellar theme and glassmorphism effects
  • πŸ“± Mobile Optimization - Better responsive design for all screen sizes
  • ⚑ Performance Improvements - Faster loading and smoother animations
  • πŸ”„ Data Synchronization - Better integration between calendar and weekly plans

πŸ”§ Technical Improvements

  • FullCalendar Integration - Professional calendar component with advanced features
  • Smart State Management - Improved data persistence and synchronization
  • Component Architecture - Modular design with reusable components
  • Responsive Design System - Consistent styling across all screen sizes

🎨 Design Features

🌟 Visual Design

  • Stellar Dark Theme - Space-inspired interface with cosmic gradients and nebula effects
  • Glassmorphism UI - Modern glass-like transparency effects with backdrop blur
  • Color-Coded System - Consistent color theming for each workout category
  • Responsive Layouts - Adaptive grid systems and flexible component sizing

πŸ“± Cross-Platform Experience

  • Desktop: Full sidebar navigation with grid layouts and hover interactions
  • Tablet: Optimized horizontal tabs with touch-friendly spacing
  • Mobile: Swipe-enabled cards with vertical scrolling and gesture support

⚑ Performance & Interactions

  • Smooth Animations - 60fps transitions with CSS3 hardware acceleration
  • Smart Loading - Efficient component rendering and data fetching
  • Instant Feedback - Real-time visual responses to user interactions
  • Accessible Design - Screen reader support and keyboard navigation

🎯 User Interface Enhancements

  • Interactive Elements - Hover states, click animations, and loading indicators
  • Context-Aware Buttons - Disabled states and confirmation dialogs
  • Progressive Disclosure - Information revealed on demand to reduce clutter
  • Visual Hierarchy - Clear information architecture with proper spacing and typography

πŸ‘¨β€πŸ’» Author

Abhi-MS


⭐ Star this repository if you found it helpful!

Made with ❀️ for the fitness community

πŸ” Back to Top

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors