Skip to content

Workout Buddy is a fitness tracking app built with the MERN stack.

Notifications You must be signed in to change notification settings

LasithaAmarasinghe/Workout-Buddy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💪 Workout Buddy

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. 🏋️‍♂️

🖥️ Screenshot

🚀 Features

  • ➕ 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

🛠️ Tech 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

M E R N

🎥 Demo

Here’s a quick demo of the Workout Buddy app:

▶️ Watch the demo

🚀 Getting Started

✅ Prerequisites

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)

🛠️ Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/Workout-Buddy.git
  2. Navigate to the project directory:

    cd Workout-Buddy
  3. Install backend dependencies:

    cd backend
    npm install
  4. Install frontend dependencies:

    cd frontend
    npm install
  5. Set up your environment variables:

    • 📄 Create a .env file in the backend directory.
    • 📝 Add your MongoDB URI and other required variables (e.g., port).
  6. Start the application:

    • For the backend (Node.js and Express):
    cd backend
    npm start
    • For the frontend (React):
    cd frontend
    npm start
  7. Open the app in your browser:

    http://localhost:3000

🎯 Usage

  • 🏋️ 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.

🤝 Contributing

  1. 🍴 Fork the repository.
  2. 🌱 Create a new branch (git checkout -b feature-name).
  3. 📝 Commit your changes (git commit -m 'Add new feature').
  4. 🚀 Push to the branch (git push origin feature-name).
  5. 📬 Open a pull request.

🎖️ Acknowledgements

  • 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! 💪🚀

About

Workout Buddy is a fitness tracking app built with the MERN stack.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published