Skip to content

mieraci22/Breathe-Chrome-Extension

Repository files navigation

Breathe - A Guided Breathing Chrome Extension

Breathe Extension Screenshot

A simple, beautiful, and effective tool for practicing guided breathing exercises directly in your browser. Reduce stress, improve focus, and find your calm.


✨ Features

  • Multiple Breathing Patterns: Choose from scientifically-backed patterns like 4-7-8 Breathing, Box Breathing, and more to suit your needs.
  • Customizable Sessions: Select session durations of 1, 3, 5, or 10 minutes to fit your schedule.
  • Intuitive Visualizer: A clean, minimalist circle expands and contracts to guide your breath, with a clear countdown for each phase.
  • Progress Tracking: See your daily and total session counts to stay motivated and build a consistent mindfulness habit.
  • Audio Cues (Optional): Enable gentle sound cues to guide you without needing to watch the screen.
  • Session Reminders: Set alarms to remind you to take a break and breathe throughout the day.
  • Lightweight & Fast: Designed to be non-intrusive and ready whenever you need it.

🛠️ Technologies Used

This extension was built with modern web technologies and Chrome APIs:

  • Frontend: HTML5, CSS3, JavaScript (ES6+)
  • Chrome Extension APIs:
    • chrome.storage for saving user settings and session data.
    • chrome.notifications for displaying welcome messages, achievements, and reminders.
    • chrome.alarms for scheduling session reminders.

Installation

1. Install from the Chrome Web Store (Recommended)

(Coming Soon! - []

2. Install for Development (Manual)

If you want to run the extension locally or contribute to the project:

  1. Clone the repository:
    git clone [https://github.com/mieraci22/Breathe-Chrome-Extension.git](https://github.com/mieraci22/Breathe-Chrome-Extension.git)
  2. Open Google Chrome and navigate to chrome://extensions.
  3. Turn on "Developer mode" in the top-right corner.
  4. Click the "Load unpacked" button.
  5. Select the Breathe-Chrome-Extension folder that you just cloned.
  6. The "Breathe" icon will now appear in your extensions toolbar!

📄 License

This project is open-source and available under the MIT License.


💬 Feedback & Contributions

Feedback is greatly appreciated! If you have any suggestions, find a bug, or want to contribute, please feel free to open an issue or submit a pull request.

About

A guided breathing extension for stress relief and focus.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors