From a3e0f016e7a5c2b942892b6f16ea252683fa2da0 Mon Sep 17 00:00:00 2001
From: Jay Looney <jay.m.looney@gmail.com>
Date: Tue, 17 Jun 2025 17:45:22 -0500
Subject: [PATCH] docs: improve diagram

---
 README.md | 32 +++++++++++++++++++++++++++++---
 1 file changed, 29 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index a224b0d..2ec089f 100644
--- a/README.md
+++ b/README.md
@@ -14,14 +14,40 @@ It's designed to be **secure, composable, and automated** using modern Nix tooli
 - Secrets managed via `sops-nix`
 - Deployable with `nixos-rebuild` (and soon `deploy-rs` or `nixos-anywhere`)
 
+
 ```mermaid
+---
+title: How it all fits together
+---
 graph TD
+    subgraph Entrypoint
+        flake
+        mkSystem
+    end
+    subgraph System Configuration
+        hosts
+        hosts_conf
+        hosts_hardware
+    end
+    subgraph User Configuration
+        users_default
+        users_home
+    end
+    subgraph Shared Modules
+      nixos_mods
+      home_mods
+    end
     flake["flake.nix"] --> mkSystem["lib/mkSystem"]
+    
     mkSystem --> hosts["hosts/{hostname}/default.nix"]
     mkSystem --> users_default["users/{username}/default.nix"]
-    mkSystem -.->|if user home-manager| users_home["users/{username}/home.nix"]
-    hosts --> nixosMods@{ shape: docs, label: "modules/nixos/*"}
-    users_home --> homeMods@{ shape: docs, label: "modules/home/*"}
+    mkSystem -.->|if file exists| users_home["users/{username}/home.nix"]
+    
+    hosts --> nixos_mods@{ shape: docs, label: "modules/nixos/*"}
+    hosts --> hosts_conf["configuration.nix"]
+    hosts --> hosts_hardware["hardware.nix"]
+    
+    users_home --> home_mods@{ shape: docs, label: "modules/home/*"}
 ```
 
 ## How to use this? (Deployment)