Strava Integration Guide
Complete Guide to Strava Integration
What is Strava Integration?
Connect your Strava account to automatically sync your running, cycling, swimming, and other fitness activities into Build Stability. Your activities contribute to your Build Score and provide a complete picture of your fitness journey.
Benefits of Connecting Strava:
• Automatic Activity Tracking - No need to manually log every run or ride • Build Score Boost - Your activities count toward consistency, volume, and recovery scores • Complete Fitness Picture - Combines gym workouts with outdoor activities • Heart Rate Data - If you use a heart rate monitor, data enriches your metrics • Workout Streaks - Outdoor activities count toward your daily workout streak • Time-Saving - Activities sync automatically, no manual entry needed
How to Connect Strava:
Step 1: Access Connections
1. Click your profile icon in the top right corner 2. Select "Connections" from the dropdown menu 3. You will see the Fitness Apps section
Step 2: Connect Strava
1. Click "Connect Fitness Apps" or find the Strava option 2. Click "Connect Strava" button 3. You'll be redirected to Strava's authorization page 4. Review the permissions (we only request activity read access) 5. Click "Authorize" to grant access 6. You'll be redirected back to Build Stability
Step 3: Initial Sync
• After connecting, your last 30 days of activities will sync automatically • This may take a few moments depending on how many activities you have • You'll see a success message when sync completes
What Data Gets Synced:
Activity Information:
• Activity type (Run, Ride, Swim, Workout, etc.) • Activity name (if you named it in Strava) • Start time and duration • Distance covered • Elevation gain • Calories burned
Performance Data:
• Average heart rate (if recorded) • Maximum heart rate (if recorded) • Average pace/speed • Power data (if available)
Activity Metadata:
• Date and time • Location (if GPS data available) • Weather conditions (if Strava includes this)
How Activities Affect Your Build Score:
Consistency Score (40% weight):
• Each Strava activity counts as a completed workout • Primary Calculation: Activities from the last 30 days contribute fully to your consistency score • Historical Credit: Activities between 31-90 days old receive partial credit (up to 50%) to account for users who sync historical data • If you have no scheduled appointments, activities still contribute based on frequency: - 1 activity per week = 50% consistency - 2-3 activities per week = 75% consistency - 4+ activities per week = 100% consistency • Example: 4 activities per week in last 30 days = 100% consistency score • Strava-Only Users: Even without workouts or appointments, your Strava activities can generate a full consistency score based on activity frequency
Volume Score (20% weight):
• Each activity from the last 30 days counts as 1 volume unit • Combined with logged exercises from workout sessions • System searches up to 90 days back to find activities, then filters to last 30 days for calculation • Example: 30 activities in last 30 days = 100% volume score • Strava-Only Users: Your synced activities alone can generate a volume score (no logged exercises needed)
Recovery Score (5% weight):
• Uses heart rate data from activities • Requires activities with HR data recorded • Example: 15+ activities with HR data = 100% recovery score
Streaks:
• Consecutive days with activities count toward your streak • Includes all activity types: - Completed workout sessions from your plan - Completed Personal Training (PT) appointments - Completed Group Classes - Synced activities from Strava/Garmin (runs, rides, etc.) • Current Streak: Counts consecutive days from today backwards • Best Streak: Longest consecutive days period in the last 90 days • Example: PT session on Monday + Strava ride on Tuesday + Group class on Wednesday = 3-day streak
Automatic Updates:
• Score recalculates automatically after each activity sync • No manual action needed • Use refresh button (🔄) if you want to force recalculation
Activity Matching:
• System automatically matches activities to scheduled workout sessions • Matches activities within ±30 minutes of appointment time • High confidence matches (within 1 minute) automatically link • Activities can still contribute to score even if not matched to appointments
Sync Frequency:
• Initial Sync: Last 30 days of activities on first connect • Ongoing Sync: New activities sync automatically (typically within a few hours) • Manual Sync: You can trigger manual sync from Settings if needed • Historical Data: Activities older than 30 days still contribute to your score (with reduced weight) if they're within the 90-day window
Viewing Your Synced Activities:
• Activities are stored in your account and contribute to metrics • You can see activity impact in your Build Score breakdown • Activities are matched to workout sessions when applicable • Historical data is preserved even if you disconnect
Disconnecting Strava:
1. Go to Connections (profile menu → Connections) 2. Find Strava in your connected apps 3. Click "Disconnect" 4. Your synced data remains, but new activities won't sync 5. You can reconnect anytime
Privacy & Permissions:
• Read-Only Access: We only request permission to read your activities • No Posting: We never post activities to Strava on your behalf • Secure Storage: All data is encrypted and stored securely • Your Control: You can disconnect anytime
Troubleshooting:
"Connection failed" or "Invalid redirect URI" • This usually means the Strava app configuration needs updating • Contact support - this is a technical configuration issue • Make sure you're using the production app (not a test app)
"No activities syncing" • Initial sync includes last 30 days - wait a few moments • Check that you have activities in Strava from the last 30 days • Try disconnecting and reconnecting • Check backend logs for sync errors
"Build Score not updating after sync" • Score recalculates automatically after sync • Wait 30 seconds for auto-refresh, or click refresh button (🔄) • Activities from the last 30 days contribute fully; activities 31-90 days old receive partial credit • If you have Strava activities but score is still 0, check: - Activities are not marked as duplicates - Activities are within the last 90 days - Click the refresh button to force recalculation - Check backend logs for sync errors • Verify activities aren't marked as duplicates
"Activities not showing in score" • Activities from the last 30 days contribute fully to your score • Activities between 31-90 days old receive partial credit (up to 50% for consistency) • Activities older than 90 days don't contribute to current score calculations • Activities must have valid start times and not be marked as duplicates • Click the refresh button (🔄) to force recalculation if activities aren't appearing
"Heart rate data not appearing" • Requires activities recorded with a heart rate monitor • Not all activities have HR data (depends on your device) • HR data is optional - activities still count without it
Rate Limits:
• Strava allows 300 read requests per 15 minutes • 3,000 requests per day • Our system respects these limits automatically • Large syncs may take longer due to rate limiting
Best Practices:
• Connect Early - Connect Strava when you first set up your account • Keep Connected - Leave Strava connected for automatic syncing • Use HR Monitor - Record activities with heart rate for richer data • Name Activities - Named activities in Strava are easier to identify • Regular Activity - Consistent activity improves your Build Score
Questions? If you have issues connecting Strava or questions about how activities affect your score, contact support or check the troubleshooting section.