Training Fox 🦊

A cute and clever running training plan generator with a fox-inspired theme.

Features

• Generate personalized running training plans
• Real API backend for data processing
• Fox-themed workout representation
• Beautiful orange and black color scheme
• Visual workout distribution charts
• Weekly training summary statistics
• Responsive design for all devices

Tech Stack

Frontend

• React
• Material-UI
• Chart.js

Backend

• Node.js
• Express
• CSV Parsing

Getting Started

Prerequisites

• Node.js (v14 or later)
• npm or yarn

Installation

1. Clone the repository

git clone https://github.com/yourusername/training-app.git
cd training-app

2. Install all dependencies (frontend and backend)

npm run install-all

3. Start the development server (frontend + backend)

npm run dev

4. Open http://localhost:3000 in your browser

App Structure

• /server - Backend Express API
• /src - Frontend React app
  • /components - UI components
  • /utils - Utility functions
  • /data - Training data

API Endpoints

• GET /api/training-schedules - Get all training schedules
• POST /api/generate-plan - Generate a personalized training plan
• GET /api/integrations/strava/config - Check Strava integration server config
• GET /api/integrations/strava/auth-url - Start Strava OAuth flow
• POST /api/integrations/strava/exchange-code - Exchange OAuth code for connection
• POST /api/integrations/strava/sync - Sync recent Strava activities
• POST /api/integrations/apple-health/import - Import Apple Health workouts from file data

Device Integration Setup (Strava + Apple Health)

Strava

1. Create a Strava API application at https://www.strava.com/settings/api
2. Set your authorization callback domain to your frontend origin (example: http://localhost:3000)
3. Add these values to server/.env:

STRAVA_CLIENT_ID=your_strava_client_id
STRAVA_CLIENT_SECRET=your_strava_client_secret
STRAVA_REDIRECT_URI=http://localhost:3000/devices
STRAVA_SCOPE=read,activity:read_all

4. Restart the backend (npm run start-server or npm run dev)
5. Open the Devices page and click Connect Strava

Apple Health

• Apple Health does not expose direct browser OAuth access.
• Use the Devices page to import Apple Health export files (.xml, .json, .csv).
• The app will normalize running workouts and sync them to your profile.

Usage

1. Fill in your details:

   • Age
   • Weight
   • Gender
   • Current weekly mileage

2. Click "Generate My Training Plan!"

3. View your personalized 7-day training schedule with cute visualizations

4. Click "Create a New Plan" to start over

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Training schedules are designed for recreational runners
• All emoji art is included within the app