From 8799b6323a2e8442b3e608de5c6ddf8a09d38ce1 Mon Sep 17 00:00:00 2001
From: Rae McKelvey <633012+okdistribute@users.noreply.github.com>
Date: Mon, 23 Mar 2026 16:01:13 -0700
Subject: [PATCH] experiment with the collapsed view

---
 deployment/metrics.mdx   |   2 +-
 docs.json                | 106 ++++++++++++++++++---------------------
 iroh-services/access.mdx |   2 +-
 iroh-services/index.mdx  |   4 +-
 4 files changed, 55 insertions(+), 59 deletions(-)

diff --git a/deployment/metrics.mdx b/deployment/metrics.mdx
index 2032870..22b4cff 100644
--- a/deployment/metrics.mdx
+++ b/deployment/metrics.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Metrics"
+title: "Custom Metrics"
 ---
 
 iroh provides support for collecting metrics about your application's
diff --git a/docs.json b/docs.json
index 7315008..263bf38 100644
--- a/docs.json
+++ b/docs.json
@@ -1,6 +1,6 @@
 {
   "$schema": "https://mintlify.com/docs.json",
-  "theme": "mint",
+  "theme": "aspen",
   "name": "iroh",
   "colors": {
     "primary": "#8790ff",
@@ -9,32 +9,28 @@
   },
   "favicon": "/favicon.ico",
   "navigation": {
-    "tabs": [
+    "groups": [
       {
-        "tab": "Rust Library",
-        "groups": [
+        "group": " ",
+        "pages": [
+          "what-is-iroh",
+          "quickstart",
+          "examples/examples",
           {
-            "group": "Getting Started",
+            "group": "How it works",
+            "expanded": false,
             "pages": [
-              "what-is-iroh",
-              "quickstart",
-              "examples/examples",
-              {
-                "group": "How it works",
-                "expanded": true,
-                "pages": [
-                  "concepts/endpoints",
-                  "concepts/tickets",
-                  "concepts/discovery",
-                  "concepts/relays",
-                  "concepts/nat-traversal",
-                  "concepts/protocols"
-                ]
-              }
+              "concepts/endpoints",
+              "concepts/tickets",
+              "concepts/discovery",
+              "concepts/relays",
+              "concepts/nat-traversal",
+              "concepts/protocols"
             ]
           },
           {
             "group": "Creating Connections",
+            "expanded": false,
             "pages": [
               "connecting/creating-endpoint",
               "connecting/custom-relays",
@@ -47,6 +43,7 @@
           },
           {
             "group": "Sending Data",
+            "expanded": false,
             "pages": [
               "protocols/kv-crdts",
               "protocols/blobs",
@@ -60,6 +57,7 @@
           },
           {
             "group": "Transports",
+            "expanded": false,
             "pages": [
               "transports/tor",
               "transports/nym",
@@ -68,63 +66,58 @@
           },
           {
             "group": "Deployment",
+            "expanded": false,
             "pages": [
               "deployment/dedicated-infrastructure",
-              "deployment/metrics",
-              "deployment/security-privacy",
               "deployment/troubleshooting",
-              "deployment/other-languages"
-            ]
-          },
-          {
-            "group": "About",
-            "pages": ["about/changelog", "about/roadmap", "about/faq"]
-          }
-        ]
-      },
-      {
-        "tab": "Iroh Services",
-        "groups": [
-          {
-            "group": "Getting Started",
-            "pages": [
-              "iroh-services/index",
-              "iroh-services/quickstart",
-              "iroh-services/projects",
-              "iroh-services/access",
-              "iroh-services/support"
+              "deployment/other-languages",
+              "iroh-services/relays/public",
+              "iroh-services/relays/managed"
             ]
           },
           {
             "group": "Metrics",
+            "expanded": false,
             "pages": [
               "iroh-services/metrics/index",
+              "iroh-services/quickstart",
+              "iroh-services/access",
               "iroh-services/metrics/how-it-works",
               "iroh-services/metrics/endpoint",
-              "iroh-services/metrics/glossary"
+              "iroh-services/metrics/glossary",
+              "deployment/metrics"
             ]
           },
           {
-            "group": "Relays",
+            "group": "Network Diagnostics",
+            "expanded": false,
             "pages": [
-              "iroh-services/relays/index",
-              "iroh-services/relays/public",
-              "iroh-services/relays/managed"
+              "iroh-services/net-diagnostics/quickstart",
+              "iroh-services/net-diagnostics/usage",
+              "iroh-services/net-diagnostics/reports"
             ]
           },
           {
-            "group": "Net Diagnostics",
-            "pages": ["iroh-services/net-diagnostics/quickstart", "iroh-services/net-diagnostics/usage", "iroh-services/net-diagnostics/reports"]
-          },
-          {
-            "group": "Billing",
+            "group": "Pricing",
+            "expanded": false,
             "pages": [
               "iroh-services/billing/index",
               "iroh-services/billing/manage-subscription",
               "iroh-services/billing/control-costs",
               "iroh-services/billing/faq"
             ]
-          }
+          },
+          {
+            "group": "About",
+            "expanded": false,
+            "pages": [
+              "about/changelog",
+              "about/roadmap",
+              "deployment/security-privacy",
+              "about/faq"
+            ]
+          },
+          "iroh-services/support"
         ]
       }
     ]
@@ -144,7 +137,6 @@
         "href": "https://iroh.computer/blog"
       }
     ],
-
     "primary": {
       "type": "button",
       "label": "Login",
@@ -160,7 +152,9 @@
     }
   },
   "integrations": {
-    "plausible": { "domain": "docs.iroh.computer" }
+    "plausible": {
+      "domain": "docs.iroh.computer"
+    }
   },
   "redirects": [
     {
@@ -168,4 +162,4 @@
       "destination": "/concepts/nat-traversal"
     }
   ]
-}
+}
\ No newline at end of file
diff --git a/iroh-services/access.mdx b/iroh-services/access.mdx
index 46723d0..e2a2914 100644
--- a/iroh-services/access.mdx
+++ b/iroh-services/access.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Access Control"
+title: "API Keys & Access Control"
 description: "Manage authorization and API keys for your Iroh Services project"
 ---
 
diff --git a/iroh-services/index.mdx b/iroh-services/index.mdx
index 4b09483..2316c96 100644
--- a/iroh-services/index.mdx
+++ b/iroh-services/index.mdx
@@ -5,10 +5,12 @@ description: "Iroh Services is a web platform for managing and monitoring iroh i
 
 ### Hello fren,
 
+##### Your Iroh Services project is an always-online service that helps keep your devices connected, available, and accessible globally.
+
 The first time you sign up for an account on Iroh Services, you are asked to create a
 **project**.  A project is your control & monitoring center for your network.
 You can provision relays, monitor metrics, create alerts, run simulations, and
-manage workflows. 
+manage workflows.
 
 ## Get Started