Skip to content

Latest commit

 

History

History
113 lines (83 loc) · 3.3 KB

File metadata and controls

113 lines (83 loc) · 3.3 KB

(N.B. This repo is a demo app being used as part of copilot training exercises, the app was generated by GitHub Spark and is not presently deployed or hosted anywhere)

🏋️ FitTrack - Smart Workout Tracker

FitTrack is a comprehensive workout tracking application that helps you plan workouts, track progress, and improve your fitness journey with AI-powered form feedback.

✨ Features

🎯 Workout Plans

  • Create and organize custom workout plans
  • Add multiple exercises with sets, reps, and weight targets
  • Edit and manage your workout library
  • Quick-start workouts from your saved plans

📚 Exercise Library

  • Searchable database of exercises with detailed instructions
  • Filter by muscle group and difficulty level
  • View form cues and proper technique
  • Add exercises directly to your workout plans

💪 Active Workout Tracking

  • Real-time workout session tracking
  • Log completed sets with reps and weight
  • Visual progress indicators
  • Resume incomplete workouts
  • Timer for rest periods

🤖 AI-Powered Form Feedback

  • Get personalized form tips during workouts
  • Ask questions about exercise technique
  • Receive instant feedback to improve your form
  • Prevent injuries with proper guidance

📊 Progress Tracking

  • Visual charts showing workout history
  • Track volume trends over time
  • Monitor personal records
  • View detailed workout logs

🚀 Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/esmcelroy/workout-tracker-coach.git
cd workout-tracker-coach
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and navigate to http://localhost:5173

Building for Production

npm run build

Running Linter

npm run lint

🛠️ Tech Stack

  • Framework: React 19 with TypeScript
  • Build Tool: Vite
  • UI Components: Radix UI primitives
  • Styling: Tailwind CSS v4
  • Animations: Framer Motion
  • State Management: React hooks + GitHub Spark KV storage
  • Charts: Recharts
  • Icons: Phosphor Icons
  • Forms: React Hook Form with Zod validation

📱 Features Overview

Storage

All workout data is stored locally using GitHub Spark's KV storage (browser local storage), which persists data in your browser without requiring a backend or user accounts. Note that data is specific to your browser and device.

Responsive Design

  • Desktop: Full tabbed interface with comprehensive views
  • Mobile: Bottom navigation bar optimized for thumb access
  • Touch-friendly controls and large tap targets on mobile

Design Philosophy

The interface is designed to be motivating, clear, and efficient - getting out of your way during workouts while providing rich insights when reviewing progress.

🎨 Design System

  • Primary Color: Deep Energetic Blue - Conveys trust and focus
  • Accent Color: Vibrant Lime Green - Highlights achievements and progress
  • Typography: Inter font family for athletic, modern feel
  • Animations: Snappy, purposeful motion that celebrates achievements

📄 License

This project uses the MIT License. The Spark Template files and resources from GitHub are licensed under the terms of the MIT license, Copyright GitHub, Inc.