From 2bea5d80b529c2551b8871a546682bd53344f927 Mon Sep 17 00:00:00 2001
From: damocles <damocles@hyperhive>
Date: Sat, 30 May 2026 14:59:24 +0200
Subject: [PATCH] matrix: reword gui.enable description, use literalMD for
 package defaultText (argus #635 nits)

---
 nix/modules/hive-matrix.nix | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/nix/modules/hive-matrix.nix b/nix/modules/hive-matrix.nix
index fc9087b5..3c17d271 100644
--- a/nix/modules/hive-matrix.nix
+++ b/nix/modules/hive-matrix.nix
@@ -162,20 +162,22 @@ in
         default = cfg.enable;
         defaultText = lib.literalExpression "config.services.hyperhive.matrix.enable";
         description = ''
-          Mount a matrix web client (default `pkgs.fluffychat-web`) as
-          a static sibling of the dashboard at `/matrix/`, served by
-          hive-c0re's own axum router via the `HIVE_MATRIX_GUI_DIR`
-          env var (#607). Defaults to whatever
+          Serve a matrix web client (default `pkgs.fluffychat-web`) as
+          a static dist at `/matrix/` via the hive-gateway nginx
+          (#607 / #634). Defaults to whatever
           `services.hyperhive.matrix.enable` is — turning on the
           homeserver gives you the web client by default; set to
           `false` explicitly to opt out of the GUI while keeping
-          the homeserver running for agents.
+          the homeserver running for agents. Requires
+          `services.hyperhive.gateway.enable` (default on); when
+          gateway is off no one hosts the GUI and the
+          `M4TR1X →` dashboard tab is hidden.
 
-          Same-origin via hive-c0re is the simplest single-host
-          shape; the post-#15 nginx-front re-root (`https://matrix.''${services.hyperhive.domain}`)
-          is tracked separately in #609. fluffychat-web supports
-          per-login server pick — point it at the in-host tuwunel URL
-          (`http://localhost:8008` by default) the first time.
+          fluffychat-web supports per-login server pick — point it at
+          the in-host tuwunel URL (`http://localhost:8008` by
+          default) the first time. The post-#15 nginx-front re-root
+          (`https://matrix.''${services.hyperhive.domain}`) is tracked
+          separately in #609.
         '';
       };
 
@@ -198,7 +200,7 @@ in
             "/matrix/"
           ];
         });
-        defaultText = lib.literalExpression "pkgs.fluffychat-web with --base-href /matrix/";
+        defaultText = lib.literalMD "`pkgs.fluffychat-web` rebuilt with `--base-href /matrix/` via `targetFlags`.";
         description = ''
           Static web client dist to serve at `/matrix/`. Defaults to
           `pkgs.fluffychat-web` rebuilt with `--base-href "/matrix/"`