LiveRun

Real-time run tracking. An Apple Watch app streams GPS, heart rate, pace, and elevation data to a live web dashboard with a 3D map, stats, km splits, and cheers.

Web

The web app (web/) is a Next.js app that displays a live 3D Mapbox map, real-time stats, km splits, and cheers. It uses Specific for infrastructure (PostgreSQL with Electric SQL sync).

Prerequisites

• Specific: curl -fsSL https://specific.dev/install.sh | sh
• A Mapbox access token
• Google OAuth client ID and secret (for authentication)

Getting Started

cd web
npm install
specific dev

You'll be prompted to enter your Mapbox token, Google OAuth credentials, and other config on first run. Specific handles the database, auth secrets, real-time sync, and dev server — all configured in specific.hcl.

Deploy to Specific Cloud

cd web
specific deploy

Note that this requires a Specific account.

Apple Watch

The watch app (watch/) tracks workouts using HealthKit and CoreLocation, streaming GPS coordinates, heart rate, pace, and elevation in real time to the web dashboard.

Prerequisites

• Xcode
• Apple Watch (or simulator)

Getting Started

1. Copy the example config files:

cd watch/LiveRun
cp Debug.xcconfig.example Debug.xcconfig
cp Release.xcconfig.example Release.xcconfig

2. Edit Debug.xcconfig and set API_BASE_URL to the localhost:{PORT} URL printed by specific dev in web/.

3. Edit Release.xcconfig and set API_BASE_URL to your production URL (available after running specific deploy in web/).

4. Open watch/LiveRun/LiveRun.xcodeproj in Xcode, select your Apple Watch target, and run.