solisoft · solisoft · Aug 23, 2026 · Aug 23, 2026 · Aug 23, 2026
diff --git a/docs/tui-screenshots/01-dashboard.png b/docs/tui-screenshots/01-dashboard.png
diff --git a/docs/tui-screenshots/02-routes.png b/docs/tui-screenshots/02-routes.png
diff --git a/docs/tui-screenshots/03-apps.png b/docs/tui-screenshots/03-apps.png
diff --git a/docs/tui-screenshots/04-circuits.png b/docs/tui-screenshots/04-circuits.png
diff --git a/docs/tui-screenshots/05-errors.png b/docs/tui-screenshots/05-errors.png
diff --git a/docs/tui-screenshots/06-config.png b/docs/tui-screenshots/06-config.png
diff --git a/docs/tui-screenshots/07-help.png b/docs/tui-screenshots/07-help.png
diff --git a/docs/tui-screenshots/README.md b/docs/tui-screenshots/README.md
@@ -0,0 +1,23 @@
+# TUI screenshots
+
+**These images are mockups, not captures.** They are drawn by
+`scripts/tui_screenshots.py` with representative sample data, because the real
+TUI needs a live daemon, a terminal and an admin password to render anything.
+
+The layout, palette and key hints are mirrored from the source by hand:
+
+| Image element                  | Source of truth            |
+| ------------------------------ | -------------------------- |
+| palette, sidebar, panel chrome | `src/tui/theme.rs`         |
+| screen composition             | `src/tui/screens/*.rs`     |
+| footer hints, help overlay     | `src/tui/app.rs`           |
+
+If you change any of those, re-run the script and compare the result against the
+real TUI:
+
+```sh
+python3 scripts/tui_screenshots.py   # needs Pillow
+```
+
+A mockup that has drifted from the shipped UI is worse than no mockup — if you
+cannot keep these current, delete them rather than leaving them stale.