Platform: macOS (Menu Bar & Desktop Widgets)
Target Audience: High-performance athletes, biohackers, and professional power users who rely on WHOOP and utilize macOS for their daily workflow.
1. Product Overview
Aura is a native macOS application that brings high-fidelity visibility of WHOOP data directly to the user's desktop environment. Designed to live frictionlessly in the macOS menu bar, Aura allows users to monitor their physiological state—Recovery, Strain, and Sleep—without breaking focus or resorting to mobile device distractions.
By combining Apple’s native design language (SwiftUI, Swift Charts) with WHOOP's physiological data architecture, Aura delivers a seamless, glanceable, and deeply analytical desktop experience.
2. Core Features & User Experience (UX)
Our integration emphasizes a clean, unobtrusive UI that strictly adheres to both macOS Human Interface Guidelines and WHOOP’s brand identity. We ensure compliance with the WHOOP Brand & Design Guidelines by strictly utilizing accurate color-coding for physiological states and displaying the required DATA BY WHOOP attribution prominently throughout the product.
Design Guideline Adherence
Aura enforces the WHOOP recovery color schemes exactly:
Red (0-33%), Yellow (34-66%), and Green (67-100%). Additionally, the required "DATA BY WHOOP" typography is styled properly per the provided brand specifications on all primary interfaces.
Authentication & Onboarding
Users connect their WHOOP account via a secure OAuth 2.0 flow. The onboarding screen clearly communicates the value proposition and features the required WHOOP attribution.
The Menu Bar Dashboard
The core interface is accessible via a menu bar dropdown, displaying the current physiological day. It includes a "Cycle Pager" allowing users to navigate through past days seamlessly.
- Key Metrics: Glanceable rings for Recovery, Strain, and Sleep, alongside HRV, RHR, and Calories.
- Recovery Color-Coding: Strict adherence to WHOOP's Red, Yellow, and Green recovery states.
Deep Sleep Insights
Users can drill down into their sleep performance directly from the dashboard. Aura reconstructs WHOOP's sleep stages (SWS, REM, Light, Awake) into clear horizontal bar charts and displays precise metrics like Sleep Need, Efficiency, Respiratory Rate, and Wakeups.
Workout & Activity Analysis
Activities logged by WHOOP are displayed within the daily cycle. Users can expand individual activities (e.g., Walking, Sauna) to view strain impact, duration, caloric burn, average/max heart rate, and a detailed breakdown of Heart Rate Zones.
macOS Desktop Widgets
For maximum glanceability, Aura includes native macOS desktop widgets in multiple sizes (Small, Large). These widgets provide instant visibility into the core triad of WHOOP metrics (Recovery, Strain, Sleep) right on the desktop.
3. Data Integration & API Strategy
Aura is engineered to be a "low-impact, high-value" client on the WHOOP API. We prioritize local data persistence to ensure a fast user experience while strictly minimizing network load.
Endpoints Utilized
Aura fetches data sequentially to build the daily physiological context:
- /v1/cycle
- /v1/recovery
- /v1/sleep
- /v1/activity
Synchronization & Caching (SwiftData)
- Local First: All fetched data is immediately cached locally using Apple's SwiftData framework. Subsequent UI interactions, widget updates, and historical cycle navigations query the local database entirely offline.
- Sync Frequency: Background synchronization is highly conservative. Users are expected to trigger a data refresh organically only 2 to 4 times per day (e.g., morning review, post-workout, evening check).
- Rate Limiting: To prevent API abuse, manual forced syncs via the UI are strictly throttled to a maximum of 1 call per 15-minute window.
4. Traffic Projections & Scalability
Based on our caching architecture and target demographics, we project a highly efficient API footprint.
- Expected API Calls: 4 to 8 calls per user, per day.
- Initial Launch Phase (~500 users): 2,000 to 4,000 total daily calls.
- Target Growth (~2,500 users): 10,000 to 20,000 total daily calls.
- Peak Load: Traffic will naturally distribute across global time zones, with expected peaks of just 10 to 40 calls per minute globally during morning hours.
5. Development & Demo Environment
Aura features a built-in "Demo Mode" for reviewers or prospective users to experience the UI layout and data visualization without requiring an active WHOOP account authorization.
