Troubleshooting
Rides Not Syncing
If new rides aren't appearing in RideTool:
- Check that your data source (Strava, Wahoo) is still connected in your account settings
- Make sure the ride has finished uploading to your provider (Strava/Wahoo)
- Try refreshing the page — new rides appear within a few minutes of upload
- If rides are still missing, disconnect and reconnect your data source
Bikes
Manage your bike inventory from Account → Bikes. Each bike has a name, brand, type, and optional notes.
- Default bike — set one bike as default and it will auto-assign to all new rides
- e-MTB — mark electric mountain bikes for separate tracking
- Strava gear — bikes from Strava are automatically imported and matched when rides sync
- Assign on ride detail — click the bike badge on any ride to change which bike was used
Injury Recovery
When you log an injury, RideTool enters recovery mode. Your consistency data holds at your pre-injury level instead of dropping to zero — because rest is part of training, not a failure.
- How it works — log an injury using the + button on any day (Injury tab) or via Claude MCP
- Score protection — your consistency metrics freeze at your recent average while you heal
- Visual — the ring turns gray with a "recovering" label. No red or warning signals
- Healing — after 7 days with no new injury logged, recovery mode ends automatically
- Coming back — when you ride again after healing, your score picks up where you left off. If your fitness has decayed enough, Comeback mode activates to celebrate your return
Duplicate Rides
RideTool has a built-in dedup engine that catches most duplicates automatically. If you see duplicates, it usually means the rides came from different sources with significantly different timestamps. Try syncing the original FIT files — the dedup engine handles those most accurately.
Missing Data or Metrics
- No power data? Power requires a power meter on your bike. Without one, power fields won't appear.
- No heart rate? Heart rate requires a chest strap or optical HR monitor connected to your head unit.
- No map? Some indoor rides or rides without GPS won't have a route map.
- Lower numbers than expected? Check your units preference (imperial vs metric) in account settings.
Strava Permission Issues
If Strava isn't syncing properly, you may need to reauthorize RideTool:
- Go to Strava Settings → My Apps
- Find RideTool and click Revoke Access
- Back in RideTool, reconnect Strava from your account settings
- Make sure to approve all requested permissions
Wahoo Connection Issues
If Wahoo sync stops working, try disconnecting and reconnecting from your account settings. Make sure your Wahoo account is active and your rides are visible in the Wahoo app.
Browser Compatibility
RideTool works best in modern browsers: Chrome, Safari, Edge, and Firefox. For the best experience, keep your browser updated. RideTool also works as a Progressive Web App (PWA) on desktop and mobile for a faster, app-like experience.