ThinkWatchProject · fylorn · Sep 30, 2026 · Sep 30, 2026
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -12,6 +12,25 @@ pre-fills a new PR's base with the repo's default branch, which is
 opened against `main`, click *Edit* next to the PR title and change the
 base — the commits and the discussion carry over. A bot will remind you.
 
+## Layout
+
+```
+src/              React 19 + Tailwind 4 interface
+src-tauri/        Tauri 2 shell: supervises the local core, connects to a
+                  local or remote core, draws the menu bar item and the tray
+                  menu, sends system notifications, installs updates
+src-tauri/crates/ tw-adopt (pointing clients at the gateway, MCP configuration)
+                  and tw-scan (scanning client configuration)
+scripts/shots/    the product screenshot pipeline (see CONTRIBUTING.md)
+```
+
+The gateway itself lives in ThinkWatch Core; this repository holds no routing,
+forwarding, or accounting logic. The app reaches core's control channel over a
+unix socket on macOS and Linux and over a loopback port on Windows, or over a
+TCP port when core runs on a server. Every connection begins with an encrypted
+handshake (Noise `NNpsk0`) keyed with the control key from core's
+configuration (`listen.control.key`); no TLS certificates are involved.
+
 ## Scope, so you don't build something that gets declined
 
 These decisions are settled and not up for a PR:

diff --git a/README.md b/README.md
diff --git a/README.zh-CN.md b/README.zh-CN.md
diff --git a/docs/screenshots/en/clients-dark.png b/docs/screenshots/en/clients-dark.png
diff --git a/docs/screenshots/en/clients-light.png b/docs/screenshots/en/clients-light.png
diff --git a/docs/screenshots/en/dry-run-dark.png b/docs/screenshots/en/dry-run-dark.png
diff --git a/docs/screenshots/en/dry-run-light.png b/docs/screenshots/en/dry-run-light.png
diff --git a/docs/screenshots/en/keys-dark.png b/docs/screenshots/en/keys-dark.png
diff --git a/docs/screenshots/en/keys-light.png b/docs/screenshots/en/keys-light.png
diff --git a/docs/screenshots/en/menubar-menu-dark.png b/docs/screenshots/en/menubar-menu-dark.png
diff --git a/docs/screenshots/en/menubar-menu-light.png b/docs/screenshots/en/menubar-menu-light.png
diff --git a/docs/screenshots/en/overview-dark.png b/docs/screenshots/en/overview-dark.png
diff --git a/docs/screenshots/en/overview-light.png b/docs/screenshots/en/overview-light.png
diff --git a/docs/screenshots/en/remote-add-dark.png b/docs/screenshots/en/remote-add-dark.png
diff --git a/docs/screenshots/en/remote-add-light.png b/docs/screenshots/en/remote-add-light.png
diff --git a/docs/screenshots/en/remote-clients-dark.png b/docs/screenshots/en/remote-clients-dark.png
diff --git a/docs/screenshots/en/remote-clients-light.png b/docs/screenshots/en/remote-clients-light.png
diff --git a/docs/screenshots/en/remote-switcher-dark.png b/docs/screenshots/en/remote-switcher-dark.png
diff --git a/docs/screenshots/en/remote-switcher-light.png b/docs/screenshots/en/remote-switcher-light.png
diff --git a/docs/screenshots/en/routing-dark.png b/docs/screenshots/en/routing-dark.png
diff --git a/docs/screenshots/en/routing-light.png b/docs/screenshots/en/routing-light.png
diff --git a/docs/screenshots/en/security-dark.png b/docs/screenshots/en/security-dark.png
diff --git a/docs/screenshots/en/security-light.png b/docs/screenshots/en/security-light.png
diff --git a/docs/screenshots/en/settings-dark.png b/docs/screenshots/en/settings-dark.png
diff --git a/docs/screenshots/en/settings-light.png b/docs/screenshots/en/settings-light.png
diff --git a/docs/screenshots/en/traffic-dark.png b/docs/screenshots/en/traffic-dark.png
diff --git a/docs/screenshots/en/traffic-light.png b/docs/screenshots/en/traffic-light.png
diff --git a/docs/screenshots/en/upstreams-dark.png b/docs/screenshots/en/upstreams-dark.png
diff --git a/docs/screenshots/en/upstreams-light.png b/docs/screenshots/en/upstreams-light.png
diff --git a/docs/screenshots/menubar-dark.png b/docs/screenshots/menubar-dark.png
diff --git a/docs/screenshots/menubar-light.png b/docs/screenshots/menubar-light.png
diff --git a/docs/screenshots/web/clients-en.webp b/docs/screenshots/web/clients-en.webp
diff --git a/docs/screenshots/web/clients.webp b/docs/screenshots/web/clients.webp
diff --git a/docs/screenshots/web/dry-run-en.webp b/docs/screenshots/web/dry-run-en.webp
diff --git a/docs/screenshots/web/dry-run.webp b/docs/screenshots/web/dry-run.webp
diff --git a/docs/screenshots/web/keys-en.webp b/docs/screenshots/web/keys-en.webp
diff --git a/docs/screenshots/web/keys.webp b/docs/screenshots/web/keys.webp
diff --git a/docs/screenshots/web/menubar-menu-en.webp b/docs/screenshots/web/menubar-menu-en.webp
diff --git a/docs/screenshots/web/menubar-menu.webp b/docs/screenshots/web/menubar-menu.webp
diff --git a/docs/screenshots/web/menubar.png b/docs/screenshots/web/menubar.png
diff --git a/docs/screenshots/web/overview-en.webp b/docs/screenshots/web/overview-en.webp
diff --git a/docs/screenshots/web/overview.webp b/docs/screenshots/web/overview.webp
diff --git a/docs/screenshots/web/remote-add-en.webp b/docs/screenshots/web/remote-add-en.webp
diff --git a/docs/screenshots/web/remote-add.webp b/docs/screenshots/web/remote-add.webp
diff --git a/docs/screenshots/web/remote-clients-en.webp b/docs/screenshots/web/remote-clients-en.webp
diff --git a/docs/screenshots/web/remote-clients.webp b/docs/screenshots/web/remote-clients.webp
diff --git a/docs/screenshots/web/remote-switcher-en.webp b/docs/screenshots/web/remote-switcher-en.webp
diff --git a/docs/screenshots/web/remote-switcher.webp b/docs/screenshots/web/remote-switcher.webp
diff --git a/docs/screenshots/web/routing-en.webp b/docs/screenshots/web/routing-en.webp
diff --git a/docs/screenshots/web/routing.webp b/docs/screenshots/web/routing.webp
diff --git a/docs/screenshots/web/security-en.webp b/docs/screenshots/web/security-en.webp
diff --git a/docs/screenshots/web/security.webp b/docs/screenshots/web/security.webp
diff --git a/docs/screenshots/web/settings-en.webp b/docs/screenshots/web/settings-en.webp
diff --git a/docs/screenshots/web/settings.webp b/docs/screenshots/web/settings.webp
diff --git a/docs/screenshots/web/traffic-en.webp b/docs/screenshots/web/traffic-en.webp
diff --git a/docs/screenshots/web/traffic.webp b/docs/screenshots/web/traffic.webp
diff --git a/docs/screenshots/web/upstreams-en.webp b/docs/screenshots/web/upstreams-en.webp
diff --git a/docs/screenshots/web/upstreams.webp b/docs/screenshots/web/upstreams.webp
diff --git a/docs/screenshots/zh/clients-dark.png b/docs/screenshots/zh/clients-dark.png
diff --git a/docs/screenshots/zh/clients-light.png b/docs/screenshots/zh/clients-light.png
diff --git a/docs/screenshots/zh/dry-run-dark.png b/docs/screenshots/zh/dry-run-dark.png
diff --git a/docs/screenshots/zh/dry-run-light.png b/docs/screenshots/zh/dry-run-light.png
diff --git a/docs/screenshots/zh/keys-dark.png b/docs/screenshots/zh/keys-dark.png
diff --git a/docs/screenshots/zh/keys-light.png b/docs/screenshots/zh/keys-light.png
diff --git a/docs/screenshots/zh/menubar-menu-dark.png b/docs/screenshots/zh/menubar-menu-dark.png
diff --git a/docs/screenshots/zh/menubar-menu-light.png b/docs/screenshots/zh/menubar-menu-light.png
diff --git a/docs/screenshots/zh/overview-dark.png b/docs/screenshots/zh/overview-dark.png
diff --git a/docs/screenshots/zh/overview-light.png b/docs/screenshots/zh/overview-light.png
diff --git a/docs/screenshots/zh/remote-add-dark.png b/docs/screenshots/zh/remote-add-dark.png
diff --git a/docs/screenshots/zh/remote-add-light.png b/docs/screenshots/zh/remote-add-light.png
diff --git a/docs/screenshots/zh/remote-clients-dark.png b/docs/screenshots/zh/remote-clients-dark.png
diff --git a/docs/screenshots/zh/remote-clients-light.png b/docs/screenshots/zh/remote-clients-light.png
diff --git a/docs/screenshots/zh/remote-switcher-dark.png b/docs/screenshots/zh/remote-switcher-dark.png
diff --git a/docs/screenshots/zh/remote-switcher-light.png b/docs/screenshots/zh/remote-switcher-light.png
diff --git a/docs/screenshots/zh/routing-dark.png b/docs/screenshots/zh/routing-dark.png
diff --git a/docs/screenshots/zh/routing-light.png b/docs/screenshots/zh/routing-light.png
diff --git a/docs/screenshots/zh/security-dark.png b/docs/screenshots/zh/security-dark.png
diff --git a/docs/screenshots/zh/security-light.png b/docs/screenshots/zh/security-light.png
diff --git a/docs/screenshots/zh/settings-dark.png b/docs/screenshots/zh/settings-dark.png
diff --git a/docs/screenshots/zh/settings-light.png b/docs/screenshots/zh/settings-light.png
diff --git a/docs/screenshots/zh/traffic-dark.png b/docs/screenshots/zh/traffic-dark.png
diff --git a/docs/screenshots/zh/traffic-light.png b/docs/screenshots/zh/traffic-light.png
diff --git a/docs/screenshots/zh/upstreams-dark.png b/docs/screenshots/zh/upstreams-dark.png
diff --git a/docs/screenshots/zh/upstreams-light.png b/docs/screenshots/zh/upstreams-light.png