- 1. Getting Started & Keychain Auth
- 2. Dashboard & HYROX Station Hub
- ↳ Saved Planned Routines Quick-Launcher
- ↳ Station Alternatives & Volume Rollup
- 3. Workouts, Favorites, Ghost Replay & Strava
- 4. Workout Detail & Biometric Analysis
- ↳ Direct Split Editing & Drum Pickers
- 5. Performance Analytics (Banister Model)
- 6. Settings, Goals & Account Deletion
- ↳ Station Alternatives Configuration
- 7. Achievements & Badges
- 8. Custom Routine Builder & AI Planner
- 9. Guided Workout Experience
- 10. End-to-End Sample Athlete Journey
- 11. watchOS Companion App Integration
- ↳ Custom Workouts & Ghost Pacer HUD
1. Getting Started & Authentication
RoxKit makes evaluation and App Store testing immediate with zero onboarding hurdles while enforcing enterprise-grade iOS Keychain token security and legal compliance.
One-Click Guest Mode (Continue as Guest)
- Instant Live Session: Authenticates directly against a pre-populated demo athlete profile (
demo@roxkit.app) with a single tap. - Rich Pre-Loaded Telemetry: Immediately showcases authentic HYROX station splits, Suffer Scores, saved planned routines, Banister readiness curves, and unlocked badges.
- Guaranteed Reviewer Routing: Routes App Store reviewers and demo users straight to the primary Dashboard.
Zero-Trust iOS Keychain Security & Legal Compliance
- Hardware-Backed iOS Keychain Persistence: On iOS, JWT access and refresh tokens are stored securely in the native Keychain (
kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly) with automatic background401token refresh and an offline HealthKit workout retry queue. - Real-Time Validation: Enforces email formatting, 6-character password minimums, confirmation matching, and inline password visibility toggling.
- Native Legal Sheets: Direct links to the Privacy Policy and Terms of Service open cleanly inside a native iOS
SFSafariViewControllersheet.
2. Dashboard, Saved Routines Quick-Launcher & HYROX Station Hub
The Dashboard serves as your daily command center, uniting week-to-date training volume, physiological strain, saved custom routines, and station-by-station split benchmarks.
Saved Planned Routines Quick-Launcher Bar & Collapsible Searchable Drawer
Integrated directly into the top Workout Generator & Planner card is the Saved Planned Routines Quick-Launcher Bar and its expandable library drawer:
- Sleek 1-Line Quick-Launcher: Displays your saved routine count (
📋 SAVED (3)), a quick-switch selector dropdown, target duration badge (⏱️ 27:30), total split/distance summary, and inline station preview pills. - 1-Tap Watch Dispatch (
⌚ Send to Watch): Immediately pushes the selected routine's stages and target paces to your paired Apple Watch viaWCSession. - Collapsible Searchable Drawer (
▾ All (N)): Expands a scroll-capped routine library with instant search filtering by routine title or station movement, plus inline⌚ Send,✏️ Edit, and🗑️ Deleteactions.
Weekly Performance Overview Cards
| Metric Card | Measured Physiological Parameter | Visual Feedback & Analytics |
|---|---|---|
| Suffer Score | Cumulative cardiovascular exertion points | Weekly target ring, daily M–Su distribution bars, and logged workout list. |
| Running Distance | Total running kilometers completed | Aerobic mileage tracker with daily bar breakdown vs. weekly distance target. |
| Weekly Zone Targets | Minutes accumulated in Z2–Z5 | Heart rate threshold minutes tracked toward weekly aerobic and anaerobic caps. |
| Energy Burned | Active kilocalories burned | Total metabolic expenditure calculated continuously from optical sensor data. |
Authentic HYROX Station Badges & Silhouette Iconography
| Station | Movement Silhouette | Target Unit | Tracked Telemetry |
|---|---|---|---|
| 1. SkiErg | Skier pull silhouette | Meters | Weekly Goal, Sets, Best Split, Avg HR |
| 2. Sled Push | Low drive sled silhouette | Meters | Total Distance, Sets Completed, Split Times |
| 3. Sled Pull | Deep seated lean & pull silhouette | Meters | Distance Moved, Pacing, Peak Exertion |
| 4. Burpee Broad Jumps | Explosive leap silhouette | Reps | Total Reps, Average Rep Cadence, Heart Rate |
| 5. Rowing | Classic stroke finish silhouette | Meters | Distance Accumulated, Pace/500m, Aerobic Load |
| 6. Farmers Carry | Dual kettlebell carry silhouette | Meters | Heavy Carry Volume, Grip Endurance, Distance |
| 7. Sandbag Lunges | Deep lunge drive silhouette | Meters | Total Lunge Distance, Quad Tax, Split Duration |
| 8. Wall Balls | Full squat to high target silhouette | Reps | Completed Reps, Unbroken Set Pacing, Avg HR |
Station Alternatives & Smart Volume Rollup
- Parent Station Aggregation: Workouts recorded with alternative exercises (e.g.,
SkiErg: Echo Bike,Sled Push: Heavy Leg Press,Burpee Broad Jump: Devil Press) automatically roll up into the corresponding parent station tile on the Dashboard. - Accurate Target Progress: Substituted volume automatically credits toward your weekly station goals and achievement badges.
- Transparent Breakdown Modal: Clicking any station tile reveals the full split history for the week, clearly distinguishing the alternative used while maintaining unified station volume tracking.
3. Workouts History, Favorites, Ghost Replay & Strava Sync
The Workouts screen maintains a chronological history of all completed training sessions, equipped with Favorite bookmarking, 1-tap Apple Watch Ghost Pacer replay, Strava publishing, and AI multi-workout comparison.
Favorite Workouts & 1-Tap Watch Ghost Pacer Replay (⌚ Replay)
- Bookmark Benchmark Workouts (
⭐): Star any workout card to save it as a Favorite and filter your log instantly using the ⭐ Favorites Only toggle. - Race Your Ghost on Apple Watch (
⌚ Replay): Tapping ⌚ Replay on a Favorite workout transmits its exact stage order, split durations, and stage heart rates to your Apple Watch viaWCSession.sendMessage, launching Favorite Simulation (Ghost Pacer) Mode on your wrist.
Post to Strava & AI Coaching Comparison
- Post to Strava: Share completed workouts directly to Strava with formatted stage splits and heart rate telemetry.
- Summarize & Compare Selected: Check multiple workouts to generate an aggregated AI synthesis, or select two sessions for a side-by-side pacing and cardiac drift comparison.
4. Workout Detail, Direct Split Editing & Biometric Analysis
Tapping any workout opens an executive biometric report featuring physiological zone distributions, interactive HR spline telemetry, voice-dictated notes, and post-workout split editing.
Direct Stage Row Editing & Smart Stage Editor Modal
Athletes can refine any recorded workout split directly from Workout Detail by clicking Edit Splits and tapping the ✏️ icon on any stage row:
- Stage Type & Station/Alternative Selector: Reclassify any interval as
🏃 Run,💪 Station,⚡ RoxZone,☕ Rest, or🚴 Cardio, and pick from all 8 HYROX stations or custom Station Alternatives while preserving compound alternative metadata. - iOS-Style Drum Wheel Pickers: Dial in exact split durations (
HR / MIN / SEC) and distances or repetitions (1000s / 100s / 10s / 1s) with tactile scroll-wheel precision. - Sequential Station Recovery: Automatically restores or re-indexes multi-stage HYROX sequences and recomputes Dashboard station totals upon saving.
Executive Telemetry Heart Rate Spline Chart & Protected Notes
- Executive Telemetry Spline Canvas: Plots continuous heart rate across labeled vertical stage transition dividers with interactive point inspection and portrait mobile modal zoom.
- 5-Zone Heart Rate Distribution: Breaks down time and percentage spent in Z1 Active Recovery through Z5 Anaerobic Max.
- Voice Dictation & Trigger-Protected Notes: Transcribe post-workout notes hands-free via 🎙️ Voice Dictate. Custom and AI-evaluated notes are protected by PostgreSQL triggers (
protect_workout_notes_on_update) so background syncs never overwrite them.
5. Performance Analytics & Readiness (Banister Model)
Longitudinal fitness modeling powered by the gold-standard Banister Impulse-Response Model to calculate chronic fitness, acute fatigue, and race readiness.
Banister Index Triad & Daily Readiness Gauge
| Metric | Window | Definition & Athletic Meaning |
|---|---|---|
| Fitness (CTL) | 42-day rolling load | Chronic Training Load representing your overall aerobic engine and volume base. |
| Fatigue (ATL) | 7-day rolling load | Acute Training Load representing short-term systemic exhaustion. |
| Form (TSB) | CTL − ATL | Training Stress Balance indicating race readiness and freshness. |
6. Settings, Custom Target Goals & Account Compliance
Calibrate weekly goals, HR zone boundaries, custom station alternatives, third-party connections, and self-service account deletion.
Station Alternatives & Substitutions Configuration
- Custom Substitution Matrix: Select Run or any of the 8 HYROX stations, add custom substitute exercises (e.g., Echo Bike, Trap Bar Carry), remove chips with one tap, or reset to race defaults.
- Real-Time Watch Sync: Immediately syncs to Supabase and pushes to your paired Apple Watch via
WCSession.updateApplicationContext. - Full Guideline 5.1.1(v) Self-Service Account Deletion: Navigating to Settings → Delete Account permanently deletes all user data across Supabase (
workouts,workout_stages,station_efforts,planned_workouts,user_profiles, andauth.usersviadelete_own_account()RPC), wipes iOS Keychain credentials, and dispatchesclearUserDatato the Apple Watch.
7. Achievements & Badges
Dynamic weekly achievement badges that evaluate in real time against your completed workouts and substituted station volume.
- Weekly Core Badges: Peak Suffering, Distance Runner, Calorie Crusher, Base Builder, Anaerobic Beast.
- HYROX Station Badges: Engine Builder (SkiErg + Row), Powerhouse (Sled Push + Pull), Launch Pad (Burpees), Farmer's Walk, Leg Destroyer (Lunges + Wall Balls).
- Milestone Badges: Hyrox Hybrid, Consistency Champion, Double Session, Fit Legend.
8. Custom Routine Builder ("Plan Routine") & AI Workout Recommender
RoxKit combines a precision Custom Routine Split Builder (with cloud persistence and 1-tap Apple Watch dispatch) alongside an adaptive AI Workout Recommender.
Custom Routine Split Builder & Send to Watch Dispatch
- Multi-Stage Split Engineering: Add
🏃 + Run,⚡ + RoxZone,💪 + Station, or☕ + Restsplits, or populate a full 16-split race template via ⚡ Full HYROX (16 Splits). - Cyber-Athletic Micro-Steppers & Neon Reorder Controls: Adjust target distance/reps and split minutes/seconds using custom glowing steppers and reorder stages with neon
↑/↓controls. - Cloud Save & Wrist Dispatch: Click 💾 Save / Update Routine to persist to Supabase (
planned_workouts) or click ⌚ Send to Watch to launch the routine immediately on your Apple Watch.
AI Workout Recommender
9. Guided Workout Experience
Transforms your AI-recommended routine into an interactive, timer-driven workout with live coaching cues and automatic history logging.
10. End-to-End Sample Athlete Journey
Instant Access via Guest Mode or iOS Keychain
Athlete opens RoxKit on iPhone or Web, authenticates via 1-tap Guest Mode (or hardware Keychain session), and reviews their weekly readiness.
Dashboard Audit & Custom Routine Engineering
Inspects weekly station progress, opens Plan Routine (or selects a saved routine from the Quick-Launcher Bar), and taps ⌚ Send to Watch.
Wrist Execution & Ghost Pacer Comparison
Executes intervals on Apple Watch with Lactate Threshold haptic alarms, long-press station alternatives, and dual LIVE / GHOST heart rate pacing.
Biometric Spline Review, Split Refinement & Strava Share
Reviews the Executive Telemetry HR Spline Chart in Workout Detail, fine-tunes splits via the Smart Stage Editor drum pickers, and shares to Strava.
11. watchOS Companion App Integration
The RoxKit Apple Watch App (watchOS 10.0+) is an autonomous, race-hardened telemetry and pacing computer engineered specifically for HYROX athletes, functional fitness competitors, and hybrid runners.
Apple Watch Ultra & Series Interface Gallery (12 Core Views)
Captured live from Apple Watch Ultra 3 (49mm, 410 × 502 @ 2x):
HYROX Station Selection Carousel (All 9 Stations)








