From 3a98bc08e9cb567cce6a8a1c06b712a29d79a150 Mon Sep 17 00:00:00 2001
From: Asmir A <asmir.abdulahovic@gmail.com>
Date: Wed, 10 Jun 2026 21:42:03 +0200
Subject: [PATCH] shell: document why UseQApplication is required

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 shell.qml | 3 +++
 1 file changed, 3 insertions(+)

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"