Skip to content

omerozerf/breathe-buddy

Repository files navigation

Breathe Buddy 🌿

Mindful Breathing Companion App

Breathe Mindfully


📲 Download Now

📦 App Store: Coming Soon – Currently Under Review
🔒 Your mindful breathing companion will be available shortly!


🧘 Overview

Breathe Buddy is a minimal and intuitive mobile application designed to help users practice mindful breathing, reduce stress, and improve mental well-being through scientifically backed breathing techniques.

Built with React Native + Firebase, the app provides a personalized experience, streak tracking, dark mode support, and rich analytics.


✨ Features

  • Guided Breathing Sessions (4-7-8, Box, Equal, Triangle)
  • 📅 Daily Goals & Streaks
  • 🌙 Dark Mode
  • 📈 Weekly & Monthly Progress
  • 🔔 Daily Reminder Notifications
  • 👤 Profile & Personalization Flow
  • 🧠 Session Journal & Mood Tracking
  • 🏆 Achievements & Rewards
  • ☁️ Cloud Sync (Firebase Auth & Firestore)

📸 Screenshots

Home Session Progress
Home Session Progress
Dark Mode Settings Session Complete
Dark Mode Settings Complete

🛠️ Tech Stack

  • React Native (TypeScript)
  • Firebase Auth + Firestore
  • Zustand for global state
  • ChartKit for analytics
  • react-native-safe-area-context
  • react-native-image-picker
  • Haptic & Voice Guide support (coming soon)

🚀 Getting Started

git clone https://github.com/your-username/breathe-buddy.git
cd breathe-buddy
yarn install

🛠 Add your Firebase config in services/firebase.ts.

📱 Run it:

npx react-native run-ios
# or
npx react-native run-android

📂 Project Structure

src/
├── screens/
├── components/
├── hooks/
├── services/
├── navigations/
├── assets/

📬 Feedback

💡 Have a feature request? Bug to report?
Open an issue or submit a pull request – every breath matters.


📄 License

MIT License
© 2025 Ömer Faruk Özer

About

Mobile App

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published