Troubleshooting¶

Specific symptoms and how to fix them. If your problem isn't listed, the FAQ covers more general questions.

"Authorization failed" after the Strava redirect¶

The OAuth state token didn't match what we expected. Almost always one of:

You hit "Back" mid-flow and Strava sent us a stale state. Start over from /login.
A browser extension is stripping the URL parameters — try in an incognito tab.
Your clock is wrong. OAuth tokens are time-sensitive. Check your system clock is set automatically.

"Captcha verification failed" on registration¶

Cloudflare Turnstile blocked the submission. Causes:

A VPN exit node that Cloudflare doesn't trust — try without the VPN.
A very old browser version — update Chrome / Firefox / Safari to a recent release.
Tracker-blocking extensions that strip the Turnstile widget — temporarily disable for thepeakline.com.

"Session expired" — keeps logging me out¶

Your session cookie isn't being persisted. See the FAQ entry.

Activity sync¶

A specific activity won't sync¶

Open the activity on Strava — make sure it's saved (not just in draft state).
Check the privacy setting. Activities marked "Only You" sync fine; activities in "Only Me" and with the device sync paused on Strava's side may not trigger a webhook.
Force a manual sync. Open the activity on PeakLine via direct URL: https://www.thepeakline.com/activity/<strava_activity_id>. We'll try to fetch it on demand.
Wait and try again. Sometimes Strava's webhook is delayed by 5–10 minutes.

"This activity isn't yours"¶

Strava returned the activity but its athlete ID doesn't match your connected account. This usually means you connected Strava with a different account than the one that owns the activity (multi-account family situation). Disconnect and reconnect with the correct account.

Sync is stuck on "Processing…"¶

Hit the ↻ Force resync button on the dashboard. If that doesn't help in a few minutes, the activity may have invalid GPX data — try the GPX Fixer on the raw file from Strava's export.

Analysis¶

Zone bars are empty¶

Either:

No HR / power data in the activity — happens for manual entries, indoor activities without sensors, or rides where the device dropped the sensor.
FTP / LTHR not set. Open Settings → Training zones and set them.

PeakLine Score is 0¶

A rare edge case — usually means the activity's distance or duration was somehow zero (corrupt manual entry, recording bug). Delete and re-upload the activity, or run the original GPX through the GPX Fixer.

Climbs aren't detected on a ride that clearly has climbs¶

Check:

The activity has an altitude stream (some indoor rides, manual entries, and a few cheap GPS units don't record altitude).
The climbs are above the minimum thresholds (30 m vertical, 2 min, 3% gradient). A series of 20 m bumps won't trigger detection.

Weather block missing¶

Two possible causes:

Missing start coordinates — happens with manual entries and some indoor activities.
Activity is from before 1940 — Open-Meteo's archive doesn't go back further. Unlikely to affect you.

Route Planner¶

Routes get drawn through buildings / lakes¶

OpenStreetMap data is incomplete in some areas. Workarounds:

Add an intermediate waypoint to force the route around the problem.
Switch to Straight line mode for the segment.
Edit OSM yourself (changes propagate to PeakLine within ~1 week).

Forecast says "no data" for my planned date¶

You're more than ~7 days out, or the date is in the past. Open-Meteo gives reliable forecasts for the next week; beyond that, the data is provided but treated as low-confidence.

"Failed to save route"¶

You're not signed in (Guest users can't save), or the route exceeds the 1,000-point limit (very long routes). Trim or split.

GPX Fixer¶

"File too large"¶

50 MB limit. Most files are well under 1 MB; if yours is huge, it's likely from a multi-day adventure or has very dense sensor data. Split the file (most GPX editors support this) or trim with a tool like gpsbabel.

Fixed file looks the same as the original¶

The fixer found no anomalies. Either:

Your GPS was actually clean.
The problems were below the per-sport speed ceiling. If you have a smaller threshold in mind, currently you'd need to edit the file manually.

Strava rejected my upload after fixing¶

Strava sometimes rejects GPX uploads for reasons unrelated to track quality — duplicate detection, account upload limits, or "this activity overlaps with an existing one." Check Strava's error message directly.

Gear tracking¶

A ride didn't count toward my bike's mileage¶

Strava didn't tag the activity with a gear ID. Common causes:

You forgot to select the bike in Garmin / Wahoo / Strava.
It's an indoor ride on a virtual bike (Zwift, etc.).
A manual entry without gear selection.

Open the activity on Strava, assign the bike, and PeakLine will pick up the change on the next sync.

Components shown above 100% but haven't been replaced¶

PeakLine flags them with a red badge. The total continues to climb past 100% — it doesn't reset until you mark the component Retired and add a replacement.

Gear list is empty even though I have bikes on Strava¶

Hit the Refresh from Strava button on the gear page. We don't auto-fetch the gear list on every page load to save API calls; it's pulled on demand.

AI Coach¶

"AI Coach generation failed"¶