Workout Buddy is a fitness tracking app built with the MERN (MongoDB, Express, React, Node.js) stack.
It helps users log their workouts and track the exercises they perform, including load and reps. This application also allows users to easily add and delete new exercises in their workout logs. 🏋️♂️
- ➕ Add and log workout exercises
- 📊 Record load (in kg) and reps for each exercise
- 🕒 View recent workout logs with timestamps
- 🎨 Simple and intuitive user interface
- 🔥 Built using the MERN stack
- MongoDB - Database to store workout data
- Express.js - Backend framework to handle API requests
- React.js - Frontend framework to create the interactive user interface
- Node.js - JavaScript runtime to power the backend server
Here’s a quick demo of the Workout Buddy app:
To run this project locally, you will need:
- 🖥️ Node.js and npm installed on your machine
- 🗄️ MongoDB (either locally or use MongoDB Atlas for cloud-based database)
-
Clone the repository:
git clone https://github.com/yourusername/Workout-Buddy.git
-
Navigate to the project directory:
cd Workout-Buddy
-
Install backend dependencies:
cd backend npm install
-
Install frontend dependencies:
cd frontend npm install
-
Set up your environment variables:
- 📄 Create a
.env
file in thebackend
directory. - 📝 Add your MongoDB URI and other required variables (e.g., port).
- 📄 Create a
-
Start the application:
- For the backend (Node.js and Express):
cd backend npm start
- For the frontend (React):
cd frontend npm start
-
Open the app in your browser:
http://localhost:3000
- 🏋️ Adding a Workout: Fill in the exercise title, load (in kg), and reps, then click the Add Workout button to log a new workout.
- 📅 Viewing Workouts: View previously added exercises, including their load and rep details, along with timestamps of when they were logged.
- 🍴 Fork the repository.
- 🌱 Create a new branch (
git checkout -b feature-name
). - 📝 Commit your changes (
git commit -m 'Add new feature'
). - 🚀 Push to the branch (
git push origin feature-name
). - 📬 Open a pull request.
- MERN Stack for enabling fast web development.
- React for the user interface.
- Node.js for the server-side platform.
- Express for API handling.
- MongoDB for database management, providing fast and scalable data storage.
🔥 Get started with Workout Buddy and take your fitness tracking to the next level! 💪🚀