StrideMap

Distance Tracking & Route Intelligence

Page 1 of 7 — Onboarding
01 — Welcome Splash
πŸ—ΊοΈ

StrideMap

Track every mile. Own your route.

AVEOSOFT

Your Personal Distance Engine

Powered by HealthKit & Mapbox β€” premium minimalist tracking

πŸƒ
GeoJSON
Routes
Haptic
Feedback
0%
Bkg Drain
02 — Health Permissions
9:41
●●●
Health Data Access

Sync with Apple HealthKit

Foreground-only pedometer β€” zero background battery drain

❀️
πŸ‘Ÿ

Step Count

Reads pedometer on foreground resume only

Required
πŸ“

Walking + Running Distance

Updates master odometer on each app open

Required
πŸ”₯

Active Energy Burned

Calories mapped to session segments

Optional
Allow HealthKit Access (iOS)
Allow Google Fit (Android)
03 — Mapbox Route Load
9:41
●●●
Pre-Loaded Route GeoJSON

Your Routes Are Ready

Pre-parsed GeoJSON polylines β€” tap any route to preview on Mapbox

πŸ—ΊοΈ
Route A
Route B
Route C
All Routes

12.4

mi

Downtown Loop

14 waypoints β€” GeoJSON loaded and parsed

8.7

mi

Riverside Trail

9 waypoints β€” GeoJSON loaded and parsed

5.2

mi

Park Sprint

6 waypoints β€” GeoJSON loaded and parsed

01 — Active Session
9:41
●●●
Live Session β€” Downtown Loop
24 : 17

Session Duration

3.82

Miles Covered

↑ +0.4 mi last split

9:42

Avg Pace (min/mi)

↑ -0:18 vs last run

64%

Daily Distance Goal

3.82 / 6.0 mi

Split Pace (min/mi)

Mi 1
Mi 2
Mi 3
Mi 4
02 — Master Odometer
9:41
●●●
Lifetime Odometer

847.3

Total Miles β€” All Time

↑ +3.82 today

84%

Monthly Goal

84.7 / 100 mi

231
Sessions
12,430
Avg Steps
9:58
Avg Pace

Weekly Distance (mi)

Mon
Tue
Wed
Thu
Fri
Sat
Sun

8,432

Steps Today (HealthKit Sync)

↑ +12% vs 30-day avg

03 — Haptic Feedback Zones
9:41
●●●
Haptic Trigger Map β€” Route A

Haptic Feedback Active

Waypoint proximity fires Light, Medium, or Heavy pulses via CoreHaptics

πŸ“³

0.1

mi

Waypoint Approach β€” Light

UIImpactFeedbackGenerator.light β€” 100m radius trigger

0.0

mi

Waypoint Reached β€” Medium

UIImpactFeedbackGenerator.medium β€” on GPS arrival

0.0

mi

Route Complete β€” Heavy

UIImpactFeedbackGenerator.heavy β€” finish line burst

7 / 14

Waypoints Cleared

↑ Downtown Loop

50%

Route Progress

7 of 14 waypoints passed

01 — Mapbox Route Overview
9:41
●●●

Downtown Loop

12.4 mi β€” 14 waypoints β€” Custom Mapbox Style Active

πŸ—ΊοΈ
Overview
Segments
Elevation
Waypoints

12.4

Route Distance (mi)

↑ Est. 2h 04m at current pace

Elevation Profile (ft)

0 mi
3 mi
6 mi
9 mi
12 mi
420 ft
Elev Gain
14
Waypoints
Hard
Grade
02 — Segment Breakdown
9:41
●●●
Route Segments β€” Downtown Loop

0–3

mi

Seg 1: Harbor Start

Flat grade β€” comfortable pace zone

3–7

mi

Seg 2: Central Hill

280 ft elevation gain β€” push zone

7–10

mi

Seg 3: Park Descent

140 ft drop β€” recovery pace

10–12

mi

Seg 4: Finish Straight

Flat β€” sprint finish zone

28%

Personal Best Gap

Best: 1h 52m β€” Avg: 2h 04m

1h 52m

Personal Best Time

↓ -8% effort to beat it

01 — Session History
9:41
●●●
Recent Activity

Distance This Week (mi)

Mon
Tue
Wed
Thu
Fri
Sat
Sun

7:14

AM

Downtown Loop β€” 12.4 mi

Sat Apr 19 β€” Avg pace 9:42/mi β€” 14/14 waypoints

6:30

AM

Riverside Trail β€” 8.7 mi

Fri Apr 18 β€” Avg pace 10:05/mi

5:55

AM

Park Sprint β€” 5.2 mi

Wed Apr 16 β€” Avg pace 8:58/mi

26.3
Mi This Week
3
Sessions
4h 22m
Total Time
02 — Session Deep Dive
9:41
●●●
Session Detail β€” Apr 19

12.4

Distance (mi)

↑ Route personal best

9:42

Avg Pace (min/mi)

↑ -0:18 vs 30-day avg

100%

Route Completed

Downtown Loop β€” all 14 waypoints cleared

Per-Mile Pace Breakdown

Mi1
Mi2
Mi3
Mi4
Mi5
Mi6
14/14
Waypoints
1,840
Cal Burned
18,320
Steps
03 — Streaks & Milestones
9:41
●●●
Your Progress
72%

Monthly Distance Goal

72.1 / 100 mi β€” 8 days left

93%

Active Day Streak

13 of 14 days logged

847.3

Lifetime Miles (Odometer)

↑ +3.82 today via HealthKit

Monthly Distance (mi)

Jan
Feb
Mar
Apr
14
Day Streak
231
Sessions
847 mi
Lifetime
01 — HealthKit Dashboard
9:41
●●●
Health Data β€” Foreground Sync Active
70%

Daily Step Goal

8,432 / 12,000 steps

8,432

Steps Today

↑ +1,204 since last app open

3.82

Walking Distance (mi)

↑ HealthKit foreground sync

Hourly Steps Distribution

6am
7am
8am
9am
10am
11am

412

Active Calories Burned

↑ +38 cal vs yesterday

02 — Pedometer Sync Engine
9:41
●●●
Pedometer Engine β€” Battery-Safe Mode

Foreground-Only Sync

Pedometer pings HealthKit on app resume β€” AppDelegate foreground hook

πŸ”„

18,320

Steps This Session

↑ Last synced on foreground: just now

56%

Weekly Step Goal

58,924 / 84,000 steps

0%
Bkg Drain
Foreground
Sync Mode
Active
HK Status
Apple HealthKit Sync (iOS)
Google Fit Sync (Android)
01 — Beta Overview Dashboard
app.example.com/admin-console
MENU
Closed Beta β€” Live Overview
142
Beta Users
4,820
Total Miles
1,238
Sessions Today
98.4%
Uptime

Daily Active Users β€” Last 14 Days

Apr 8
Apr 9
Apr 10
Apr 11
Apr 12
Apr 13
Apr 14

33.9

Avg Miles per User

↑ +4.2 mi vs last week

8.7

Avg Sessions per User

↑ +1.1 vs last week

Beta Live HealthKit OK Mapbox OK
02 — Route Performance Analytics
app.example.com/admin-console
MENU
Route Engagement β€” All Beta Users

Route Completion Count

Downtown Loop
Riverside Trail
Park Sprint

142

users

Downtown Loop β€” 12.4 mi

Most completed β€” avg time 2h 01m β€” 97.8% waypoint hit rate

98

users

Riverside Trail β€” 8.7 mi

Highest-rated route β€” 4.9 stars avg β€” 9.2 avg repeats

74

users

Park Sprint β€” 5.2 mi

Fastest avg completion β€” 48m β€” most used for daily goal

96.2%

GeoJSON Parse Success Rate

↓ 3 malformed coord failures logged

14ms

Mapbox Tile Load Avg

↑ Within 50ms SLA

03 — Firestore & Backend Health
app.example.com/admin-console
MENU
Firebase Firestore β€” Live Telemetry
2.1M
Reads Today
480K
Writes Today
$0.84
Daily Cost Est
12ms
Avg Query

Firestore Reads (Hourly)

6am
7am
8am
9am
10am
11am

0

Crash Reports (24h)

↑ All systems nominal

Now

Schema v1.4 β€” Active

Firestore security rules validated β€” users, sessions, odometer, routes collections live

Now

Crashlytics β€” 0 Exceptions

iOS 17 + Android 14 β€” no unhandled exceptions in 48h

Feature Stack & Deliverables

Complete overview of confirmed features, deliverable items, and technical architecture for StrideMap.

πŸ—οΈ

Tech Stack

FlutterFlowMapbox Flutter SDKApple HealthKitGoogle Fit SDKFirebase FirestoreFigma Design System
⚑

Core Technologies

🐦
FlutterFlow β€” Visual app builder β€” pixel-perfect Figma translation, custom easing curves, haptic wiring for iOS and Android
πŸ—ΊοΈ
Mapbox Flutter SDK β€” Custom access token, style URLs, GeoJSON polyline rendering, proximity-based waypoint detection
❀️
Apple HealthKit β€” Foreground-only pedometer sync β€” steps, distance, active calories; AppDelegate resume hook
πŸƒ
Google Fit SDK β€” Android health data parity β€” foreground sync mirror of HealthKit, zero background drain
πŸ”₯
Firebase Firestore β€” Provided schema β€” users, sessions, odometer, routes collections; real-time listeners for live session state
🎨
Figma Design System β€” Pixel-perfect source β€” easing curves, haptic trigger specs, component variants, interaction overlays
πŸ“¦

V1 Deliverables Checklist

  • Pixel-perfect FlutterFlow build replicating all Figma screens for both iOS and Android platforms
  • Mapbox integration with provided custom access token, style URL, and GeoJSON polyline route rendering
  • Foreground-only HealthKit and Google Fit pedometer sync with write-back to master odometer in Firestore
  • Haptic feedback triggers β€” Light on waypoint approach, Medium on arrival, Heavy on route completion β€” via CoreHaptics and Android VibrationEffect
  • Custom easing curve animations matching Figma interaction specs for all screen transitions
  • Horizontal swipe navigation with gesture-driven screen transitions and correct easing timing functions
  • Firebase Firestore integration using the provided schema β€” sessions, odometer deltas, user profiles, GeoJSON metadata
  • GeoJSON parser to extract polyline coordinates and render point-to-point route overlays on Mapbox canvas
  • Closed-beta iOS .ipa via TestFlight and Android .apk via Play Internal Track with invite-gated distribution
  • Full QA pass on iPhone 15 Pro (iOS 17) and Pixel 8 (Android 14) covering golden path, haptic zones, and HealthKit sync
πŸ”§

Architecture Layers

Presentation
FlutterFlow + Figma
Pixel-matched UI components, custom easing animations, haptic feedback wiring, horizontal swipe gesture navigation, dark-mode design tokens
Map Engine
Mapbox Flutter SDK
Custom tile style rendering, GeoJSON polyline parser, animated route overlays, waypoint marker placement, GPS proximity detection for haptic triggers
Health Data
HealthKit / Google Fit
AppDelegate foreground hook for pedometer reads, distance aggregation on resume, calorie reads, atomic odometer write-back to Firestore β€” no background entitlements
Data Layer
Firebase Firestore
Provided schema: users collection, sessions sub-collection, odometer document, routes metadata β€” real-time snapshot listeners for live session UI updates
Auth & Distribution
Firebase Auth + TestFlight / Play Beta
Anonymous-to-authenticated account upgrade, closed-beta invite code gate, Crashlytics for zero-crash validation on target devices