Skip to content

fix(ui): disable hardware acceleration to prevent black window#76

Merged
dbfx merged 1 commit intomainfrom
dbfx/fix-black-window
Mar 25, 2026
Merged

fix(ui): disable hardware acceleration to prevent black window#76
dbfx merged 1 commit intomainfrom
dbfx/fix-black-window

Conversation

@dbfx
Copy link
Contributor

@dbfx dbfx commented Mar 25, 2026

What does this PR do?

Disables Chromium hardware acceleration unconditionally and fixes the ErrorBoundary to use hardcoded fallback colors instead of CSS variables.

Why?

Users report a persistent black window they can resize but never see content in. This is a well-known Electron issue on machines with incompatible GPU drivers, broken ANGLE backends, or VM setups — the GPU compositor silently fails and only the window's background color (#09090b) shows. Since Kudu is a system-cleaner utility, software compositing has negligible visual trade-off. The ErrorBoundary fix ensures error messages are visible even when stylesheets fail to load (previously black-on-black).

How to test

  1. Build and launch the app — verify the UI renders normally
  2. If possible, test in a VM or on a machine with known GPU issues — confirm the black window is gone
  3. Trigger an intentional render error (e.g., throw in a component) — verify the ErrorBoundary text is visible

Checklist

  • Tested on my platform (Windows / macOS / Linux)
  • npm test passes
  • npm run build succeeds
  • Commit messages follow Conventional Commits

…ompatible GPUs

On machines with incompatible GPU drivers, broken ANGLE, or VM setups,
Chromium's GPU compositor silently fails — resulting in a black window
the user can resize but never see content in. Disable hardware
acceleration unconditionally since this is a system-cleaner utility
where software compositing is perfectly adequate.

Also fix the ErrorBoundary to use hardcoded fallback colors instead of
CSS variables, so error messages remain visible even when stylesheets
fail to load.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dbfx dbfx merged commit 4361b60 into main Mar 25, 2026
8 checks passed
@dbfx dbfx deleted the dbfx/fix-black-window branch March 25, 2026 08:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant