Skip to content

Your personal health companion that reminds you to take breaks, stay hydrated, and protect your eyes.

Notifications You must be signed in to change notification settings

ajdincatic/HealthBuddy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HealthBuddy - Your Wellness Companion 🌟

HealthBuddy Logo

Download: https://chromewebstore.google.com/detail/healthbuddy/kjnmakehialniegpjekmppllemgkbjoh

HealthBuddy is a Chrome extension designed to help you maintain healthy habits while working at your computer. It provides timely reminders for standing up, staying hydrated, and protecting your eyes using the 20-20-20 rule.

Why HealthBuddy? 🎯

  • Prevent Sedentary Behavior: Regular reminders to stand and move
  • Stay Hydrated: Consistent water intake throughout your day
  • Protect Your Vision: Follow the 20-20-20 rule for eye health
  • Maintain Work-Life Balance: Smart quiet hours for focused work
  • Track Your Progress: Build healthy habits with streak tracking

Features ✨

Core Features

  • Stand Up Reminders: Get prompted to stand up and stretch at customizable intervals
  • Water Break Alerts: Stay hydrated with regular water break reminders
  • Eye Care (20-20-20 Rule): Protect your eyes by following the 20-20-20 rule

Smart Features

  • Quiet Hours: Set periods when you don't want to be disturbed
  • Smart Snooze: Temporarily pause all reminders with countdown and cancel option
  • Intelligent Scheduling: Automatically adjusts next break times around quiet hours
  • Visual Progress: Real-time progress bars for each reminder type

Customization

  • Flexible Time Format: Toggle between 12-hour and 24-hour time displays
  • Customizable Settings: Adjust all reminder intervals to suit your preferences
  • Quick Testing Mode: Set intervals as low as 1 minute for testing and customization
  • Individual Controls: Enable/disable each reminder type independently

Usage 💡

  1. Setting Up Reminders

    • Click the HealthBuddy icon in your toolbar
    • Set your preferred intervals for each reminder type
    • Enable/disable specific reminders with toggle switches
    • Set intervals between 1-180 minutes for each reminder type
  2. Visual Feedback

    • Watch real-time progress bars for each reminder
    • See exact times for upcoming breaks
    • Get clear indication of adjusted schedules
  3. Quiet Hours

    • Set your quiet hours to prevent notifications during specific times
    • Perfect for meetings or focused work sessions
    • Next break times automatically adjust around quiet hours
    • Clear indication when breaks are scheduled after quiet hours
  4. Time Format

    • Toggle between 12-hour and 24-hour time formats
    • Affects all time displays in the extension
    • Persists your preferred format across sessions
  5. Statistics

    • Track your daily breaks
    • Build and maintain streaks
    • Reset statistics when needed
  6. Smart Break Management

    • Intelligent rescheduling around quiet hours
    • Flexible snooze options with visual countdown
    • Quick reset options for statistics

Features in Detail 🔍

Stand Up Reminders

  • Customizable intervals (1-180 minutes)
  • Gentle notifications to encourage movement
  • Toggle on/off as needed
  • Perfect for testing with 1-minute intervals
  • Visual progress tracking

Water Break Reminders

  • Stay hydrated throughout the day
  • Adjustable frequency
  • Easy to snooze when needed
  • Flexible timing from 1-180 minutes
  • Real-time countdown display

Eye Care

  • Based on the 20-20-20 rule
  • Helps prevent eye strain
  • Customizable reminder intervals
  • Set shorter intervals for more frequent breaks
  • Progress indication for next break

Quiet Hours

  • Set do-not-disturb periods
  • Automatically resumes after quiet hours
  • Perfect for meetings and focus time
  • Smart rescheduling of breaks around quiet periods
  • Clear indication of adjusted break times
  • Handles midnight crossing periods

Smart Snooze System

  • 30-minute pause on all reminders
  • Real-time countdown display
  • One-click cancellation
  • Automatic expiration
  • Visual status indication

Progress Tracking

  • Daily break counter
  • Consecutive day streaks
  • Visual progress bars
  • Real-time updates
  • Persistent statistics

Technical Details 🔧

Built with:

  • HTML5
  • CSS3
  • JavaScript
  • Chrome Extension APIs

Key Features:

  • Real-time progress tracking
  • Persistent storage
  • Background processing
  • Smart scheduling system

APIs used:

  • Chrome Storage API
  • Chrome Alarms API
  • Chrome Notifications API
  • Chrome Background Services

Privacy 🔒

HealthBuddy respects your privacy:

  • No data collection
  • All settings stored locally
  • No external services used
  • No analytics or tracking
  • No permissions beyond necessities

Support 💪

If you find any bugs or have feature requests, please open an issue on GitHub.


Made with ❤️ for a healthier developer community

About

Your personal health companion that reminds you to take breaks, stay hydrated, and protect your eyes.

Resources

Stars

Watchers

Forks