# gitsquared/edex-ui architecture

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

- Interactive diagram: https://gitdiagram.com/gitsquared/edex-ui
- Repository: https://github.com/gitsquared/edex-ui

## Overview

eDEX-UI is an Electron desktop terminal with a sci-fi dashboard. The main workflow starts at application launch, creates a shell-backed terminal, and presents it alongside filesystem and system/network monitoring views; users can interact through the terminal or touch keyboard. The README also documents themes, keyboard layouts, and optional sound effects. The sampled sources establish boot-to-terminal creation, keyboard-to-terminal input, and globe-to-network lookup; other dashboard wiring is not shown, so those links are left unverified.

Main entry points: [`src/classes/terminal.class.js`](https://github.com/gitsquared/edex-ui/blob/master/src/classes/terminal.class.js) (Terminal sessions), [`src/_boot.js`](https://github.com/gitsquared/edex-ui/blob/master/src/_boot.js) (Electron boot), [`src/classes/netstat.class.js`](https://github.com/gitsquared/edex-ui/blob/master/src/classes/netstat.class.js) (Connection monitor), [`src/classes/keyboard.class.js`](https://github.com/gitsquared/edex-ui/blob/master/src/classes/keyboard.class.js) (Touch keyboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_boot["Electron boot<br/>[_boot.js]"]
  node_renderer["UI renderer<br/>[_renderer.js]"]
  node_workers["System info workers<br/>[_multithread.js]"]
end

subgraph group_terminal["Terminal and files"]
  node_terminal["Terminal sessions<br/>[terminal.class.js]"]
  node_filesystem["Directory viewer"]
end

subgraph group_monitoring["System and network monitoring"]
  node_cpu["CPU monitor<br/>[cpuinfo.class.js]"]
  node_memory["RAM monitor"]
  node_processes["Process monitor<br/>[toplist.class.js]"]
  node_system["System details<br/>[sysinfo.class.js]"]
  node_hardware["Hardware inspector"]
  node_network["Connection monitor<br/>[netstat.class.js]"]
  node_globe["Network globe"]
  node_clock["Clock<br/>[clock.class.js]"]
  node_conninfo["Connection details<br/>[conninfo.class.js]"]
end

subgraph group_interaction["Interface and customization"]
  node_keyboard["Touch keyboard<br/>[keyboard.class.js]"]
  node_modal["Dialogs<br/>[modal.class.js]"]
  node_fuzzy["Fuzzy finder"]
  node_media["Media player"]
  node_audio["Sound effects<br/>[audiofx.class.js]"]
  node_themes["Themes and layouts"]
end

node_user(("User"))
node_shell["System shell"]
node_external(("Network services"))

node_user -.->|"launches"| node_boot
node_boot -->|"creates session"| node_terminal
node_terminal -.->|"spawns shell"| node_shell
node_user -.->|"uses terminal"| node_terminal
node_keyboard -->|"sends input"| node_terminal
node_terminal -.->|"provides CWD"| node_filesystem
node_workers -.->|"queries system data"| node_external
node_network -->|"provides IP lookup"| node_globe
node_user -.->|"views monitoring"| node_cpu
node_user -.->|"views monitoring"| node_memory
node_user -.->|"views monitoring"| node_processes
node_user -.->|"views monitoring"| node_system
node_user -.->|"views connections"| node_network
node_user -.->|"touch input"| node_keyboard
node_user -.->|"customizes interface"| node_themes
node_user -.->|"enables effects"| node_audio
node_renderer -.->|"opens dialogs"| node_modal
node_user -.->|"searches"| node_fuzzy
node_user -.->|"plays media"| node_media

click node_boot "https://github.com/gitsquared/edex-ui/blob/master/src/_boot.js"
click node_renderer "https://github.com/gitsquared/edex-ui/blob/master/src/_renderer.js"
click node_workers "https://github.com/gitsquared/edex-ui/blob/master/src/_multithread.js"
click node_terminal "https://github.com/gitsquared/edex-ui/blob/master/src/classes/terminal.class.js"
click node_filesystem "https://github.com/gitsquared/edex-ui/blob/master/src/classes/filesystem.class.js"
click node_keyboard "https://github.com/gitsquared/edex-ui/blob/master/src/classes/keyboard.class.js"
click node_cpu "https://github.com/gitsquared/edex-ui/blob/master/src/classes/cpuinfo.class.js"
click node_memory "https://github.com/gitsquared/edex-ui/blob/master/src/classes/ramwatcher.class.js"
click node_processes "https://github.com/gitsquared/edex-ui/blob/master/src/classes/toplist.class.js"
click node_system "https://github.com/gitsquared/edex-ui/blob/master/src/classes/sysinfo.class.js"
click node_hardware "https://github.com/gitsquared/edex-ui/blob/master/src/classes/hardwareInspector.class.js"
click node_network "https://github.com/gitsquared/edex-ui/blob/master/src/classes/netstat.class.js"
click node_globe "https://github.com/gitsquared/edex-ui/blob/master/src/classes/locationGlobe.class.js"
click node_clock "https://github.com/gitsquared/edex-ui/blob/master/src/classes/clock.class.js"
click node_conninfo "https://github.com/gitsquared/edex-ui/blob/master/src/classes/conninfo.class.js"
click node_modal "https://github.com/gitsquared/edex-ui/blob/master/src/classes/modal.class.js"
click node_fuzzy "https://github.com/gitsquared/edex-ui/blob/master/src/classes/fuzzyFinder.class.js"
click node_media "https://github.com/gitsquared/edex-ui/blob/master/src/classes/mediaPlayer.class.js"
click node_audio "https://github.com/gitsquared/edex-ui/blob/master/src/classes/audiofx.class.js"
click node_themes "https://github.com/gitsquared/edex-ui/tree/master/src/assets"

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_boot,node_renderer,node_workers,node_user toneBlue
class node_terminal,node_filesystem toneAmber
class node_cpu,node_memory,node_processes,node_system,node_hardware,node_network,node_globe,node_clock,node_conninfo toneMint
class node_keyboard,node_modal,node_fuzzy,node_media,node_audio,node_themes toneRose
class node_shell,node_external toneIndigo
```

## Components

### Application shell

- [Electron boot](https://github.com/gitsquared/edex-ui/blob/master/src/_boot.js): `src/_boot.js`
- [UI renderer](https://github.com/gitsquared/edex-ui/blob/master/src/_renderer.js): `src/_renderer.js`
- [System info workers](https://github.com/gitsquared/edex-ui/blob/master/src/_multithread.js): `src/_multithread.js`

### Terminal and files

- [Terminal sessions](https://github.com/gitsquared/edex-ui/blob/master/src/classes/terminal.class.js): `src/classes/terminal.class.js`
- [Directory viewer](https://github.com/gitsquared/edex-ui/blob/master/src/classes/filesystem.class.js): `src/classes/filesystem.class.js`

### System and network monitoring

- [CPU monitor](https://github.com/gitsquared/edex-ui/blob/master/src/classes/cpuinfo.class.js): `src/classes/cpuinfo.class.js`
- [RAM monitor](https://github.com/gitsquared/edex-ui/blob/master/src/classes/ramwatcher.class.js): `src/classes/ramwatcher.class.js`
- [Process monitor](https://github.com/gitsquared/edex-ui/blob/master/src/classes/toplist.class.js): `src/classes/toplist.class.js`
- [System details](https://github.com/gitsquared/edex-ui/blob/master/src/classes/sysinfo.class.js): `src/classes/sysinfo.class.js`
- [Hardware inspector](https://github.com/gitsquared/edex-ui/blob/master/src/classes/hardwareInspector.class.js): `src/classes/hardwareInspector.class.js`
- [Connection monitor](https://github.com/gitsquared/edex-ui/blob/master/src/classes/netstat.class.js): `src/classes/netstat.class.js`
- [Network globe](https://github.com/gitsquared/edex-ui/blob/master/src/classes/locationGlobe.class.js): `src/classes/locationGlobe.class.js`
- [Clock](https://github.com/gitsquared/edex-ui/blob/master/src/classes/clock.class.js): `src/classes/clock.class.js`
- [Connection details](https://github.com/gitsquared/edex-ui/blob/master/src/classes/conninfo.class.js): `src/classes/conninfo.class.js`

### Interface and customization

- [Touch keyboard](https://github.com/gitsquared/edex-ui/blob/master/src/classes/keyboard.class.js): `src/classes/keyboard.class.js`
- [Dialogs](https://github.com/gitsquared/edex-ui/blob/master/src/classes/modal.class.js): `src/classes/modal.class.js`
- [Fuzzy finder](https://github.com/gitsquared/edex-ui/blob/master/src/classes/fuzzyFinder.class.js): `src/classes/fuzzyFinder.class.js`
- [Media player](https://github.com/gitsquared/edex-ui/blob/master/src/classes/mediaPlayer.class.js): `src/classes/mediaPlayer.class.js`
- [Sound effects](https://github.com/gitsquared/edex-ui/blob/master/src/classes/audiofx.class.js): `src/classes/audiofx.class.js`
- [Themes and layouts](https://github.com/gitsquared/edex-ui/tree/master/src/assets): `src/assets`

### Other components

- **User**
- **System shell**
- **Network services**

## Connections

- User → Electron boot: launches
- Electron boot → Terminal sessions: creates session (evidence: `src/_boot.js`)
- Terminal sessions → System shell: spawns shell
- User → Terminal sessions: uses terminal (evidence: `README.md`)
- Touch keyboard → Terminal sessions: sends input (evidence: `src/classes/keyboard.class.js`)
- Terminal sessions → Directory viewer: provides CWD (evidence: `README.md`)
- System info workers → Network services: queries system data
- Connection monitor → Network globe: provides IP lookup (evidence: `src/classes/locationGlobe.class.js`)
- User → CPU monitor: views monitoring (evidence: `README.md`)
- User → RAM monitor: views monitoring (evidence: `README.md`)
- User → Process monitor: views monitoring (evidence: `README.md`)
- User → System details: views monitoring (evidence: `README.md`)
- User → Connection monitor: views connections (evidence: `README.md`)
- User → Touch keyboard: touch input (evidence: `README.md`)
- User → Themes and layouts: customizes interface (evidence: `README.md`)
- User → Sound effects: enables effects (evidence: `README.md`)
- UI renderer → Dialogs: opens dialogs
- User → Fuzzy finder: searches
- User → Media player: plays media
