# saamy4r/aether architecture

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

- Interactive diagram: https://gitdiagram.com/saamy4r/aether
- Repository: https://github.com/saamy4r/aether

## Overview

Aether is a Flutter VPS-management desktop environment. Users add a server with SSH credentials, connect, then use a floating-window desktop to inspect live statistics and operate terminal, SFTP, Docker, firewall, and systemd tools. The graph follows those documented capabilities and identifies likely implementation modules by exact paths in the tree; Dart implementation excerpts were not provided, so internal call ownership and wiring cannot be verified. Platform bootstrap is shown only where native source excerpts establish it.

Main entry points: [`lib/ui/desktop/desktop_screen.dart`](https://github.com/saamy4r/aether/blob/master/lib/ui/desktop/desktop_screen.dart) (Desktop shell), [`lib/ui/windows/docker/docker_window.dart`](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/docker/docker_window.dart) (Docker manager), [`lib/ui/settings/add_vps_screen.dart`](https://github.com/saamy4r/aether/blob/master/lib/ui/settings/add_vps_screen.dart) (Connection setup), [`lib/app.dart`](https://github.com/saamy4r/aether/blob/master/lib/app.dart) (Flutter app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop experience"]
  node_flutter_app["Flutter app<br/>[app.dart]"]
  node_desktop["Desktop shell"]
  node_windowing["Window manager"]
  node_taskbar["Taskbar and menu<br/>[taskbar.dart]"]
end

subgraph group_connection["Server access"]
  node_server_list["Server list"]
  node_connection_setup["Connection setup"]
  node_ssh_connection["SSH connection"]
end

subgraph group_operations["Server operations"]
  node_dashboard["Live dashboard"]
  node_server_stats["Stats provider"]
  node_terminal["Terminal"]
  node_file_manager["SFTP file manager"]
  node_docker["Docker manager<br/>[docker_window.dart]"]
  node_docker_logs["Docker logs"]
  node_docker_shell["Docker shell"]
  node_firewall["Firewall manager"]
  node_services["Service manager"]
end

subgraph group_shared["Shared services"]
  node_credentials["Credential storage"]
  node_biometric["Biometric lock"]
  node_appearance["Appearance settings"]
end

subgraph group_platform["Platform hosts"]
  node_linux_main["Linux entrypoint<br/>[main.cc]"]
  node_linux_host["Linux Flutter host<br/>[my_application.cc]"]
  node_plugin_registration["Plugin registration"]
end

node_user(("User"))
node_server(("VPS server"))

node_user -->|"uses"| node_flutter_app
node_flutter_app -.->|"manage servers"| node_server_list
node_user -->|"adds server"| node_connection_setup
node_connection_setup -->|"tests connection"| node_ssh_connection
node_ssh_connection -->|"connects by SSH"| node_server
node_connection_setup -->|"stores credentials"| node_credentials
node_user -->|"opens desktop"| node_desktop
node_desktop -->|"manages windows"| node_windowing
node_desktop -->|"shows taskbar"| node_taskbar
node_desktop -->|"opens dashboard"| node_dashboard
node_dashboard -->|"displays stats"| node_server_stats
node_server_stats -->|"reads live metrics"| node_server
node_desktop -->|"opens terminal"| node_terminal
node_terminal -->|"runs commands"| node_server
node_desktop -->|"opens file manager"| node_file_manager
node_file_manager -->|"manages files by SFTP"| node_server
node_desktop -->|"opens Docker manager"| node_docker
node_docker -->|"controls containers"| node_server
node_docker -->|"opens logs"| node_docker_logs
node_docker -->|"opens container shell"| node_docker_shell
node_desktop -->|"opens firewall manager"| node_firewall
node_firewall -->|"manages UFW"| node_server
node_desktop -->|"opens service manager"| node_services
node_services -->|"manages systemd"| node_server
node_user -.->|"unlocks app"| node_biometric
node_user -->|"sets appearance"| node_appearance
node_linux_main -->|"creates and runs"| node_linux_host
node_linux_host -->|"registers plugins"| node_plugin_registration

click node_flutter_app "https://github.com/saamy4r/aether/blob/master/lib/app.dart"
click node_desktop "https://github.com/saamy4r/aether/blob/master/lib/ui/desktop/desktop_screen.dart"
click node_windowing "https://github.com/saamy4r/aether/blob/master/lib/providers/window_manager_provider.dart"
click node_taskbar "https://github.com/saamy4r/aether/blob/master/lib/ui/taskbar/taskbar.dart"
click node_dashboard "https://github.com/saamy4r/aether/blob/master/lib/ui/windows/dashboard/dashboard_window.dart"
click node_server_stats "https://github.com/saamy4r/aether/blob/master/lib/providers/dashboard_provider.dart"
click node_server_list "https://github.com/saamy4r/aether/blob/master/lib/providers/vps_list_provider.dart"
click node_connection_setup "https://github.com/saamy4r/aether/blob/master/lib/ui/settings/add_vps_screen.dart"
click node_ssh_connection "https://github.com/saamy4r/aether/blob/master/lib/providers/vps_connection_provider.dart"
click node_terminal "https://github.com/saamy4r/aether/blob/master/lib/ui/windows/terminal/terminal_window.dart"
click node_file_manager "https://github.com/saamy4r/aether/blob/master/lib/ui/windows/file_manager/file_manager_window.dart"
click node_docker "https://github.com/saamy4r/aether/blob/master/lib/ui/windows/docker/docker_window.dart"
click node_docker_logs "https://github.com/saamy4r/aether/blob/master/lib/ui/windows/docker/docker_logs_window.dart"
click node_docker_shell "https://github.com/saamy4r/aether/blob/master/lib/providers/docker_shell_provider.dart"
click node_firewall "https://github.com/saamy4r/aether/blob/master/lib/ui/windows/firewall/firewall_window.dart"
click node_services "https://github.com/saamy4r/aether/blob/master/lib/ui/windows/services/service_manager_window.dart"
click node_credentials "https://github.com/saamy4r/aether/blob/master/lib/core/services/credential_service.dart"
click node_biometric "https://github.com/saamy4r/aether/blob/master/lib/core/services/biometric_service.dart"
click node_appearance "https://github.com/saamy4r/aether/blob/master/lib/providers/glass_settings_provider.dart"
click node_linux_main "https://github.com/saamy4r/aether/blob/master/linux/runner/main.cc"
click node_linux_host "https://github.com/saamy4r/aether/blob/master/linux/runner/my_application.cc"
click node_plugin_registration "https://github.com/saamy4r/aether/blob/master/linux/flutter/generated_plugin_registrant.cc"

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_flutter_app,node_desktop,node_windowing,node_taskbar,node_user toneBlue
class node_server_list,node_connection_setup,node_ssh_connection toneAmber
class node_dashboard,node_server_stats,node_terminal,node_file_manager,node_docker,node_docker_logs,node_docker_shell,node_firewall,node_services,node_server toneMint
class node_credentials,node_biometric,node_appearance toneRose
class node_linux_main,node_linux_host,node_plugin_registration toneIndigo
```

## Components

### Desktop experience

- [Flutter app](https://github.com/saamy4r/aether/blob/master/lib/app.dart): `lib/app.dart`
- [Desktop shell](https://github.com/saamy4r/aether/blob/master/lib/ui/desktop/desktop_screen.dart): `lib/ui/desktop/desktop_screen.dart`
- [Window manager](https://github.com/saamy4r/aether/blob/master/lib/providers/window_manager_provider.dart): `lib/providers/window_manager_provider.dart`
- [Taskbar and menu](https://github.com/saamy4r/aether/blob/master/lib/ui/taskbar/taskbar.dart): `lib/ui/taskbar/taskbar.dart`

### Server access

- [Server list](https://github.com/saamy4r/aether/blob/master/lib/providers/vps_list_provider.dart): `lib/providers/vps_list_provider.dart`
- [Connection setup](https://github.com/saamy4r/aether/blob/master/lib/ui/settings/add_vps_screen.dart): `lib/ui/settings/add_vps_screen.dart`
- [SSH connection](https://github.com/saamy4r/aether/blob/master/lib/providers/vps_connection_provider.dart): `lib/providers/vps_connection_provider.dart`

### Server operations

- [Live dashboard](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/dashboard/dashboard_window.dart): `lib/ui/windows/dashboard/dashboard_window.dart`
- [Stats provider](https://github.com/saamy4r/aether/blob/master/lib/providers/dashboard_provider.dart): `lib/providers/dashboard_provider.dart`
- [Terminal](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/terminal/terminal_window.dart): `lib/ui/windows/terminal/terminal_window.dart`
- [SFTP file manager](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/file_manager/file_manager_window.dart): `lib/ui/windows/file_manager/file_manager_window.dart`
- [Docker manager](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/docker/docker_window.dart): `lib/ui/windows/docker/docker_window.dart`
- [Docker logs](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/docker/docker_logs_window.dart): `lib/ui/windows/docker/docker_logs_window.dart`
- [Docker shell](https://github.com/saamy4r/aether/blob/master/lib/providers/docker_shell_provider.dart): `lib/providers/docker_shell_provider.dart`
- [Firewall manager](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/firewall/firewall_window.dart): `lib/ui/windows/firewall/firewall_window.dart`
- [Service manager](https://github.com/saamy4r/aether/blob/master/lib/ui/windows/services/service_manager_window.dart): `lib/ui/windows/services/service_manager_window.dart`

### Shared services

- [Credential storage](https://github.com/saamy4r/aether/blob/master/lib/core/services/credential_service.dart): `lib/core/services/credential_service.dart`
- [Biometric lock](https://github.com/saamy4r/aether/blob/master/lib/core/services/biometric_service.dart): `lib/core/services/biometric_service.dart`
- [Appearance settings](https://github.com/saamy4r/aether/blob/master/lib/providers/glass_settings_provider.dart): `lib/providers/glass_settings_provider.dart`

### Platform hosts

- [Linux entrypoint](https://github.com/saamy4r/aether/blob/master/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux Flutter host](https://github.com/saamy4r/aether/blob/master/linux/runner/my_application.cc): `linux/runner/my_application.cc`
- [Plugin registration](https://github.com/saamy4r/aether/blob/master/linux/flutter/generated_plugin_registrant.cc): `linux/flutter/generated_plugin_registrant.cc`

### Other components

- **User**
- **VPS server**

## Connections

- User → Flutter app: uses (evidence: `README.md`)
- Flutter app → Server list: manage servers
- User → Connection setup: adds server (evidence: `README.md`)
- Connection setup → SSH connection: tests connection (evidence: `README.md`)
- SSH connection → VPS server: connects by SSH (evidence: `README.md`)
- Connection setup → Credential storage: stores credentials (evidence: `README.md`)
- User → Desktop shell: opens desktop (evidence: `README.md`)
- Desktop shell → Window manager: manages windows (evidence: `README.md`)
- Desktop shell → Taskbar and menu: shows taskbar (evidence: `README.md`)
- Desktop shell → Live dashboard: opens dashboard (evidence: `README.md`)
- Live dashboard → Stats provider: displays stats (evidence: `README.md`)
- Stats provider → VPS server: reads live metrics (evidence: `README.md`)
- Desktop shell → Terminal: opens terminal (evidence: `README.md`)
- Terminal → VPS server: runs commands (evidence: `README.md`)
- Desktop shell → SFTP file manager: opens file manager (evidence: `README.md`)
- SFTP file manager → VPS server: manages files by SFTP (evidence: `README.md`)
- Desktop shell → Docker manager: opens Docker manager (evidence: `README.md`)
- Docker manager → VPS server: controls containers (evidence: `README.md`)
- Docker manager → Docker logs: opens logs (evidence: `README.md`)
- Docker manager → Docker shell: opens container shell (evidence: `README.md`)
- Desktop shell → Firewall manager: opens firewall manager (evidence: `README.md`)
- Firewall manager → VPS server: manages UFW (evidence: `README.md`)
- Desktop shell → Service manager: opens service manager (evidence: `README.md`)
- Service manager → VPS server: manages systemd (evidence: `README.md`)
- User → Biometric lock: unlocks app (evidence: `README.md`)
- User → Appearance settings: sets appearance (evidence: `README.md`)
- Linux entrypoint → Linux Flutter host: creates and runs (evidence: `linux/runner/main.cc`)
- Linux Flutter host → Plugin registration: registers plugins (evidence: `linux/runner/my_application.cc`)
