A local-first iPhone health journal that brings Apple Health, food notes, and detailed strength-training logs into one daily record.
This is an early community project, not a medical device. It does not diagnose conditions or replace professional medical advice.
Apple Watch is excellent at recording movement, workouts, heart rate, HRV, energy, and sleep. It cannot know the exact food you ate or every strength-training set you completed. Daily Rhythm keeps those two sources separate and useful:
- Apple Health facts: steps, energy, exercise minutes, sleep, heart rate, HRV, and workouts.
- Manual records: food, estimated nutrition, exercise selection, weight, reps, and sets.
- Daily history: one card per day with backfilling, editing, deletion, and rest-day marking.
- Analysis: recent patterns described with evidence, without diagnosis or shame.
- Body composition: weight, body-fat percentage, lean body mass, and BMI read from Apple Health when a scale companion app writes them.
- Bilingual UI: Simplified Chinese and English.
All personal records stay in Apple Health or local app storage. This repository contains no user health data and the app has no analytics or cloud backend.
- macOS with Xcode 16 or later
- iOS 17 or later
- A physical iPhone for real HealthKit data
- Apple Watch is optional but recommended
- An Apple Developer account for installing on a device
- Clone this repository.
- Open
DailyRhythm.xcodeprojin Xcode. - Select the
DailyRhythmtarget. - Under Signing & Capabilities, choose your own development team and use a unique bundle identifier.
- Confirm the HealthKit capability is enabled.
- Run on your iPhone and grant only the Health permissions you want to share.
The simulator is useful for interface work, but it does not represent the Health store on your phone.
The project is generated with XcodeGen. After changing project.yml, regenerate it with:
brew install xcodegen
xcodegen generate- The app reads HealthKit only after system authorization.
- Food and detailed training records are stored locally with
UserDefaults. - The app does not upload health records to this repository or any server.
- Nutrition values are estimates and remain editable.
- Never attach a real Health export, database, or personal screenshot to an issue.
Generic foods use editable reference values based on USDA FoodData Central. Restaurant and packaged-food entries are serving estimates and should be checked against the current nutrition label when available. Missing portions are shown explicitly instead of silently pretending the estimate is precise.
Ideas, bug reports, exercise additions, nutrition-source improvements, accessibility work, localization, and SwiftUI contributions are welcome. Read CONTRIBUTING.md before opening a pull request.
MIT. See LICENSE.