diff --git a/shell.qml b/shell.qml
index 942de68..8c9995b 100644
--- a/shell.qml
+++ b/shell.qml
@@ -1,4 +1,7 @@
 //@ pragma UseQApplication
+// Required: Quickshell renders the system-tray context menu (right-click in
+// Tray.qml -> item.display()) via QtWidgets' QMenu. Dropping this loads the
+// lighter QGuiApplication but breaks tray menus. Verified 2026-06-08.
 
 import Quickshell
 import "widgets"