Skip to content

Conversation

@ammar-agent
Copy link
Collaborator

Problem

ERR_FAILED (-2) loading splash.html from ASAR intermittently on macOS dock reactivation because:

  • macOS App Nap throttles idle apps
  • File descriptors to ASAR archive may be reclaimed after inactivity
  • The activate event fires before I/O is fully responsive

Solution

Skip the splash screen on reactivation. Services are already loaded from initial launch, so window creation is fast (~100ms). The splash exists to cover heavy initialization—unnecessary on reactivation.

-20 LoC, +2 LoC (net: -18)

Alternatives Considered

Option Tradeoff
Retry with backoff Adds complexity, user still sees delay on failure
Disable App Nap System-wide side effects, not recommended
Inline splash HTML as data URL Avoids file I/O but complicates build

Generated with mux

ERR_FAILED (-2) loading splash.html from ASAR intermittently on
macOS dock reactivation because:
- macOS App Nap throttles idle apps
- File descriptors to ASAR archive may be reclaimed after inactivity
- The activate event fires before I/O is fully responsive

Fix: Skip the splash screen on reactivation. Services are already
loaded from initial launch, so window creation is fast (~100ms).
The splash exists to cover heavy initialization—unnecessary on
reactivation.

_Generated with mux_
@chatgpt-codex-connector
Copy link

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Repo admins can enable using credits for code reviews in their settings.

@ammario ammario merged commit 7b5421c into main Dec 2, 2025
13 checks passed
@ammario ammario deleted the fix-macos-reactivation-splash-error branch December 2, 2025 18:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants