Skip to content

BuenMouse v1.1.1 - Critical Bug Fixes

Choose a tag to compare

@StevenACZ StevenACZ released this 02 Oct 05:42
· 78 commits to main since this release

🐛 BuenMouse v1.1.1 - Critical Bug Fixes

This patch release resolves two critical bugs affecting window management and UI performance.


🔧 Bug Fixes

Window Frozen After Login - RESOLVED ✅

Fixed critical issue where the settings window would not open when clicking the menu bar icon after macOS startup with "Launch at Login" enabled.

What was broken:

  • Window appeared unresponsive after automatic startup at login
  • Menu bar icon click did nothing
  • Gesture functionality continued to work normally

What was fixed:

  • Eliminated nested async dispatches causing race conditions
  • Simplified window initialization flow
  • Enhanced showWindow() with orderFrontRegardless() for reliable visibility
  • Added window state verification and detailed logging
  • Removed unreliable 0.2s delay in favor of direct initialization

Files changed: AppDelegate.swift, BuenMouseApp.swift


Tab Navigation Freeze - RESOLVED ✅

Fixed UI freeze when navigating from About → Settings tab.

What was broken:

  • App would freeze/hang when switching from About back to Settings
  • Multiple menu items being created on every tab switch
  • Memory leaks from duplicate coordinators

What was fixed:

  • Replaced .onAppear with .task(id:) for single-execution setup
  • Added menu existence check to prevent duplicates
  • Simplified keyboard shortcuts setup with @MainActor
  • Eliminated unnecessary state flags

Files changed: Views/ContentView.swift


Performance Improvement - Tab Navigation Lag Eliminated ⚡

Removed perceptible 1ms lag when switching to Settings tab.

What was improved:

  • .task(id:) executes only once vs .onAppear on every tab change
  • Reduced async overhead
  • Cleaner code with fewer state variables

📊 Technical Details

Commits

  • 52056fd - perf: eliminate tab navigation lag with .task instead of .onAppear
  • 965bdca - fix: resolve window frozen at startup and tab navigation freeze
  • 58f59eb - fix: correct OSLogType from .warning to .error

Files Modified

  • AppDelegate.swift - Window management improvements
  • BuenMouseApp.swift - Simplified window assignment
  • Views/ContentView.swift - Performance and freeze fixes

📥 Installation

Download

Download BuenMouse-v1.1.1.dmg below

Upgrade from v1.1.0

Simply install over your existing version - all settings will be preserved.


🎯 Testing Done

  • ✅ Window opens correctly after login startup
  • ✅ Menu bar click works reliably in all scenarios
  • ✅ Tab navigation smooth without freezing
  • ✅ No lag when switching between tabs
  • ✅ All gesture functionality intact
  • ✅ Settings persistence working

🔄 Upgrading

This is a patch release with critical bug fixes:

  • ✅ Safe Upgrade - Install directly over v1.1.0
  • ✅ No Breaking Changes - All features work as before
  • ✅ Settings Preserved - Your configuration is maintained

📋 Known Issues

None at this time. Report issues at: https://github.com/StevenACZ/BuenMouse/issues


🙏 Thanks

Special thanks to users who reported these critical bugs. Your feedback helps make BuenMouse better!


Full Changelog: v1.1.0...v1.1.1