Trace

A Strava-connected activity dashboard that renders your GPS routes as beautiful, minimal maps.

Trace connects to your Strava account and renders every activity as a clean GPS route visualization — no base maps, just the pure trace of where you went. Click any activity to expand it into a full-screen detail view with complete performance stats.

• OAuth connection via Strava — read-only access, your data stays yours
• Route visualization — GPS traces rendered on dark canvas with layered glow effects
• Activity detail — click any card to fly it open into a full-screen view
• Sport-specific stats — pace, power, heart rate, elevation, cadence and more depending on activity type
• Summary bar — total distance, time, and elevation for any filtered view
• Sport filters — filter by Run, Ride, Swim, Hike, Walk
• Imperial units — distance in miles, elevation in feet

• Frontend — React + Vite
• Backend — Node/Express (OAuth token exchange only)
• Deployment — Vercel

• Node.js 18+
• A Strava account with API access

1. Clone the repo

git clone https://github.com/ethancooley/trace.git
cd trace

2. Install dependencies

cd backend && npm install
cd ../frontend && npm install

3. Configure environment variables

# backend/.env
STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret

# frontend/.env
VITE_STRAVA_CLIENT_ID=your_client_id

4. Run both servers

# Terminal 1
cd backend && node index.js

# Terminal 2
cd frontend && npm run dev

5. Open http://localhost:5173

The backend is deployed as Vercel serverless functions. The frontend is a standard Vite/React build deployed to Vercel.

Add the following environment variables in the Vercel dashboard for both projects:

MIT