# MyWayRoutes

> Privacy-first, zero-cloud GPS route visualization, bio-energetic elevation profiling, and navigation tool for GPX, FIT, and KML files.

MyWayRoutes (https://mywayroutes.com) is a high-performance client-side web application and Progressive Web App (PWA) built for cyclists, hikers, runners, and outdoor navigators. It parses and renders GPX tracks, Garmin/Wahoo FIT files, and Google Earth KML files entirely within the user's browser, requiring no server uploads, database accounts, or external subscriptions.

## Core Capabilities
- [Route File Ingestion](https://mywayroutes.com): Seamless client-side parsing for GPX, Garmin/Wahoo FIT, and Google Earth KML/KMZ files.
- [Bio-Energetic Elevation Profiling](https://mywayroutes.com): Real-time interactive elevation chart with rolling gradient smoothing, color-coded slope categories (descent, steady, aerobic, threshold, anaerobic), and synchronized map hover coordinates.
- [Turn & Waypoint Management](https://mywayroutes.com): Create, edit, and organize custom checkpoints (Water, Food, Shelter, Viewpoint, Hazard) with distance-to-next calculations and GPX 1.1 export.
- [Live Weather & Wind Vectors](https://mywayroutes.com): Integrated Open-Meteo weather forecasts and real-time relative headwind, tailwind, and crosswind vector calculation along the route's heading.
- [Zero-Backend Sharing](https://mywayroutes.com): High-efficiency zlib/pako compression encoding entire route traces into lightweight, sharable URL hashes without cloud databases.
- [Offline PWA Navigation](https://mywayroutes.com): Offline-first caching with Service Workers, live GPS follow-me mode, compass heading-up orientation, and battery-saving Eco Mode for ultra-distance events.

## Supported File Formats
- GPX (.gpx): GPS Exchange Format containing tracks, routes, elevation markers, and waypoints.
- FIT (.fit): Flexible and Interoperable Data Transfer binary format from Garmin, Wahoo, Hammerhead, and Coros devices.
- KML / KMZ (.kml, .kmz): Google Earth Keyhole Markup Language route traces.

## URL Sharing Schema
Routes can be shared or opened programmatically using URL hash fragments:
- `https://mywayroutes.com/#data=<base64-deflated-route-payload>`
When accessed, the full geometry, route title, and interactive checkpoints are unpacked directly in the browser with zero cloud storage dependencies.

## Privacy & Security Architecture
- 100% Client-Side Processing: User tracks, health telemetry, and GPS coordinates never leave the browser.
- No Tracking or Ads: Zero third-party trackers, zero data harvesting, and no mandatory login.
- Offline-Capable: Operates reliably in remote wilderness or low-connectivity zones once loaded.

## Full Documentation
For complete technical documentation, architecture, and feature reference, see:
- [Full LLM Reference](https://mywayroutes.com/llms-full.txt)