windows-internals

The one-byte dark mode: AppsUseLightTheme, honestly

Personalization in Windows is a handful of documented HKCU values — not a theme engine. What the dark-mode key does, which apps listen, and which ignore it.

ProofTune Project··4 min read
Windows internals illustration Windows internals

The value

HKCU\Software\Microsoft\Windows\CurrentVersion\Themes\PersonalizeAppsUseLightTheme (DWORD): 1 = apps default light, 0 = dark. Its sibling SystemUsesLightTheme drives the shell's own surfaces (taskbar, Start), so the two can diverge deliberately.

Who listens

  • WinUI 3 / UWP / Win32 apps using the Modern.Xaml theming stack pick it up at the next theme-invalidated repaint.
  • WinForms and older GDI apps keep whatever colors the developer painted — they were never subscribed.
  • Browsers often re-read it on a fresh navigation, not on the flip — F5 answers “but nothing changed.”

The value is per-user, free of side effects, and instant-revertible — a model citizen of per-account tuning.

Where it fits

Dark/light is the tamest tweak in the catalog: a personal value whose restore is literally rewriting the remembered default. It's part of why the visual preset's undo is exact rather than approximate.

ProofTune ProjectEngineering notes — every claim here names the bytes a real tool touches. Verify first, install second.
ProofTune logo

See these exact settings inside the real tool

The browser replica runs the same strings and states as the installed app — click around before you ever install anything.