Linking Strava lets us update bike distances automatically — no manual
odometer entry, and component wear stays accurate without thinking
about it.
How to connect
- Go to Settings → Strava.
- Click Connect Strava.
- You'll be redirected to Strava to authorize the connection.
- Grant WatchMy.bike permission to read your activities and gear.
- You'll be redirected back and your Strava data starts syncing.
What we read
- Your Strava gear (so we can match it to your bikes).
- Activity distances (to update bike mileage).
- Activity types (so we count only cycling activities).
We never post to Strava or modify your activities. Read access only.
How often it syncs
Two paths run in parallel:
- Webhook (real-time) — when you save an activity in Strava, a
webhook fires and we update your bike distances within seconds.
Same for edits and deletes (we adjust distance accordingly). - Cron (every 6 hours) — a safety net that reconciles your
totals in case a webhook is missed.
You can also hit Sync now in Settings → Strava for an
on-demand refresh.
Backfilling historical activities
When you first connect, only new activities flow through the
webhook. To pull in your existing Strava history, go to
Settings → Strava Import, pick how far back to import, and
start the import. Component distances are recalculated from
scratch when the import finishes.
Linking individual bikes
After connecting Strava:
- Open a bike's edit page (or visit Bikes → Strava Gear for a
bulk view). - Pick the matching Strava gear from the dropdown.
- Save.
Distances now update automatically based on rides logged with that
gear in Strava.
Token refresh
Strava access tokens are short-lived; we refresh them in the
background using your refresh token. If a refresh fails (e.g. you
revoked access in Strava), we notify you — reconnecting is a
single click.
Do I have to use Strava?
No. Strava is optional. If you don't connect it, just update each
bike's odometer manually whenever you remember. Component wear is
calculated from bike distance regardless of source — works fine with
Garmin, Wahoo, or paper logs.