# aliihsaad/windock architecture

> Architecture diagram of the GitHub repository aliihsaad/windock, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aliihsaad/windock
- Repository: https://github.com/aliihsaad/windock

## Overview

WinDock turns an Android phone into a dock and remote-control surface for a Windows or Linux PC on a local network. The main workflow is to discover or select a host, pair or authenticate, load the dock UI, then invoke host capabilities such as app launch, media and input control, screen capture, and file transfer. The repository also includes a developing iOS companion. The map preserves documented features and sampled module relationships; unsampled implementation details are represented only where the source index or README supports them.

Main entry points: [`server.js`](https://github.com/aliihsaad/windock/blob/main/server.js) (HTTP host), [`android/app/src/main/java/com/windock/app/MainActivity.kt`](https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/MainActivity.kt) (Android companion), [`native/tray/Program.cs`](https://github.com/aliihsaad/windock/blob/main/native/tray/Program.cs) (Tray controls), [`src/platform/index.js`](https://github.com/aliihsaad/windock/blob/main/src/platform/index.js) (Provider selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_phone["Phone companions"]
  node_android["Android companion<br/>[MainActivity.kt]"]
  node_ios["iOS companion"]
  node_phone_discovery["Host discovery<br/>[Discovery.kt]"]
  node_phone_picker["PC picker<br/>[PcPicker.kt]"]
  node_secure_pairing["Secure pairing<br/>[SecurePairing.kt]"]
  node_secure_transport["Secure transport<br/>[SecureTransport.kt]"]
  node_phone_files["Files transfer<br/>[NativeFiles.kt]"]
end

subgraph group_web["Dock interface"]
  node_web_app["Dock application<br/>[app.js]"]
  node_web_input["Input controls<br/>[input-pad.js]"]
  node_web_dock["Dock rendering<br/>[dock.js]"]
end

subgraph group_host["Host services"]
  node_server["HTTP host<br/>[server.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_pair_invites["Pairing invites<br/>[pairing-invites.js]"]
  node_discovery["Host discovery<br/>[discovery.js]"]
  node_sync["Preference sync<br/>[sync.js]"]
  node_transfers["Transfer service<br/>[transfers.js]"]
  node_updates["Update service<br/>[updates.js]"]
end

subgraph group_platform["Platform control"]
  node_provider["Provider selection<br/>[index.js]"]
  node_provider_contract["Provider contract<br/>[contract.js]"]
  node_windows_provider["Windows provider<br/>[windows.js]"]
  node_linux_provider["Linux provider<br/>[linux.js]"]
  node_linux_helper["Linux input helper<br/>[main.rs]"]
end

subgraph group_tray["Windows tray"]
  node_tray_app["Tray controls<br/>[Program.cs]"]
  node_pairing_window["Pairing window<br/>[PairingWindow.cs]"]
  node_pairing_client["Pairing client<br/>[PairingClient.cs]"]
  node_transfer_window["Transfer window<br/>[TransferWindow.cs]"]
  node_update_checker["Update checker<br/>[UpdateChecker.cs]"]
end

node_user(("Phone user"))

node_user -->|"operates"| node_android
node_android -.->|"discovers hosts"| node_phone_discovery
node_android -->|"selects host"| node_phone_picker
node_android -->|"pairs securely"| node_secure_pairing
node_android -.->|"uses transport"| node_secure_transport
node_android -->|"opens files"| node_phone_files
node_android -.->|"hosts dock"| node_web_app
node_ios -->|"probes host"| node_server
node_web_app -->|"renders dock"| node_web_dock
node_web_app -->|"uses controls"| node_web_input
node_server -->|"creates provider"| node_provider
node_server -->|"creates service"| node_transfers
node_server -->|"routes authentication"| node_auth
node_server -->|"routes pairing"| node_pair_invites
node_server -->|"routes discovery"| node_discovery
node_server -->|"routes sync"| node_sync
node_server -->|"routes updates"| node_updates
node_provider -->|"validates provider"| node_provider_contract
node_provider -->|"selects by OS"| node_windows_provider
node_provider -->|"selects by OS"| node_linux_provider
node_linux_helper -->|"serves input protocol"| node_linux_provider
node_tray_app -->|"opens window"| node_pairing_window
node_pairing_window -->|"requests invite"| node_pairing_client
node_tray_app -->|"opens window"| node_transfer_window
node_tray_app -->|"checks updates"| node_update_checker
node_tray_app -->|"resets pairing"| node_server

click node_android "https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/MainActivity.kt"
click node_ios "https://github.com/aliihsaad/windock/blob/main/ios/Sources/DockViewController.swift"
click node_phone_discovery "https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/Discovery.kt"
click node_phone_picker "https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/PcPicker.kt"
click node_secure_pairing "https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/SecurePairing.kt"
click node_secure_transport "https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/SecureTransport.kt"
click node_phone_files "https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/NativeFiles.kt"
click node_web_app "https://github.com/aliihsaad/windock/blob/main/public/app.js"
click node_web_input "https://github.com/aliihsaad/windock/blob/main/public/input-pad.js"
click node_web_dock "https://github.com/aliihsaad/windock/blob/main/public/dock.js"
click node_server "https://github.com/aliihsaad/windock/blob/main/server.js"
click node_auth "https://github.com/aliihsaad/windock/blob/main/src/auth.js"
click node_pair_invites "https://github.com/aliihsaad/windock/blob/main/src/pairing-invites.js"
click node_discovery "https://github.com/aliihsaad/windock/blob/main/src/discovery.js"
click node_sync "https://github.com/aliihsaad/windock/blob/main/src/sync.js"
click node_transfers "https://github.com/aliihsaad/windock/blob/main/src/transfers.js"
click node_updates "https://github.com/aliihsaad/windock/blob/main/src/updates.js"
click node_provider "https://github.com/aliihsaad/windock/blob/main/src/platform/index.js"
click node_provider_contract "https://github.com/aliihsaad/windock/blob/main/src/platform/contract.js"
click node_windows_provider "https://github.com/aliihsaad/windock/blob/main/src/platform/windows.js"
click node_linux_provider "https://github.com/aliihsaad/windock/blob/main/src/platform/linux.js"
click node_linux_helper "https://github.com/aliihsaad/windock/blob/main/native/linux/src/main.rs"
click node_tray_app "https://github.com/aliihsaad/windock/blob/main/native/tray/Program.cs"
click node_pairing_window "https://github.com/aliihsaad/windock/blob/main/native/tray/PairingWindow.cs"
click node_pairing_client "https://github.com/aliihsaad/windock/blob/main/native/tray/PairingClient.cs"
click node_transfer_window "https://github.com/aliihsaad/windock/blob/main/native/tray/TransferWindow.cs"
click node_update_checker "https://github.com/aliihsaad/windock/blob/main/native/tray/UpdateChecker.cs"

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_android,node_ios,node_phone_discovery,node_phone_picker,node_secure_pairing,node_secure_transport,node_phone_files,node_user toneBlue
class node_web_app,node_web_input,node_web_dock toneAmber
class node_server,node_auth,node_pair_invites,node_discovery,node_sync,node_transfers,node_updates toneMint
class node_provider,node_provider_contract,node_windows_provider,node_linux_provider,node_linux_helper toneRose
class node_tray_app,node_pairing_window,node_pairing_client,node_transfer_window,node_update_checker toneIndigo
```

## Components

### Phone companions

- [Android companion](https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/MainActivity.kt): `android/app/src/main/java/com/windock/app/MainActivity.kt`
- [iOS companion](https://github.com/aliihsaad/windock/blob/main/ios/Sources/DockViewController.swift): `ios/Sources/DockViewController.swift`
- [Host discovery](https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/Discovery.kt): `android/app/src/main/java/com/windock/app/Discovery.kt`
- [PC picker](https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/PcPicker.kt): `android/app/src/main/java/com/windock/app/PcPicker.kt`
- [Secure pairing](https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/SecurePairing.kt): `android/app/src/main/java/com/windock/app/SecurePairing.kt`
- [Secure transport](https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/SecureTransport.kt): `android/app/src/main/java/com/windock/app/SecureTransport.kt`
- [Files transfer](https://github.com/aliihsaad/windock/blob/main/android/app/src/main/java/com/windock/app/NativeFiles.kt): `android/app/src/main/java/com/windock/app/NativeFiles.kt`

### Dock interface

- [Dock application](https://github.com/aliihsaad/windock/blob/main/public/app.js): `public/app.js`
- [Input controls](https://github.com/aliihsaad/windock/blob/main/public/input-pad.js): `public/input-pad.js`
- [Dock rendering](https://github.com/aliihsaad/windock/blob/main/public/dock.js): `public/dock.js`

### Host services

- [HTTP host](https://github.com/aliihsaad/windock/blob/main/server.js): `server.js`
- [Authentication](https://github.com/aliihsaad/windock/blob/main/src/auth.js): `src/auth.js`
- [Pairing invites](https://github.com/aliihsaad/windock/blob/main/src/pairing-invites.js): `src/pairing-invites.js`
- [Host discovery](https://github.com/aliihsaad/windock/blob/main/src/discovery.js): `src/discovery.js`
- [Preference sync](https://github.com/aliihsaad/windock/blob/main/src/sync.js): `src/sync.js`
- [Transfer service](https://github.com/aliihsaad/windock/blob/main/src/transfers.js): `src/transfers.js`
- [Update service](https://github.com/aliihsaad/windock/blob/main/src/updates.js): `src/updates.js`

### Platform control

- [Provider selection](https://github.com/aliihsaad/windock/blob/main/src/platform/index.js): `src/platform/index.js`
- [Provider contract](https://github.com/aliihsaad/windock/blob/main/src/platform/contract.js): `src/platform/contract.js`
- [Windows provider](https://github.com/aliihsaad/windock/blob/main/src/platform/windows.js): `src/platform/windows.js`
- [Linux provider](https://github.com/aliihsaad/windock/blob/main/src/platform/linux.js): `src/platform/linux.js`
- [Linux input helper](https://github.com/aliihsaad/windock/blob/main/native/linux/src/main.rs): `native/linux/src/main.rs`

### Windows tray

- [Tray controls](https://github.com/aliihsaad/windock/blob/main/native/tray/Program.cs): `native/tray/Program.cs`
- [Pairing window](https://github.com/aliihsaad/windock/blob/main/native/tray/PairingWindow.cs): `native/tray/PairingWindow.cs`
- [Pairing client](https://github.com/aliihsaad/windock/blob/main/native/tray/PairingClient.cs): `native/tray/PairingClient.cs`
- [Transfer window](https://github.com/aliihsaad/windock/blob/main/native/tray/TransferWindow.cs): `native/tray/TransferWindow.cs`
- [Update checker](https://github.com/aliihsaad/windock/blob/main/native/tray/UpdateChecker.cs): `native/tray/UpdateChecker.cs`

### Other components

- **Phone user**

## Connections

- Phone user → Android companion: operates (evidence: `README.md`)
- Android companion → Host discovery: discovers hosts (evidence: `android/app/src/main/java/com/windock/app/MainActivity.kt`)
- Android companion → PC picker: selects host (evidence: `android/app/src/main/java/com/windock/app/MainActivity.kt`)
- Android companion → Secure pairing: pairs securely (evidence: `android/app/src/main/java/com/windock/app/MainActivity.kt`)
- Android companion → Secure transport: uses transport (evidence: `android/app/src/main/java/com/windock/app/MainActivity.kt`)
- Android companion → Files transfer: opens files (evidence: `android/app/src/main/java/com/windock/app/MainActivity.kt`)
- Android companion → Dock application: hosts dock
- iOS companion → HTTP host: probes host (evidence: `ios/Sources/DockViewController.swift`)
- Dock application → Dock rendering: renders dock (evidence: `public/app.js`)
- Dock application → Input controls: uses controls (evidence: `public/app.js`)
- HTTP host → Provider selection: creates provider (evidence: `server.js`)
- HTTP host → Transfer service: creates service (evidence: `server.js`)
- HTTP host → Authentication: routes authentication (evidence: `server.js`)
- HTTP host → Pairing invites: routes pairing (evidence: `server.js`)
- HTTP host → Host discovery: routes discovery (evidence: `server.js`)
- HTTP host → Preference sync: routes sync (evidence: `server.js`)
- HTTP host → Update service: routes updates (evidence: `server.js`)
- Provider selection → Provider contract: validates provider (evidence: `src/platform/index.js`)
- Provider selection → Windows provider: selects by OS (evidence: `src/platform/index.js`)
- Provider selection → Linux provider: selects by OS (evidence: `src/platform/index.js`)
- Linux input helper → Linux provider: serves input protocol (evidence: `native/linux/src/main.rs`)
- Tray controls → Pairing window: opens window (evidence: `native/tray/Program.cs`)
- Pairing window → Pairing client: requests invite (evidence: `native/tray/PairingWindow.cs`)
- Tray controls → Transfer window: opens window (evidence: `native/tray/Program.cs`)
- Tray controls → Update checker: checks updates (evidence: `native/tray/Program.cs`)
- Tray controls → HTTP host: resets pairing (evidence: `native/tray/Program.cs`)
