Skip to content

RELEASE_NOTES_v2.0.0.md

Latest commit

 

History

History
188 lines (138 loc) · 6.14 KB

RELEASE_NOTES_v2.0.0.md

File metadata and controls

188 lines (138 loc) · 6.14 KB

🎨 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

🔮 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