Project Overview - Kriaa89/VivaFit GitHub Wiki

Project Overview

Welcome to the VivaFit project! This page provides an overview of the application's purpose, architecture, and key features.

Purpose

VivaFit is designed to empower users to take control of their fitness journey by offering:

  • Personalized workout program creation and management.
  • Real-time GPS tracking to monitor outdoor activities.
  • An extensive library of exercises with detailed instructions.
  • Secure user account management and progress tracking.

Architecture

VivaFit is built using a microservices-style approach that spans:

  • Frontend:
    • Built with React, React Router, and Tailwind CSS.
    • Interactive components include exercise lists, workout builders, and real-time GPS tracking using React-Leaflet and Turf.js.
  • Backend:
    • Developed with Node.js, Express, and MongoDB.
    • Secure endpoints for user authentication, profile management, and workout program storage.
  • Database:
    • MongoDB stores user data, exercise records, and workout programs.

Key Features

  • User Authentication: Secure sign-up and login with Firebase integration.
  • Workout Program Builder: Create, edit, and save custom workout routines.
  • GPS Tracking: Capture location data to calculate walking or running distance in real time.
  • Interactive Maps: Visualize your routes using Leaflet and OpenStreetMap.
  • Real-Time Feedback: Monitor metrics like distance, speed, and elapsed time during workouts.

Future Enhancements

The team is continuously working to enhance VivaFit by:

  • Improving data analytics to personalize workout suggestions.
  • Integrating social features for workout challenges and community support.
  • Expanding the exercise database and adding more interactive maps.