Skip to content

Pranshu-Raj/pumpPro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pumpPro: Workout Helper

A comprehensive 30-day Push/Pull/Legs (PPL) workout tracking application designed to help you complete a structured training program with guaranteed results. Built with React and Vite for a smooth, responsive user experience.

🎯 Overview

pumpPro is your digital training partner that guides you through a complete 30-day fitness transformation program. The app implements the scientifically-backed "BRo Split" methodology, rotating between Push, Pull, and Legs workouts to maximize muscle growth and strength gains.

✨ Key Features

📋 Structured Training Program

  • 30 unique workouts spanning 30 days
  • Push → Pull → Legs rotation for optimal recovery and muscle development
  • Progressive overload built into the program structure
  • Sequential unlocking - complete each day to unlock the next

🎯 Smart Progress Tracking

  • Local storage integration - your progress persists between sessions
  • Weight tracking for every exercise across all workouts
  • Completion system - mark workouts as complete when finished
  • Visual progress indicators with workout cards and status icons

💪 Exercise Guidance

  • Detailed exercise descriptions with proper form instructions
  • Built-in tempo guidance (2-2-2 pause reps for optimal muscle activation)
  • Warm-up routines included for each workout day
  • Visual exercise demonstrations via descriptive text

🎨 User Experience

  • Intuitive card-based interface for easy workout navigation
  • Modal system for detailed exercise instructions
  • Responsive design that works on all devices
  • Font Awesome icons for visual workout categorization

🚀 Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone https://github.com/Pranshu-Raj/pumpPro.git
    cd pumpPro
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:5173 to access the application

Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint for code quality checks

📖 How to Use

Starting Your Journey

  1. Begin with Day 1 - The first Push workout is immediately available
  2. Complete workouts sequentially - Each day unlocks only after completing the previous one
  3. Follow the 3 Golden Rules:
    • Rest: Take necessary rest days between workouts
    • Reps: Use 2-2-2 tempo (2 seconds down, 2 second pause, 2 seconds up)
    • Weight: Select maximum weight that allows perfect form

During Each Workout

  1. Review warm-up exercises - These prepare your muscles and joints
  2. Check exercise descriptions - Click the ❓ icon for detailed instructions
  3. Enter your working weights - Track the maximum weight you can use with good form
  4. Complete all sets and reps - Follow the prescribed sets and repetitions
  5. Save your progress - Use "Save & Exit" to preserve your weights for next time
  6. Mark as complete - Hit "Complete" when you've finished the entire workout

Weight Progression Strategy

  • Sets 1-2: Use 75% of your working weight
  • Sets 3-4: Use 85% of your working weight
  • Final sets: Use 100% of your maximum weight with perfect form

🏋️‍♂️ The BRo Split System

The program follows a proven Push/Pull/Legs rotation:

Push Days (Chest, Shoulders, Triceps)

  • Barbell Bench Press
  • Incline Dumbbell Press
  • Dips
  • Cable Crossovers
  • Tricep Extensions

Pull Days (Back, Biceps, Rear Delts)

  • Lat Pulldowns
  • Cable Rows
  • Dumbbell Rows
  • Face Pulls
  • Bicep Curls

Legs Days (Quads, Hamstrings, Glutes, Calves)

  • Barbell Squats
  • Leg Press
  • Romanian Deadlifts
  • Hip Thrusts
  • Calf Raises

🔧 Technical Details

Built With

  • React 19 - Modern React with latest features
  • Vite - Lightning-fast build tool and dev server
  • JavaScript ES6+ - Modern JavaScript features
  • CSS3 - Custom styling with Font Awesome integration
  • Local Storage API - Client-side data persistence

Architecture Highlights

  • Component-based structure for maintainable code
  • Custom hooks for state management
  • Prop drilling optimization with strategic component design
  • Responsive layout that adapts to different screen sizes

🎯 Program Benefits

Physical Results

  • Increased muscle mass through progressive overload
  • Improved strength across all major muscle groups
  • Better muscle balance with the PPL rotation
  • Enhanced mind-muscle connection with pause reps

Mental Benefits

  • Structured approach removes decision fatigue
  • Progress tracking provides motivation and accountability
  • Educational component teaches proper exercise form
  • Achievement system creates positive reinforcement

🔄 Program Structure

The 30-day program includes:

  • 10 Push workouts focusing on chest, shoulders, and triceps
  • 10 Pull workouts targeting back, biceps, and rear delts
  • 10 Legs workouts developing quads, hamstrings, glutes, and calves

Each workout contains:

  • 2 warm-up exercises to prepare your body
  • 5 main exercises for targeted muscle development
  • Specific set and rep schemes for optimal progression

🚨 Important Notes

Safety First

  • Consult a physician before starting any new exercise program
  • Focus on form over weight - proper technique prevents injury
  • Start conservatively - build up weight gradually over time
  • Listen to your body - rest if you feel pain (beyond normal muscle fatigue)

Success Tips

  • Consistency is key - stick to the schedule for best results
  • Progressive overload - gradually increase weights as you get stronger
  • Proper nutrition - fuel your body with adequate protein and calories
  • Quality sleep - recovery happens when you rest

🤝 Contributing

This project demonstrates clean React development practices and modern JavaScript patterns. Feel free to submit issues or enhancement requests!

📄 License

This project is private and intended for personal use.


Ready to transform your physique? Start your pumpPro journey today! 💪

About

Implies a professional approach to getting a "pump."

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors