My Buddy Tracker
Real-time location awareness and telemetry application providing live Google Maps polyline trails, activity classification, and peer presence.
Project Overview & Architecture
My Buddy Tracker is a multi-platform location awareness and telemetry application engineered with React 19, TypeScript, Capacitor, and Google Cloud services. Built to provide reliable real-time tracking for families, collaborative field teams, and logistics personnel, the application combines smooth geospatial visualization with automated physical activity detection.
The client interface is built upon the modern @vis.gl/react-google-maps component library and Tailwind CSS. The tracking engine continuously monitors latitude, longitude, movement speed, and directional heading. As the user moves, the application renders a persistent breadcrumb polyline trail across the map view, while an active pan controller (MapPanController) smoothly centers the viewport to ensure the moving subject remains in focus.
In addition to geographical coordinates, My Buddy Tracker captures and broadcasts crucial context telemetry:
- Automated Activity Recognition: By evaluating instantaneous velocity vectors and positional variance, the system categorizes movement into discrete operational states: IDLE, WALKING, and DRIVING. Visual indicators and custom map pin avatars adapt dynamically to reflect the current activity.
- Device Vital Monitoring: The application logs the user's remaining battery percentage (batteryLevel) and charging status (isCharging), offering vital safety context when coordinating remote meetups or monitoring lone field workers.
- Peer Presence & Multi-User Map: Authorized peers within the same sharing network are rendered as distinct markers with name badges, activity chips, and connection timestamps, allowing participants to observe the relative proximity of the entire group simultaneously.
- Route Simulation Framework: For demonstration, training, and testing without physical movement, the system includes route presets (RoutePreset) that accurately simulate navigation along urban driving corridors and pedestrian walkways.
Cross-Platform Architecture and Privacy Controls: My Buddy Tracker is architected to run seamlessly both as a high-performance web application (served via Vite) and as a native Android installation packaged through Capacitor (com.tracker.location). Backend communication and state synchronization rely on Firebase Authentication and Cloud Firestore. Strict security rules (firestore.rules) govern database reads and writes, ensuring location coordinates and telemetry packets are accessible exclusively to authenticated, mutually authorized network peers.