Support | Notion

💧 Support Document: Leaf - Localized Fitness & Diet Tracker

Leaf is a privacy-focused mobile application designed to help you track your fitness and nutrition entirely on your device.

1. Core Philosophy: Data & Privacy

Local Data Storage: All your data, including your profile, diet logs, and workout history, is stored only on your device using SwiftData and is never uploaded to the Leaf developers' servers.
iCloud Sync (Optional): You can optionally enable iCloud sync to backup and synchronize your data across your Apple devices. Data synced via iCloud is encrypted using Apple's CloudKit.
Subscription-Based AI: AI-powered features (Smart Log) are available through the Leaf Pro subscription. No API key required from users.

2. Getting Started

Onboarding & TDEE Calculation

The App requires basic biometric data (age, gender, height, weight) and activity level to calculate your Total Daily Energy Expenditure (TDEE) and Basal Metabolic Rate (BMR) using the Mifflin-St Jeor Equation. Your selected fitness goal determines the caloric adjustment.

Dashboard (Today Tab)

The Dashboard provides a daily summary:

Calorie Ring: Shows your remaining calories towards your calculated TDEE target. It turns the warning color (Burnt Orange) if you exceed your calorie target, or the primary color (Sage Green) if you are under or at target.
Macro Pills: Shows your current consumption of Protein, Carbs, and Fat against your calculated targets.
Hydration Tracking: Quick-add buttons for logging water intake.

3. Smart Log (AI Food Logging)

Leaf uses external AI services to power the Smart Log feature. This feature requires a Leaf Pro subscription.

Feature	Function	Data Sent to AI Provider
Smart Log (Text)	Analyzes a text description (e.g., "A latte and a bagel") to return estimated macros (Calories, Protein, Carbs, Fat) in JSON format.	The text input is sent to our backend, which forwards it to DeepSeek for AI analysis.
Smart Log (Photo)	Analyzes a meal photo to return estimated macros.	The photo is sent to our backend, which forwards it to Doubao (ByteDance/Volcengine) for AI vision analysis.