# thevoidmonarch/void-x-link architecture

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

- Interactive diagram: https://gitdiagram.com/thevoidmonarch/void-x-link
- Repository: https://github.com/thevoidmonarch/void-x-link

## Overview

VoidLink is a self-hosted chat and secure file-transfer application. Users connect through a client, CLI, or terminal interface to a server; they authenticate, exchange messages, and transfer files. Optional browser interfaces provide user-facing and administrative access, while bot/API extensions broaden server capabilities. The graph includes core security, persistence, and transfer layers named in the README and source index. Some subsystem links are documented rather than verified in sampled implementation, so those relationships are marked dashed.

Main entry points: [`server.py`](https://github.com/thevoidmonarch/void-x-link/blob/main/server.py) (Server), [`tui/tui.py`](https://github.com/thevoidmonarch/void-x-link/blob/main/tui/tui.py) (Terminal UI), [`core/file_transfer.py`](https://github.com/thevoidmonarch/void-x-link/blob/main/core/file_transfer.py) (File transfer), [`web/web_server.py`](https://github.com/thevoidmonarch/void-x-link/blob/main/web/web_server.py) (Web UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["User access"]
  node_client["Client<br/>[client.py]"]
  node_cli["CLI<br/>[voidlink_cli.py]"]
  node_tui["Terminal UI<br/>[tui.py]"]
end

subgraph group_server["Server and chat"]
  node_server["Server<br/>[server.py]"]
  node_chat["Chat<br/>[chat.py]"]
  node_storage[("Chat storage<br/>[storage.py]")]
end

subgraph group_security["Security and transfers"]
  node_authentication["Authentication<br/>[authentication.py]"]
  node_encryption["Encryption<br/>[encryption.py]"]
  node_file_security["File security<br/>[file_security.py]"]
  node_file_transfer["File transfer<br/>[file_transfer.py]"]
  node_resumable["Resumable transfer"]
end

subgraph group_interfaces["Web and extensions"]
  node_web["Web UI<br/>[web_server.py]"]
  node_admin["Admin panel<br/>[app.py]"]
  node_extensions["Bot/API extensions"]
end

node_user(("User"))
node_browser(("Browser user"))

node_user -->|"uses"| node_client
node_user -->|"uses"| node_cli
node_user -->|"uses"| node_tui
node_client -->|"connects"| node_server
node_cli -.->|"connects"| node_server
node_tui -->|"uses"| node_authentication
node_tui -->|"uses"| node_encryption
node_tui -->|"uses"| node_file_security
node_tui -->|"uses"| node_file_transfer
node_tui -->|"uses"| node_resumable
node_server -.->|"authenticates"| node_authentication
node_server -->|"handles chat"| node_chat
node_chat -.->|"persists messages"| node_storage
node_server -->|"handles transfers"| node_file_transfer
node_file_transfer -->|"checks files"| node_file_security
node_file_transfer -->|"encrypts chunks"| node_encryption
node_server -.->|"supports resumption"| node_resumable
node_browser -->|"uses"| node_web
node_web -->|"uses"| node_authentication
node_web -->|"uses"| node_file_transfer
node_web -->|"checks files"| node_file_security
node_browser -.->|"administers"| node_admin
node_admin -->|"reads history"| node_storage
node_server -.->|"loads extensions"| node_extensions

click node_client "https://github.com/thevoidmonarch/void-x-link/blob/main/client.py"
click node_cli "https://github.com/thevoidmonarch/void-x-link/blob/main/cli/voidlink_cli.py"
click node_tui "https://github.com/thevoidmonarch/void-x-link/blob/main/tui/tui.py"
click node_server "https://github.com/thevoidmonarch/void-x-link/blob/main/server.py"
click node_chat "https://github.com/thevoidmonarch/void-x-link/blob/main/core/chat.py"
click node_storage "https://github.com/thevoidmonarch/void-x-link/blob/main/core/storage.py"
click node_authentication "https://github.com/thevoidmonarch/void-x-link/blob/main/core/authentication.py"
click node_encryption "https://github.com/thevoidmonarch/void-x-link/blob/main/core/encryption.py"
click node_file_security "https://github.com/thevoidmonarch/void-x-link/blob/main/core/file_security.py"
click node_file_transfer "https://github.com/thevoidmonarch/void-x-link/blob/main/core/file_transfer.py"
click node_resumable "https://github.com/thevoidmonarch/void-x-link/blob/main/core/file_transfer_resumable.py"
click node_web "https://github.com/thevoidmonarch/void-x-link/blob/main/web/web_server.py"
click node_admin "https://github.com/thevoidmonarch/void-x-link/blob/main/admin_webui/app.py"
click node_extensions "https://github.com/thevoidmonarch/void-x-link/tree/main/modules"

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_client,node_cli,node_tui,node_user,node_browser toneBlue
class node_server,node_chat,node_storage toneAmber
class node_authentication,node_encryption,node_file_security,node_file_transfer,node_resumable toneMint
class node_web,node_admin,node_extensions toneRose
```

## Components

### User access

- [Client](https://github.com/thevoidmonarch/void-x-link/blob/main/client.py): `client.py`
- [CLI](https://github.com/thevoidmonarch/void-x-link/blob/main/cli/voidlink_cli.py): `cli/voidlink_cli.py`
- [Terminal UI](https://github.com/thevoidmonarch/void-x-link/blob/main/tui/tui.py): `tui/tui.py`

### Server and chat

- [Server](https://github.com/thevoidmonarch/void-x-link/blob/main/server.py): `server.py`
- [Chat](https://github.com/thevoidmonarch/void-x-link/blob/main/core/chat.py): `core/chat.py`
- [Chat storage](https://github.com/thevoidmonarch/void-x-link/blob/main/core/storage.py): `core/storage.py`

### Security and transfers

- [Authentication](https://github.com/thevoidmonarch/void-x-link/blob/main/core/authentication.py): `core/authentication.py`
- [Encryption](https://github.com/thevoidmonarch/void-x-link/blob/main/core/encryption.py): `core/encryption.py`
- [File security](https://github.com/thevoidmonarch/void-x-link/blob/main/core/file_security.py): `core/file_security.py`
- [File transfer](https://github.com/thevoidmonarch/void-x-link/blob/main/core/file_transfer.py): `core/file_transfer.py`
- [Resumable transfer](https://github.com/thevoidmonarch/void-x-link/blob/main/core/file_transfer_resumable.py): `core/file_transfer_resumable.py`

### Web and extensions

- [Web UI](https://github.com/thevoidmonarch/void-x-link/blob/main/web/web_server.py): `web/web_server.py`
- [Admin panel](https://github.com/thevoidmonarch/void-x-link/blob/main/admin_webui/app.py): `admin_webui/app.py`
- [Bot/API extensions](https://github.com/thevoidmonarch/void-x-link/tree/main/modules): `modules`

### Other components

- **User**
- **Browser user**

## Connections

- User → Client: uses
- User → CLI: uses
- User → Terminal UI: uses
- Client → Server: connects
- CLI → Server: connects
- Terminal UI → Authentication: uses (evidence: `tui/tui.py`)
- Terminal UI → Encryption: uses (evidence: `tui/tui.py`)
- Terminal UI → File security: uses (evidence: `tui/tui.py`)
- Terminal UI → File transfer: uses (evidence: `tui/tui.py`)
- Terminal UI → Resumable transfer: uses (evidence: `tui/tui.py`)
- Server → Authentication: authenticates
- Server → Chat: handles chat (evidence: `server.py`)
- Chat → Chat storage: persists messages
- Server → File transfer: handles transfers (evidence: `server.py`)
- File transfer → File security: checks files (evidence: `core/file_transfer.py`)
- File transfer → Encryption: encrypts chunks (evidence: `core/file_transfer.py`)
- Server → Resumable transfer: supports resumption
- Browser user → Web UI: uses
- Web UI → Authentication: uses (evidence: `web/web_server.py`)
- Web UI → File transfer: uses (evidence: `web/web_server.py`)
- Web UI → File security: checks files (evidence: `web/web_server.py`)
- Browser user → Admin panel: administers
- Admin panel → Chat storage: reads history (evidence: `admin_webui/app.py`)
- Server → Bot/API extensions: loads extensions
