https://github.com/codeanurag/ibreathe
iBreathe is a mindful breathing app built with SwiftUI for Apple Watch and iPhone. It guides users through calming breathing exercises using haptics and animation, and syncs session logs from Watch to iPhone using WatchConnectivity.
https://github.com/codeanurag/ibreathe
breathing-app healthkit mindfulness mvvm mvvm-architecture swift swiftui watchconnectivity watchos watchos-app xcode
Last synced: 2 months ago
JSON representation
iBreathe is a mindful breathing app built with SwiftUI for Apple Watch and iPhone. It guides users through calming breathing exercises using haptics and animation, and syncs session logs from Watch to iPhone using WatchConnectivity.
- Host: GitHub
- URL: https://github.com/codeanurag/ibreathe
- Owner: codeanurag
- License: mit
- Created: 2025-07-15T12:31:50.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-24T15:38:43.000Z (2 months ago)
- Last Synced: 2025-07-24T20:32:26.530Z (2 months ago)
- Topics: breathing-app, healthkit, mindfulness, mvvm, mvvm-architecture, swift, swiftui, watchconnectivity, watchos, watchos-app, xcode
- Language: Swift
- Homepage:
- Size: 562 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
🧘♂️ iBreathe
Mindful Breathing App for Apple Watch + iPhone
Guided breathing with haptics & synced session logs.
---
## 📋 Table of Contents
- [Features](#-features)
- [Tech Highlights](#-tech-highlights)
- [Screenshots](#-screenshots)
- [Setup & Run](#-setup--run)
- [Roadmap](#-roadmap)
- [Support](#-support)
- [Credits & License](#-credits--license)
---
## 🎯 Features
- Smooth inhale/exhale animation with haptic cues
- Choose from 1, 3, or 5-minute sessions
- Pause/resume mid-session
- Session logs saved on Watch & automatically synced to iPhone
- View session history on both devices
---
## 🔧 Tech Highlights
- SwiftUI for watchOS and iOS UI
- WatchConnectivity (`WCSession`) for cross-device sync
- Codable + FileManager for lightweight local persistence
- MVVM architecture and shared `SessionLog` model
---
## 📸 Screenshots
### ⌚ Watch App
- 
- 
- 
- 
### 📱 iPhone App
- 
---
## 🧪 Setup & Run
> ⚠️ **Note:** Watch→iPhone sync only works on real paired devices. Simulators can test UI but not connectivity.
1. Clone the repo:
```bash
git clone https://github.com/codeanurag/iBreathe.git
cd iBreathe
```
2. Organize files:
```
iBreathe/
├── docs/
│ ├── screen1.png
│ ├── screen2.png
│ ├── screen3.png
│ ├── screen4.png
│ └── screen5.png
├── iBreathe.xcodeproj
└── README.md
```
3. Open in Xcode:
```bash
open iBreathe.xcodeproj
```
4. Select your **iPhone + Apple Watch target**, build & run.
5. Start a breathing session on the Watch — logs will sync to iPhone automatically. View them in the “View Synced Logs” screen.
---
## 🚀 Roadmap
| Planned Feature | Status |
|--------------------------|------------|
| HealthKit integration | ✅ Done |
| Custom inhale/exhale durations | ✅ Done |
---
## 📞 Support
Have questions or need help?
- 🐛 **Bug Reports**: [Open an issue](https://github.com/codeanurag/iBreathe/issues)
- 💡 **Feature Requests**: [Start a discussion](https://github.com/codeanurag/iBreathe/discussions)
- 📧 **Contact**: [codeanuragpandit@gmail.com](mailto:codeanuragpandit@gmail.com)
---
## ❤️ Credits & License
Built with 💡 by [@codeanurag](https://github.com/codeanurag).
Licensed under the MIT License — see [LICENSE](LICENSE) for details.