# damonkoy/dsh-web-ui architecture

> Architecture diagram of the GitHub repository damonkoy/dsh-web-ui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/damonkoy/dsh-web-ui
- Repository: https://github.com/damonkoy/dsh-web-ui

## Overview

This repository is a collection of installable DeepSeek Harness Web UI plugins and skins. The main user workflow is using DSH’s desktop interface to open a feature—such as the task board, file panels, or SSH—and receive a result through host services; mobile remote access adds device pairing and a separate phone UI. The graph also preserves settings, image understanding, pet, live statistics, Git visualization, and skin customization. Some subsystems are represented from README descriptions and the source index; unsampled implementation details and connections are omitted.

Main entry points: [`packages/dsh-aionui-panel/src/host/routes.ts`](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/host/routes.ts) (Panel routes), [`packages/dsh-ssh/src/routes.ts`](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/routes.ts) (SSH routes), [`packages/dsh-task-board/src/client/board/TaskBoard.tsx`](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/client/board/TaskBoard.tsx) (Task board UI), [`packages/dsh-task-board/src/core/controller.ts`](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/core/controller.ts) (Task controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_work["Workspace tools"]
  node_taskui["Task board UI<br/>[TaskBoard.tsx]"]
  node_taskcore["Task controller<br/>[controller.ts]"]
  node_taskexec["Task execution<br/>[execution.ts]"]
  node_gitui["Git graph UI<br/>[GraphDialog.tsx]"]
  node_gitservice["Git service<br/>[git-service.ts]"]
  node_panelui["File and preview panels<br/>[ExplorerPanel.tsx]"]
  node_panelroutes["Panel routes<br/>[routes.ts]"]
  node_fsservice["Workspace file service<br/>[fs-service.ts]"]
  node_panelgit["Workspace SCM service<br/>[git-service.ts]"]
end

subgraph group_remote["Remote access"]
  node_remoteui["Pairing interface<br/>[RemotePanel.tsx]"]
  node_pairroutes["Pairing routes<br/>[routes.ts]"]
  node_mobile["Mobile workspace UI<br/>[App.tsx]"]
  node_mux["Mobile event mux<br/>[mux.ts]"]
  node_sshui["SSH operations panel<br/>[SshPanel.tsx]"]
  node_sshroutes["SSH routes<br/>[routes.ts]"]
  node_sshengine["SSH engine<br/>[engine.ts]"]
  node_sshstore[("Host configuration store<br/>[store.ts]")]
end

subgraph group_companion["Companion features"]
  node_petui["Pet interface<br/>[PetDockEntry.tsx]"]
  node_petroutes["Pet routes<br/>[routes.ts]"]
  node_petservice["Pet service<br/>[service.ts]"]
  node_stats["Live token statistics<br/>[estimator.ts]"]
  node_imageui["Image upload interface<br/>[send-hook.ts]"]
  node_imageapi["Image attachment routes<br/>[attach-routes.ts]"]
  node_vision["Vision tool<br/>[vision-client.ts]"]
end

subgraph group_custom["Customization"]
  node_settings["Plugin settings"]
  node_skinui["Skin center<br/>[SkinCenter.tsx]"]
  node_skinroutes["Skin routes<br/>[routes.ts]"]
  node_skinswitch["Skin switching<br/>[skin-switch.ts]"]
  node_skinpackages["Installable skins<br/>[index.js]"]
end

node_user(("DSH user"))
node_dsh(("DSH host"))

node_user -->|"opens board"| node_taskui
node_taskui -.->|"manages tasks"| node_taskcore
node_taskcore -->|"runs tasks"| node_taskexec
node_user -->|"views history"| node_gitui
node_gitui -.->|"requests Git data"| node_gitservice
node_user -->|"browses files"| node_panelui
node_panelui -.->|"requests panel data"| node_panelroutes
node_panelroutes -->|"reads workspace files"| node_fsservice
node_panelroutes -->|"requests Git status"| node_panelgit
node_user -->|"starts pairing"| node_remoteui
node_remoteui -.->|"pairs device"| node_pairroutes
node_user -->|"controls workspace"| node_mobile
node_mobile -->|"receives live events"| node_mux
node_user -->|"opens SSH panel"| node_sshui
node_sshui -.->|"requests remote operations"| node_sshroutes
node_sshroutes -->|"dispatches operations"| node_sshengine
node_sshroutes -->|"manages hosts"| node_sshstore
node_user -->|"interacts with pet"| node_petui
node_petui -.->|"sends pet requests"| node_petroutes
node_petroutes -->|"delegates pet actions"| node_petservice
node_dsh -.->|"provides token activity"| node_stats
node_user -->|"attaches image"| node_imageui
node_imageui -->|"uploads image"| node_imageapi
node_imageapi -.->|"resolves attachment"| node_vision
node_user -->|"configures plugins"| node_settings
node_user -->|"tries on skin"| node_skinui
node_skinui -.->|"requests skin action"| node_skinroutes
node_skinroutes -->|"applies skin"| node_skinswitch
node_skinswitch -.->|"selects skin"| node_skinpackages

click node_taskui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/client/board/TaskBoard.tsx"
click node_taskcore "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/core/controller.ts"
click node_taskexec "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/core/execution.ts"
click node_gitui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-git-graph/src/client/graph/GraphDialog.tsx"
click node_gitservice "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-git-graph/src/host/git-service.ts"
click node_panelui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/client/components/ExplorerPanel.tsx"
click node_panelroutes "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/host/routes.ts"
click node_fsservice "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/host/fs-service.ts"
click node_panelgit "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/host/git-service.ts"
click node_remoteui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/client/RemotePanel.tsx"
click node_pairroutes "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/routes.ts"
click node_mobile "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/mobile/views/App.tsx"
click node_mux "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/mobile/mux.ts"
click node_sshui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/client/panel/SshPanel.tsx"
click node_sshroutes "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/routes.ts"
click node_sshengine "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/engine.ts"
click node_sshstore "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/store.ts"
click node_petui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-pet/src/client/PetDockEntry.tsx"
click node_petroutes "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-pet/src/routes.ts"
click node_petservice "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-pet/src/service.ts"
click node_stats "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-live-stats/src/estimator.ts"
click node_imageui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-tool-describe-image/src/client/send-hook.ts"
click node_imageapi "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-tool-describe-image/src/attach-routes.ts"
click node_vision "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-tool-describe-image/src/vision-client.ts"
click node_settings "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-web-ui-settings/src/client/WebUIPluginsCard.tsx"
click node_skinui "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/skins/skin-center/src/client/SkinCenter.tsx"
click node_skinroutes "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/skins/skin-center/src/routes.ts"
click node_skinswitch "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/skins/skin-center/src/skin-switch.ts"
click node_skinpackages "https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-skins/skins/blue-fantasy/lib/index.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_taskui,node_taskcore,node_taskexec,node_gitui,node_gitservice,node_panelui,node_panelroutes,node_fsservice,node_panelgit,node_user toneBlue
class node_remoteui,node_pairroutes,node_mobile,node_mux,node_sshui,node_sshroutes,node_sshengine,node_sshstore toneAmber
class node_petui,node_petroutes,node_petservice,node_stats,node_imageui,node_imageapi,node_vision toneMint
class node_settings,node_skinui,node_skinroutes,node_skinswitch,node_skinpackages toneRose
class node_dsh toneIndigo
```

## Components

### Workspace tools

- [Task board UI](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/client/board/TaskBoard.tsx): `packages/dsh-task-board/src/client/board/TaskBoard.tsx`
- [Task controller](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/core/controller.ts): `packages/dsh-task-board/src/core/controller.ts`
- [Task execution](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-task-board/src/core/execution.ts): `packages/dsh-task-board/src/core/execution.ts`
- [Git graph UI](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-git-graph/src/client/graph/GraphDialog.tsx): `packages/dsh-git-graph/src/client/graph/GraphDialog.tsx`
- [Git service](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-git-graph/src/host/git-service.ts): `packages/dsh-git-graph/src/host/git-service.ts`
- [File and preview panels](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/client/components/ExplorerPanel.tsx): `packages/dsh-aionui-panel/src/client/components/ExplorerPanel.tsx`
- [Panel routes](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/host/routes.ts): `packages/dsh-aionui-panel/src/host/routes.ts`
- [Workspace file service](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/host/fs-service.ts): `packages/dsh-aionui-panel/src/host/fs-service.ts`
- [Workspace SCM service](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-aionui-panel/src/host/git-service.ts): `packages/dsh-aionui-panel/src/host/git-service.ts`

### Remote access

- [Pairing interface](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/client/RemotePanel.tsx): `packages/dsh-remote-web-ui/src/client/RemotePanel.tsx`
- [Pairing routes](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/routes.ts): `packages/dsh-remote-web-ui/src/routes.ts`
- [Mobile workspace UI](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/mobile/views/App.tsx): `packages/dsh-remote-web-ui/src/mobile/views/App.tsx`
- [Mobile event mux](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-remote-web-ui/src/mobile/mux.ts): `packages/dsh-remote-web-ui/src/mobile/mux.ts`
- [SSH operations panel](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/client/panel/SshPanel.tsx): `packages/dsh-ssh/src/client/panel/SshPanel.tsx`
- [SSH routes](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/routes.ts): `packages/dsh-ssh/src/routes.ts`
- [SSH engine](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/engine.ts): `packages/dsh-ssh/src/engine.ts`
- [Host configuration store](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-ssh/src/store.ts): `packages/dsh-ssh/src/store.ts`

### Companion features

- [Pet interface](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-pet/src/client/PetDockEntry.tsx): `packages/dsh-pet/src/client/PetDockEntry.tsx`
- [Pet routes](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-pet/src/routes.ts): `packages/dsh-pet/src/routes.ts`
- [Pet service](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-pet/src/service.ts): `packages/dsh-pet/src/service.ts`
- [Live token statistics](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-live-stats/src/estimator.ts): `packages/dsh-live-stats/src/estimator.ts`
- [Image upload interface](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-tool-describe-image/src/client/send-hook.ts): `packages/dsh-tool-describe-image/src/client/send-hook.ts`
- [Image attachment routes](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-tool-describe-image/src/attach-routes.ts): `packages/dsh-tool-describe-image/src/attach-routes.ts`
- [Vision tool](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-tool-describe-image/src/vision-client.ts): `packages/dsh-tool-describe-image/src/vision-client.ts`

### Customization

- [Plugin settings](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-web-ui-settings/src/client/WebUIPluginsCard.tsx): `packages/dsh-web-ui-settings/src/client/WebUIPluginsCard.tsx`
- [Skin center](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/skins/skin-center/src/client/SkinCenter.tsx): `packages/skins/skin-center/src/client/SkinCenter.tsx`
- [Skin routes](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/skins/skin-center/src/routes.ts): `packages/skins/skin-center/src/routes.ts`
- [Skin switching](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/skins/skin-center/src/skin-switch.ts): `packages/skins/skin-center/src/skin-switch.ts`
- [Installable skins](https://github.com/damonkoy/dsh-web-ui/blob/main/packages/dsh-skins/skins/blue-fantasy/lib/index.js): `packages/dsh-skins/skins/blue-fantasy/lib/index.js`

### Other components

- **DSH user**
- **DSH host**

## Connections

- DSH user → Task board UI: opens board
- Task board UI → Task controller: manages tasks (evidence: `packages/dsh-task-board/src/core/controller.ts`)
- Task controller → Task execution: runs tasks (evidence: `packages/dsh-task-board/src/core/controller.ts`)
- DSH user → Git graph UI: views history
- Git graph UI → Git service: requests Git data
- DSH user → File and preview panels: browses files
- File and preview panels → Panel routes: requests panel data
- Panel routes → Workspace file service: reads workspace files (evidence: `packages/dsh-aionui-panel/src/host/routes.ts`)
- Panel routes → Workspace SCM service: requests Git status (evidence: `packages/dsh-aionui-panel/src/host/routes.ts`)
- DSH user → Pairing interface: starts pairing
- Pairing interface → Pairing routes: pairs device
- DSH user → Mobile workspace UI: controls workspace
- Mobile workspace UI → Mobile event mux: receives live events (evidence: `packages/dsh-remote-web-ui/src/mobile/views/App.tsx`)
- DSH user → SSH operations panel: opens SSH panel
- SSH operations panel → SSH routes: requests remote operations
- SSH routes → SSH engine: dispatches operations (evidence: `packages/dsh-ssh/src/routes.ts`)
- SSH routes → Host configuration store: manages hosts (evidence: `packages/dsh-ssh/src/routes.ts`)
- DSH user → Pet interface: interacts with pet
- Pet interface → Pet routes: sends pet requests
- Pet routes → Pet service: delegates pet actions (evidence: `packages/dsh-pet/src/routes.ts`)
- DSH host → Live token statistics: provides token activity
- DSH user → Image upload interface: attaches image
- Image upload interface → Image attachment routes: uploads image
- Image attachment routes → Vision tool: resolves attachment (evidence: `packages/dsh-tool-describe-image/src/vision-client.ts`)
- DSH user → Plugin settings: configures plugins
- DSH user → Skin center: tries on skin
- Skin center → Skin routes: requests skin action
- Skin routes → Skin switching: applies skin (evidence: `packages/skins/skin-center/src/routes.ts`)
- Skin switching → Installable skins: selects skin
