From 4b05dc2f41795618ed84f032a219c3cf5fd5cd17 Mon Sep 17 00:00:00 2001
From: Jack Kingsman <jack.kingsman@gmail.com>
Date: Mon, 2 Mar 2026 11:41:25 -0800
Subject: [PATCH] Add clearer MQTT topics and payload shapes

---
 .../settings/SettingsMqttSection.tsx          | 22 ++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/frontend/src/components/settings/SettingsMqttSection.tsx b/frontend/src/components/settings/SettingsMqttSection.tsx
index 0d63bda..174fe1c 100644
--- a/frontend/src/components/settings/SettingsMqttSection.tsx
+++ b/frontend/src/components/settings/SettingsMqttSection.tsx
@@ -173,11 +173,23 @@ export function SettingsMqttSection({
           value={mqttTopicPrefix}
           onChange={(e) => setMqttTopicPrefix(e.target.value)}
         />
-        <p className="text-xs text-muted-foreground">
-          Topics: {mqttTopicPrefix || 'meshcore'}/dm:&lt;key&gt;, {mqttTopicPrefix || 'meshcore'}
-          /gm:&lt;key&gt;, {mqttTopicPrefix || 'meshcore'}
-          /raw/...
-        </p>
+        <div className="text-xs text-muted-foreground space-y-2">
+          <div>
+            <p className="font-medium">Decrypted messages <span className="font-mono font-normal opacity-75">{'{'}id, type, conversation_key, text, sender_timestamp, received_at, paths, outgoing, acked{'}'}</span></p>
+            <div className="font-mono ml-2 space-y-0.5">
+              <div>{mqttTopicPrefix || 'meshcore'}/dm:&lt;contact_key&gt;</div>
+              <div>{mqttTopicPrefix || 'meshcore'}/gm:&lt;channel_key&gt;</div>
+            </div>
+          </div>
+          <div>
+            <p className="font-medium">Raw packets <span className="font-mono font-normal opacity-75">{'{'}id, observation_id, timestamp, data, payload_type, snr, rssi, decrypted, decrypted_info{'}'}</span></p>
+            <div className="font-mono ml-2 space-y-0.5">
+              <div>{mqttTopicPrefix || 'meshcore'}/raw/dm:&lt;contact_key&gt;</div>
+              <div>{mqttTopicPrefix || 'meshcore'}/raw/gm:&lt;channel_key&gt;</div>
+              <div>{mqttTopicPrefix || 'meshcore'}/raw/unrouted</div>
+            </div>
+          </div>
+        </div>
       </div>
 
       <Separator />