Skip to content

pranay-sankar-muppanenei/workout-mate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ‹οΈ Workout Mate

Workout Mate is a full-stack fitness tracking application designed to help users log and manage their workout routines easily.
It allows users to create, update, and track exercises β€” making fitness management simple and effective.


🌐 Live Demo

Click here to try Workout Mate


πŸš€ Features

  • βœ… User authentication (Sign up & Login)
  • πŸ“ Add, update, and delete workout records
  • πŸ“Š Dashboard to view all workouts at a glance
  • πŸ•’ Track date, type, load (kg), and reps for each exercise
  • ⚑ Responsive UI for mobile and desktop
  • πŸ’Ύ Secure backend with REST API

🧰 Tech Stack

  • Frontend: React.js, Tailwind CSS
  • Backend: Node.js, Express.js
  • Database: MongoDB (Mongoose)
  • Authentication: JWT (JSON Web Token)
  • Others: React Context,Fetch, React Router DOM

πŸ—οΈ Project Structure

workout-mate/
β”œβ”€β”€ client/ # React frontend
β”‚ β”œβ”€β”€ src/
β”‚ β”‚ β”œβ”€β”€ components/
β”‚ β”‚ β”œβ”€β”€ pages/
β”‚ β”‚ β”œβ”€β”€ context/
β”‚ β”‚ └── App.js
β”‚ └── package.json
β”œβ”€β”€ server/ # Node.js backend
β”‚ β”œβ”€β”€ controllers/
β”‚ β”œβ”€β”€ models/
β”‚ β”œβ”€β”€ routes/
β”‚ β”œβ”€β”€ server.js
β”‚ └── package.json
└── README.md


πŸ› οΈ Installation & Setup

1. Clone the repository

git clone https://github.com/your-username/workout-mate.git
cd workout-mate
# Install client dependencies
cd client
npm install

# Install server dependencies
cd ../server
npm install

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret_key

# Start backend
cd server
npm run dev

# Start frontend (in another terminal)
cd client
npm start

πŸ§ͺ API Endpoints

  • Method Endpoint Description
  • GET /api/workouts Get all workouts
  • POST /api/workouts Add a new workout
  • PUT /api/workouts/:id Update an existing workout
  • DELETE /api/workouts/:id Delete a workout
  • POST /api/user/signup Register a new user
  • POST /api/user/login Login and get token

πŸ“… Future Improvements

  • πŸ“² Add reminders & notifications

  • πŸ“‰ Workout progress analytics

  • 🀝 Social features (friends & challenges)

  • πŸ’ͺ Personalized workout plans

  • 🀝 Contributing

🀝 Contributions are Welcome!

We’d love your help to make this project even better.
Follow these simple steps to contribute:

  1. Fork the project 🍴

  2. Create your feature branch:

    git checkout -b feature/new-feature
  3. git commit -m "✨ Add new feature"

  4. git push origin feature/new-feature 5.Open a PR

Open a Pull Request πŸš€

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published