EyeBreak v2.3.0 - Professional UI Polish Update

EyeBreak v2.3.0 - Professional UI Polish Update

Release Date: December 6, 2025

This release focuses on delivering a cleaner, more professional user interface across the entire app. Every view has been polished with refined gradients, improved visual hierarchy, and smoother animations.

What's New

Menu Bar Timer Display

Your timer is now visible right in the menu bar!

Features:

• Live Countdown: See remaining time directly in the menu bar (e.g., "19:42")
• State Icons: Dynamic icons that change based on timer state
  • Eye icon when idle
  • Filled eye when working
  • Slashed eye during breaks
  • Pause icon when paused
• Monospaced Digits: Clean, professional font that doesn't shift as numbers change
• Smart Tooltips: Hover for detailed status information

Enhanced Floating Break Window

The notification-style break window now features improved visual definition:

Header Improvements:

• Enhanced icon badge with stronger gradient fill and subtle border
• Added shadow for depth and visual pop
• Close button now has a visible border and better contrast

Skip Button Enhancements:

• Increased border visibility (more visible outline)
• Added subtle shadow for a more tactile appearance
• Bolder text weight for better readability

Divider:

• Increased opacity for clearer section separation

Polished Onboarding Experience

First impressions matter. The onboarding flow now features:

Feature Items:

• Gradient icon badges with blue-to-cyan styling
• Subtle shadows for depth
• Spring animations on appearance

Permission Cards:

• Dynamic color theming based on state (orange for required, green for granted)
• Gradient backgrounds and borders
• Hover effects on action buttons
• Smooth scale animations

Refined Settings Views

About Section:

• Hidden scrollbar for cleaner appearance
• More compact layout with optimized spacing
• Reduced icon and font sizes for better proportions
• Card-based layout with subtle shadows and borders

Break Settings:

• New BreakStyleOptionCard component with selection highlighting
• EnhancedSliderCard for timing controls with icons and colors
• SectionHeaderView component for consistent section styling

Statistics View:

• Gradient icon badges for all section headers
• Enhanced chart container with card styling and borders
• Color-coded legend for chart data
• EnhancedStatBox with gradient backgrounds and animations

New Reusable Components

SectionHeaderView:

• Consistent header styling across all settings sections
• Icon + text with customizable colors
• Used throughout General, Breaks, and Statistics tabs

ProfessionalButtonStyle:

• Subtle press animation with scale and brightness effects
• Smooth easing for tactile feedback
• Applied to all action buttons

HoverEffectModifier:

• Unified hover behavior across interactive elements
• Background highlight and subtle scale effect
• Configurable corner radius

Visual Improvements

Gradients

• Linear gradients for icon backgrounds (blue-to-cyan theme)
• Angular gradients for progress rings
• Consistent opacity across all gradient fills

Shadows

• Subtle drop shadows on cards and buttons
• Color-matched glow effects (e.g., blue shadow on blue buttons)
• Improved depth perception throughout the UI

Animations

• Spring animations with tuned response and damping
• Content transitions for numeric text changes
• Smooth state transitions with opacity and scale effects

Typography

• Rounded design fonts for friendly appearance
• Semibold weights for headings
• Monospaced digits for timer displays
• Consistent sizing hierarchy

Technical Improvements

Architecture

• Combine framework integration for reactive UI updates
• Published properties for automatic state propagation
• Efficient timer observers with weak references

Code Quality

• Modular component design for reusability
• Consistent naming conventions
• Clear separation of concerns
• Comprehensive view modifiers

Files Modified

Views

• FloatingBreakWindow.swift - Header, skip button, divider enhancements
• OnboardingView.swift - FeatureItem, PermissionCard components
• SettingsView.swift - AboutView, SectionHeaderView, BreakStyleOptionCard, EnhancedSliderCard
• StatsView.swift - Section headers, chart styling, EnhancedStatBox
• MenuBarView.swift - ProfessionalButtonStyle, HoverEffectModifier

Managers

• StatusBarController.swift - Menu bar timer display with live countdown

Upgrade Notes

This is a UI-only update. No configuration changes are required:

• All your settings are preserved
• Statistics and history remain intact
• Timers continue to work as before

Simply update and enjoy the refreshed interface!

Known Issues

None reported.

Future Plans

• Additional theme customization options
• More animation refinements
• Accessibility improvements
• Localization support

---

Upgrade today for a cleaner, more professional EyeBreak experience!

Version Info

• Version: 2.3.0
• Build: 2025.12.06
• Release Date: December 6, 2025
• Compatibility: macOS 14.0 (Sonoma) or later
• Size: ~5 MB
• Language: English
• License: MIT (Open Source)

---

EyeBreak - Your Eyes Deserve a Break

🔒 EyeBreak v2.2.0 - Smart Pause & Unified Dashboard Update

🔒 EyeBreak v2.2.0 - Smart Pause & Unified Dashboard Update

Release Date: November 13, 2025

We're excited to announce EyeBreak v2.2.0, bringing intelligent screen lock detection, real-time countdown displays for all reminders, and enhanced user experience improvements!

🌟 What's New

🔒 Automatic Screen Lock Pause (NEW!)

Your timers now intelligently pause when your Mac screen locks!

Key Features:

• Auto-Pause on Lock: All timers (eye breaks, ambient reminders, water reminders) automatically pause when your screen locks
• Smart Resume: Timers automatically resume with the exact remaining time when you unlock your Mac
• Seamless Integration: Works with macOS sleep/wake and screen lock/unlock events
• No Manual Intervention: Everything happens automatically in the background
• Preserve Progress: Your countdown state is maintained across lock/unlock cycles

Why This Matters:

• ⏰ No more wasted break reminders while you're away from your desk
• 🎯 Accurate timing that respects your actual computer usage
• 💡 Intelligent behavior that feels natural and intuitive
• 🔋 Better battery life by pausing unnecessary timers

How It Works:

1. Lock your Mac (⌘+Ctrl+Q or close the lid)
2. All EyeBreak timers automatically pause
3. Unlock your Mac
4. Timers automatically resume from where they left off
5. No configuration needed - it just works!

⏱️ Unified Countdown Dashboard (NEW!)

See all your active timers at a glance with our beautiful new dashboard!

Features:

• All-in-One View: Eye breaks, ambient reminders, and water reminders displayed together
• Real-Time Countdowns: All timers update every second with accurate countdown displays
• Visual Status Indicators:
  • 🟢 Green dot = Active and running
  • 🟠 Orange dot = Paused (screen locked or outside work hours)
  • ⚪ Gray dot = Disabled
• Smart Status Messages: Clear text showing current state (Active, Paused, Disabled)
• Professional Design: Beautiful glass-morphism cards with gradients and animations
• Color-Coded: Each reminder type has its own color (Blue for eye breaks, Orange for ambient, Cyan for water)

What You'll See:

┌─────────────────────────────────────┐
│  👁️  Next Eye Break      19:14     │
│       • Working          remaining  │
├─────────────────────────────────────┤
│  ✨  Ambient Reminder     4:23     │
│       • Active           remaining  │
├─────────────────────────────────────┤
│  💧  Water Reminder      29:47     │
│       • Active           remaining  │
└─────────────────────────────────────┘

Location:

• Open EyeBreak Settings → General tab
• Dashboard appears at the top with all timer information
• Updates automatically every second
• Always visible for quick reference

Benefits:

• ✅ Know exactly when your next reminder will appear
• ✅ See all timers without switching tabs
• ✅ Understand timer status at a glance
• ✅ Professional, polished interface
• ✅ No more guessing if reminders are working

🎨 Enhanced Timer Management

Improved Countdown Accuracy:

• All timers now calculate remaining time using Date-based precision
• Countdown continues to display even when timers are paused
• Real-time updates ensure you always have accurate information
• No more static interval displays - everything is dynamic

Smart Pause Behavior:

• Screen lock pause preserves the target reminder time
• Resume intelligently calculates remaining duration
• If time has passed during lock, schedules next reminder immediately
• Seamless experience across all pause/resume scenarios

🔧 Technical Improvements

Architecture Enhancements

• Combine Framework Integration: Reactive countdown timers using modern Swift patterns
• Published Properties: Automatic UI updates through @Published state
• Date-Based Calculations: More accurate than timer-based countdowns
• Memory Efficient: Single shared timer per manager
• Screen Lock Detection: Uses DistributedNotificationCenter for system-wide events

Code Quality

• Clean Architecture: Well-organized manager classes with clear responsibilities
• Reactive Programming: State changes automatically propagate to UI
• Error Handling: Graceful handling of edge cases
• Type Safety: Full Swift type system benefits
• Documentation: Comprehensive code comments and documentation

🐛 Bug Fixes

• Fixed: Ambient reminder timer not showing accurate countdown
• Fixed: Water reminder timer displaying static intervals
• Fixed: Timers continuing to run when Mac screen is locked
• Fixed: Resume behavior after screen unlock not preserving state
• Improved: Countdown display formatting for consistency

📊 Performance Improvements

• Optimized countdown update frequency (1-second intervals)
• Reduced CPU usage during idle periods
• More efficient date calculations
• Better memory management with weak references
• Smoother UI animations and transitions

🎯 User Experience Enhancements

Better Visibility

• All timer information consolidated in one place
• Clear visual feedback on timer status
• Professional status indicators (dots + text)
• Real-time updates provide confidence timers are working

Smarter Behavior

• Automatic pause when you're not using your Mac
• No interruptions during screen lock
• Intelligent resume with preserved state
• Respects Smart Schedule and screen lock simultaneously

Professional Polish

• Beautiful animations and transitions
• Color-coded timer displays
• Consistent design language
• Accessible status messages

🚀 Getting Started

View the Unified Dashboard

1. Open EyeBreak Settings
2. Click on the General tab
3. See the "Active Timers" card at the top
4. Watch your countdowns update in real-time!

Understanding Status Indicators

• 🟢 Green + "Active" - Timer is running normally
• 🟠 Orange + "Paused (Screen locked)" - Mac is locked, timer paused
• 🟠 Orange + "Paused (Outside work hours)" - Smart Schedule is pausing
• ⚪ Gray + "Disabled" - Timer is turned off

No Setup Required

• Screen lock detection works automatically
• All timers pause and resume without configuration
• Just lock/unlock your Mac as normal
• EyeBreak handles everything intelligently

📝 Files Modified

Managers

• BreakTimerManager.swift - Added screen lock detection
• AmbientReminderManager.swift - Countdown tracking and pause logic
• WaterReminderManager.swift - Countdown tracking and pause logic

Views

• SettingsView.swift - New UnifiedCountdownCard component

New Components

• UnifiedCountdownCard - Main dashboard component
• CountdownRow - Reusable timer display row

🎓 How It Works

Screen Lock Detection

Mac Screen Locks
    ↓
System Event Detected
    ↓
All Timers Pause
    ↓
Preserve Target Times
    ↓
Mac Screen Unlocks
    ↓
Calculate Remaining Time
    ↓
Resume Timers Intelligently

Countdown System

Timer Scheduled
    ↓
Store Target Date
    ↓
Update Every Second
    ↓
Calculate Remaining = Target - Now
    ↓
Display in UI (MM:SS format)
    ↓
Repeat Until Timer Fires

🔮 Future Improvements

We're already planning the next updates:

• Statistics Dashboard: Track your break history with charts
• Break Activities: Interactive exercises during breaks
• Posture Reminders: Gentle reminders to adjust sitting position
• Custom Break Sounds: Upload your own notification sounds
• Focus Mode Integration: Better macOS Focus mode support

🙏 Acknowledgments

Thank you to our users for the feedback that inspired these features! Special thanks to those who requested:

• Automatic pause during screen lock
• Better visibility of timer countdowns
• All-in-one timer dashboard

📚 Documentation

For more information:

• Architecture: ARCHITECTURE.md
• Development: DEVELOPMENT.md
• Contributing: CONTRIBUTING.md

🐛 Found a Bug?

Please report issues on our GitHub Issues page.

💬 Feedback

We'd love to hear your thoughts! Share your feedback:

• GitHub Discussions
• Email: feedback@eyebreak.app
• Twitter: @eyebreakapp

---

Upgrade today and experience smarter, more intuitive eye care reminders! 🎉

Version Info

• Version: 2.2.0
• Build: 2025.11.13
• Release Date: November 13, 2025
• Compatibility: macOS 14.0 (Sonoma) or later
• Size: ~5 MB
• Language: English
• License: MIT (Open Source)

---

EyeBreak - Your Eyes Deserve a Break 👁️✨

💧 EyeBreak v2.1.0 - Health & Convenience Update

💧 EyeBreak v2.1.0 - Health & Productivity Update

Release Date: October 25, 2025

We're thrilled to announce EyeBreak v2.1.0, featuring Smart Schedule for work-life balance, comprehensive hydration reminders, auto-start convenience, and launch at login support for seamless daily use!

🌟 What's New

⏰ Smart Schedule System (NEW!)

Take control of when EyeBreak reminds you with intelligent work hours management!

• Customizable Work Hours: Set your working schedule (e.g., 9 AM - 5 PM)
• Active Days Selection: Choose which days to enable reminders (work days only, 24/7, or custom)
• 5 Quick Presets:
  • 🏢 Standard Work (9 AM - 5 PM, Mon-Fri)
  • 🌐 Flexible Hours (8 AM - 6 PM, Mon-Fri)
  • 🌅 Early Bird (7 AM - 3 PM, Mon-Fri)
  • 🌙 Night Owl (12 PM - 8 PM, Mon-Fri)
  • 🔄 24/7 Active (Always on, all days)
• Manual Override: Force show any reminder with "Show Anyway" option when outside work hours
• Real-Time Status: See if Smart Schedule is "Active" or "Paused" based on current time
• Professional Alerts: Get notified when trying to trigger reminders outside work hours

How It Works:

• When enabled, all reminders (eye breaks, ambient, water) respect your schedule
• During off-hours, automatic reminders are paused
• Manual triggers show a confirmation dialog with override option
• Perfect for maintaining work-life balance!

🚀 Auto-Start Timer (NEW!)

Never forget to start your eye care routine!

• Automatic Timer Start: EyeBreak timer starts automatically when app launches
• One-Click Toggle: Enable/disable in General Settings
• Smart Integration: Works seamlessly with Launch at Login
• 0.5s Delay: Gives app time to fully initialize before starting

How to Enable:

1. Open EyeBreak Settings → General
2. Toggle "Auto-Start Timer" ON
3. Next time EyeBreak launches, timer starts automatically!

🚀 Launch at Login

EyeBreak now starts automatically when you log into your Mac!

• One-Click Setup: Simply toggle in General Settings
• SMAppService Integration: Uses modern macOS 13+ technology
• Seamless Experience: EyeBreak ready when you need it
• Easy Control: Enable or disable anytime from settings
• No Manual Startup: Never forget to start your eye care routine

How to Enable:

1. Open EyeBreak Settings → General
2. Toggle "Launch at Login" ON
3. That's it! EyeBreak will start automatically on next login

💧 Complete Water Reminder System

Stay hydrated with our new intelligent water reminder feature that goes beyond simple notifications!

Two Display Styles:

1. Blur Screen Overlay 🌫️

   • Full-screen immersive reminder
   • Large animated water icon with glow effects
   • Manual acknowledgment - no auto-dismiss pressure
   • Single monitor display (shows on active screen only)

2. Ambient Pop-up 💧

   • Gentle floating window at top of screen
   • Glass morphism with theme colors
   • Auto-dismisses after 8 seconds
   • Perfect for quick, non-intrusive reminders

Smart Features:

• 8 Preset Messages with 16 professional water-themed SF Symbol icons
• Custom Messages & Icons: Create personalized reminders
• Full Theme Integration: Default, Random Color, or Custom themes
• Flexible Timing: 30 min, 45 min, 1 hour (recommended), 90 min, or 2 hours
• Sound Integration: Optional "Glass" sound effect

Keyboard Shortcuts & Access:

• ⌘⇧W - Show water reminder immediately
• Menu bar "Show Water Reminder" option
• "Test now" button in settings

🚀 Getting Started

Smart Schedule Setup:

1. Open EyeBreak Settings → Smart Schedule
2. Toggle "Smart Schedule" ON
3. Choose a preset or customize work hours
4. Select active days (e.g., Mon-Fri for weekdays only)
5. Watch real-time status indicator show "Active" or "Paused"

Auto-Start Timer Setup:

1. Open EyeBreak Settings → General
2. Toggle "Auto-Start Timer" ON
3. Timer automatically starts on next app launch!

Launch at Login Setup:

1. Open EyeBreak Settings → General
2. Toggle "Launch at Login" ON
3. EyeBreak starts automatically on next login!

Water Reminder Setup:

1. Open Settings → Breaks → Water Reminder
2. Toggle ON and select interval (recommended: 1 hour)
3. Choose style (Blur Screen or Ambient Pop-up)
4. Customize theme and messages (optional)
5. Test with ⌘⇧W keyboard shortcut
6. If Smart Schedule is enabled, reminders respect your work hours

⌨️ Keyboard Shortcuts

• ⌘⇧S - Start timer
• ⌘⇧X - Stop timer
• ⌘⇧B - Force break now (with Smart Schedule override option)
• ⌘⇧R - Show ambient reminder (with Smart Schedule override option)
• ⌘⇧W - Show water reminder (with Smart Schedule override option)

📦 Installation

Download EyeBreak-v2.1.0.dmg and drag to Applications folder. Your existing settings will be preserved when upgrading.

System Requirements: macOS 14.0+ (Universal Binary for Apple Silicon & Intel)

📝 What's Changed Since v2.0.0

Added ✨

Smart Schedule System:

• Work hours customization (start time, end time)
• Active days selection (Mon-Sun toggles)
• 5 quick preset schedules for common work patterns
• Real-time status indicator (Active/Paused)
• Professional alert dialogs for out-of-hours manual triggers
• "Show Anyway" override option for all reminders
• Applies to all features: Eye breaks, ambient reminders, and water reminders
• Settings persistence with @AppStorage

Auto-Start Timer:

• Automatic timer start on app launch
• One-click toggle in General Settings
• 0.5s initialization delay for smooth startup
• Perfect companion to Launch at Login feature

Launch at Login:

• SMAppService integration for modern macOS 13+ launch at login
• LaunchAtLoginManager singleton for state management
• One-click toggle in General Settings
• Automatic startup when you log into your Mac
• Easy enable/disable control

Water Reminder System:

• Complete water reminder with timer management
• Two display styles: Blur Screen and Ambient Pop-up
• 8 preset hydration messages + custom message support
• 16 professional water-themed SF Symbol icons
• 5 flexible timing intervals (30min - 2 hours)
• Full theme integration (Default, Random, Custom)
• Keyboard shortcut: ⌘⇧W for manual trigger
• Menu bar integration
• Sound effects with "Glass" tone

Changed 🔄

• Simplified display style options (removed redundant "Both" option)
• Enhanced settings UI organization with Smart Schedule section
• Improved keyboard shortcut documentation
• Better work-life balance with schedule-aware reminders
• More intuitive General Settings layout

Technical 🔧

• Smart Schedule computation with shouldShowBreaksNow property
• Time/day validation logic for schedule checking
• Alert system with manual override capabilities
• WaterReminderManager singleton
• WaterBlurOverlayView SwiftUI component
• LaunchAtLoginManager with SMAppService
• Auto-start timer with delayed initialization
• Enhanced multi-screen window management
• @AppStorage persistence for all settings including schedule preferences

🙏 Thank You

Thank you to our community for requesting these features! This release focuses on work-life balance, convenience, and holistic health during computer work. The Smart Schedule system ensures EyeBreak supports your productivity without interrupting your personal time.

🆚 Comparison: v2.0.0 → v2.1.0

Feature	v2.0.0	v2.1.0
Smart Schedule	❌	✅ NEW
Work Hours Management	❌	✅ NEW
Auto-Start Timer	❌	✅ NEW
Launch at Login	❌	✅ NEW
Eye Break Reminders	✅	✅ (Schedule-aware)
Ambient Reminders	✅	✅ (Schedule-aware)
Theme Customization	✅	✅
Water Reminders	❌	✅ NEW
Manual Override	❌	✅ NEW
Keyboard Shortcuts	3	5 (+⌘⇧W, improved)
Auto-Start on Login	Manual	Automatic

---

Full Changelog: v2.0.0...v2.1.0

Download: EyeBreak-v2.1.0.dmg

---

Stay hydrated, protect your eyes, work smarter, and maintain work-life balance with EyeBreak v2.1.0! 💧👁️⏰✨

EyeBreak v2.0.0 - Initial Release

🎨 EyeBreak v2.0.0 - Theme Customization Release

Release Date: October 8, 2025

We're excited to announce EyeBreak v2.0.0, a major update that brings powerful theme customization capabilities to your eye care experience!

🌟 What's New

🎨 Complete Theme Customization System

Transform the look and feel of your break reminders and overlays with our new theme system!

Three Theme Options:

1. Default Theme 🎨

   • Classic vibrant style with rich colors
   • The familiar EyeBreak experience you know and love
   • Perfect for those who like the original design

2. Random Color Theme 🎲 ✨

   • Surprise yourself with fresh colors every time!
   • 20 curated color palettes that always look beautiful
   • New colors each break/reminder, stable during display
   • Includes: Ocean, Sunset, Forest, Berry, Coral, Lavender, Mint, Rose, Sky, Amber, Teal, Crimson, Sage, Indigo, Peach, Turquoise, Plum, Lime, Burgundy, and Slate

3. Custom Theme 🛠️

   • Complete control over every color aspect
   • Customize background, accent, text, and secondary text colors
   • Adjust opacity levels for all elements
   • Fine-tune glass blur and highlight effects
   • Quick preset palettes for inspiration (Ocean Blue, Forest Green, Sunset Orange, Royal Purple)

Theme Controls:

• Independent Themes: Set different themes for Ambient Reminders and Break Overlays
• Live Preview: See your changes in real-time before applying
• Persistent Settings: Your theme preferences are saved and remembered
• Smart Caching: Random colors stay consistent during each session

🎯 Enhanced Ambient Reminder Customization

Professional Icon System:

• Replaced emoji input with curated SF Symbols
• 16 beautiful icons to choose from:
  • 👁️ Eye symbols (eye, eye.fill)
  • ✨ Sparkles and stars
  • 💖 Heart symbols
  • 🌿 Nature icons (drop, leaf)
  • 🌙 Celestial (moon, sun)
  • ⏰ Time indicators (clock, bell)
  • 🧘 Wellness icons (hand, figure, lungs, headphones, cup)
• Clear visual selection with purple highlights
• Professional appearance across all themes

Custom Messages:

• Personalize reminder text alongside icons
• Support for any custom message you want
• Works seamlessly with all three theme options

🔧 Technical Improvements

Code Quality:

• Cleaner Architecture: Simplified theme rendering logic
• Better Maintainability: Removed complex conditional checks
• Type-Safe: Full Swift enum support with no magic strings
• Performance: Optimized rendering with smart caching

Bug Fixes:

• Fixed theme flickering during display
• Resolved color inconsistency issues
• Improved theme switching stability
• Enhanced multi-screen support for themes

📸 Screenshots

(See the /assets/screenshots folder for visual examples of all three themes)

🚀 Getting Started with Themes

1. Open EyeBreak Settings

   • Click the menu bar icon
   • Select "Settings..."

2. Navigate to Color Themes

   • Scroll to the "Color Themes" section
   • Choose your theme type for Ambient Reminders and/or Break Overlay

3. Customize (Optional)

   • For Custom theme: Use the color pickers and sliders
   • Try Quick Presets for instant professional looks
   • Adjust opacity, blur, and highlight effects

4. Enjoy Your Personalized Experience!

   • Your settings are saved automatically
   • Changes apply immediately

🎯 Use Cases

For Minimalists:

Use the Default Theme with subtle colors that blend into your workflow.

For Variety Seekers:

Enable Random Color Theme to get a fresh, beautiful palette with every break.

For Power Users:

Create your perfect Custom Theme matching your desktop wallpaper, brand colors, or personal preferences.

📦 Installation

New Users:

1. Download EyeBreak-v2.0.0.dmg from the releases page
2. Open the DMG file
3. Drag EyeBreak.app to your Applications folder
4. Launch EyeBreak from Applications
5. Follow the onboarding guide

Upgrading from v1.0.0:

1. Download EyeBreak-v2.0.0.dmg
2. Quit the running EyeBreak app
3. Replace the old EyeBreak.app in Applications with the new one
4. Launch the new version
5. Your settings will be preserved!
6. New theme options will be available in Settings

🛠️ System Requirements

• macOS: 14.0 (Sonoma) or later
• Architecture: Universal Binary (Apple Silicon & Intel)
• Permissions: Accessibility (for idle detection)
• Display: Works on all screen sizes and multi-monitor setups

📝 What's Changed Since v1.0.0

Added ✨

• Complete color theme customization system
• 20 curated random color palettes
• Custom theme editor with full control
• Quick preset palettes (4 options)
• Professional SF Symbol icon picker for reminders
• Theme caching for consistent display
• Independent theme settings for reminders and overlays
• Live theme preview in settings

Changed 🔄

• Replaced emoji input with SF Symbol picker
• Simplified theme rendering architecture
• Improved settings UI organization
• Enhanced theme switching performance

Fixed 🐛

• Theme flickering during active display
• Color inconsistency between renders
• Complex conditional rendering issues
• Theme persistence across app restarts

Removed 🗑️

• Old "Liquid Glass" theme (replaced with Random Color)
• Emoji text input (replaced with icon picker)
• Redundant multi-layer glass effects

🙏 Thank You

Thank you to all our users for your feedback and support! This release was inspired by your requests for more customization options.

📞 Support & Feedback

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: See /docs folder for detailed guides

🔮 Coming Soon

We're already working on v2.1.0 with:

• Export/Import theme presets
• Community theme sharing
• Animated theme transitions
• Gradient customization tools
• Theme marketplace

Stay tuned!

---

Full Changelog: v1.0.0...v2.0.0

Download: EyeBreak-v2.0.0.dmg

EyeBreak v1.0.0 - Initial Release

👁️ EyeBreak v1.0.0 - Your Eyes Deserve a Break

A minimalistic macOS menu bar app that helps reduce digital eye strain by following the 20-20-20 rule.

---

📥 Installation (3 Easy Steps)

1. Download EyeBreak-v1.0.0.dmg from Assets below ⬇️
2. Open the DMG file and drag the app to Applications folder
3. Right-click the app → Select "Open" → Click "Open" again

That's it! Look for the 👁️ icon in your menu bar!

Why right-click? macOS requires this for unsigned apps on first launch only.

---

✨ What's Included

• 🎯 Menu Bar Integration - Quiet and unobtrusive
• ⏰ Smart 20-20-20 Timer - Scientifically-backed eye care
• 🌫️ Screen Blur - Gentle break enforcement (optional)
• 🔔 Break Notifications - 30-second warnings
• 😴 Auto Idle Detection - Pauses when you're away
• 📊 Daily Statistics - Track your eye health habits
• 🍅 Pomodoro Mode - 25/5 work/break cycles
• 🔒 100% Private - Zero data collection, works offline

---

🔐 Required Permissions

EyeBreak will request:

1. Notifications (Recommended)

   • For break reminders
   • Enable in: System Settings → Notifications → EyeBreak

2. Screen Recording (Optional, for Blur Mode)

   • Enables screen blur during breaks
   • Enable in: System Settings → Privacy & Security → Screen Recording
   • Without this, app uses "Notification Only" mode

---

📚 Documentation

• 📖 Quick Start Guide
• ❓ FAQ
• 🏗️ Architecture
• 🐛 Report Issues

---

📋 System Requirements

• macOS: 14.0 (Sonoma) or later
• Architecture: Apple Silicon (M1/M2/M3) or Intel
• Storage: ~3 MB
• RAM: Minimal (~20 MB)

---

🚀 Quick Start

1. Look for the eye icon 👁️ in your menu bar (top-right)
2. Click it and select "Start Timer"
3. Work for 20 minutes
4. Take a 20-second break when prompted
5. Your eyes will thank you! 😊

---

🙏 Support

• 🐛 Report a Bug
• 💡 Request a Feature
• 📧 Email: chansocheatsok2001@gmail.com

---

📜 License

MIT License - Free and open source

---

Remember: Every 20 minutes, look 20 feet away for 20 seconds! 👁️✨

---

Full Changelog: https://github.com/cheat2001/eyebreak/blob/main/CHANGELOG.md