# wildorigins/wildos architecture

> Architecture diagram of the GitHub repository wildorigins/wildos, 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/wildorigins/wildos
- Repository: https://github.com/wildorigins/wildos

## Overview

Wild OS is a Debian-based Linux desktop designed for people moving from Windows, with a Windows 11 virtual-machine mode for applications that require Windows. The principal workflow begins at the redesigned desktop: users launch native apps for everyday work, or use Windows mode to open Windows programs as desktop windows. The repository tree shows distinct apps and system services, while the README documents major capabilities such as backup, recovery, remote access, and the Store. Some subsystem paths are supported only as enclosing directories; unsampled implementation details and links are left out.

Main entry points: [`packages/wildos-branding/files`](https://github.com/wildorigins/wildos/tree/main/packages/wildos-branding/files) (Wild desktop), [`packages/wildos-winmode`](https://github.com/wildorigins/wildos/tree/main/packages/wildos-winmode) (Windows mode), [`packages/wildos-installer/plugin`](https://github.com/wildorigins/wildos/tree/main/packages/wildos-installer/plugin) (Installer), [`packages/wildos-settings/src`](https://github.com/wildorigins/wildos/tree/main/packages/wildos-settings/src) (Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_desktop["Wild desktop"]
  node_settings["Settings"]
  node_installer["Installer"]
  node_store["Store"]
end

subgraph group_apps["Everyday apps"]
  node_files["Files"]
  node_office["Write and Tables"]
  node_mail["Mail and Calendar"]
  node_pdf["PDF"]
  node_capture["Capture"]
  node_notes["Notes"]
  node_remote["Remote access"]
  node_media["Music, Videos, Voice"]
  node_archive["Archive"]
end

subgraph group_windows["Windows mode"]
  node_windows["Windows mode"]
  node_appbridge["Windows app bridge<br/>[bridge.h]"]
  node_rdp["RemoteApp client"]
end

subgraph group_system["System services"]
  node_dialogs["System dialogs"]
end

subgraph group_protection["Protection and recovery"]
  node_backup["Encrypted backup"]
  node_recovery["Recovery"]
  node_report["Problem reports"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_desktop
node_desktop -->|"offers settings"| node_settings
node_desktop -->|"offers Store"| node_store
node_desktop -.->|"launches apps"| node_files
node_desktop -.->|"launches apps"| node_office
node_desktop -.->|"launches apps"| node_mail
node_desktop -.->|"launches apps"| node_pdf
node_desktop -.->|"launches apps"| node_capture
node_desktop -.->|"launches apps"| node_notes
node_desktop -.->|"launches apps"| node_remote
node_desktop -.->|"launches apps"| node_media
node_desktop -.->|"launches apps"| node_archive
node_user -->|"uses Windows mode"| node_windows
node_windows -->|"opens app windows"| node_rdp
node_windows -.->|"bridges Windows apps"| node_appbridge
node_desktop -->|"shows app windows"| node_windows
node_user -->|"backs up files"| node_backup
node_user -->|"recovers system"| node_recovery
node_user -->|"prepares report"| node_report
node_installer -.->|"installs desktop"| node_desktop

click node_desktop "https://github.com/wildorigins/wildos/tree/main/packages/wildos-branding/files"
click node_settings "https://github.com/wildorigins/wildos/tree/main/packages/wildos-settings/src"
click node_installer "https://github.com/wildorigins/wildos/tree/main/packages/wildos-installer/plugin"
click node_store "https://github.com/wildorigins/wildos/tree/main/packages/wildos-store/src"
click node_files "https://github.com/wildorigins/wildos/tree/main/packages/wildos-files/src"
click node_office "https://github.com/wildorigins/wildos/tree/main/packages/wildos-office/src"
click node_mail "https://github.com/wildorigins/wildos/tree/main/packages/wildos-mail/src"
click node_pdf "https://github.com/wildorigins/wildos/tree/main/packages/wildos-pdf/src"
click node_capture "https://github.com/wildorigins/wildos/tree/main/packages/wildos-capture/src"
click node_notes "https://github.com/wildorigins/wildos/tree/main/packages/wildos-notes/src"
click node_remote "https://github.com/wildorigins/wildos/tree/main/packages/wildos-remote/src"
click node_media "https://github.com/wildorigins/wildos/tree/main/packages/wildos-videos/src"
click node_archive "https://github.com/wildorigins/wildos/tree/main/packages/wildos-archive/src"
click node_windows "https://github.com/wildorigins/wildos/tree/main/packages/wildos-winmode"
click node_appbridge "https://github.com/wildorigins/wildos/blob/main/packages/wildos-appbridge/src/bridge.h"
click node_rdp "https://github.com/wildorigins/wildos/tree/main/packages/wildos-rdp/src"
click node_dialogs "https://github.com/wildorigins/wildos/tree/main/packages/wildos-system-dialogs/src"
click node_backup "https://github.com/wildorigins/wildos/tree/main/packages/wildos-backup/src"
click node_recovery "https://github.com/wildorigins/wildos/tree/main/packages/wildos-recovery/app/src"
click node_report "https://github.com/wildorigins/wildos/tree/main/packages/wildos-report/src"

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_desktop,node_settings,node_installer,node_store,node_user toneBlue
class node_files,node_office,node_mail,node_pdf,node_capture,node_notes,node_remote,node_media,node_archive toneAmber
class node_windows,node_appbridge,node_rdp toneMint
class node_dialogs toneRose
class node_backup,node_recovery,node_report toneIndigo
```

## Components

### Desktop experience

- [Wild desktop](https://github.com/wildorigins/wildos/tree/main/packages/wildos-branding/files): `packages/wildos-branding/files`
- [Settings](https://github.com/wildorigins/wildos/tree/main/packages/wildos-settings/src): `packages/wildos-settings/src`
- [Installer](https://github.com/wildorigins/wildos/tree/main/packages/wildos-installer/plugin): `packages/wildos-installer/plugin`
- [Store](https://github.com/wildorigins/wildos/tree/main/packages/wildos-store/src): `packages/wildos-store/src`

### Everyday apps

- [Files](https://github.com/wildorigins/wildos/tree/main/packages/wildos-files/src): `packages/wildos-files/src`
- [Write and Tables](https://github.com/wildorigins/wildos/tree/main/packages/wildos-office/src): `packages/wildos-office/src`
- [Mail and Calendar](https://github.com/wildorigins/wildos/tree/main/packages/wildos-mail/src): `packages/wildos-mail/src`
- [PDF](https://github.com/wildorigins/wildos/tree/main/packages/wildos-pdf/src): `packages/wildos-pdf/src`
- [Capture](https://github.com/wildorigins/wildos/tree/main/packages/wildos-capture/src): `packages/wildos-capture/src`
- [Notes](https://github.com/wildorigins/wildos/tree/main/packages/wildos-notes/src): `packages/wildos-notes/src`
- [Remote access](https://github.com/wildorigins/wildos/tree/main/packages/wildos-remote/src): `packages/wildos-remote/src`
- [Music, Videos, Voice](https://github.com/wildorigins/wildos/tree/main/packages/wildos-videos/src): `packages/wildos-videos/src`
- [Archive](https://github.com/wildorigins/wildos/tree/main/packages/wildos-archive/src): `packages/wildos-archive/src`

### Windows mode

- [Windows mode](https://github.com/wildorigins/wildos/tree/main/packages/wildos-winmode): `packages/wildos-winmode`
- [Windows app bridge](https://github.com/wildorigins/wildos/blob/main/packages/wildos-appbridge/src/bridge.h): `packages/wildos-appbridge/src/bridge.h`
- [RemoteApp client](https://github.com/wildorigins/wildos/tree/main/packages/wildos-rdp/src): `packages/wildos-rdp/src`

### System services

- [System dialogs](https://github.com/wildorigins/wildos/tree/main/packages/wildos-system-dialogs/src): `packages/wildos-system-dialogs/src`

### Protection and recovery

- [Encrypted backup](https://github.com/wildorigins/wildos/tree/main/packages/wildos-backup/src): `packages/wildos-backup/src`
- [Recovery](https://github.com/wildorigins/wildos/tree/main/packages/wildos-recovery/app/src): `packages/wildos-recovery/app/src`
- [Problem reports](https://github.com/wildorigins/wildos/tree/main/packages/wildos-report/src): `packages/wildos-report/src`

### Other components

- **Desktop user**

## Connections

- Desktop user → Wild desktop: uses (evidence: `README.md`)
- Wild desktop → Settings: offers settings (evidence: `README.md`)
- Wild desktop → Store: offers Store (evidence: `README.md`)
- Wild desktop → Files: launches apps
- Wild desktop → Write and Tables: launches apps
- Wild desktop → Mail and Calendar: launches apps
- Wild desktop → PDF: launches apps
- Wild desktop → Capture: launches apps
- Wild desktop → Notes: launches apps
- Wild desktop → Remote access: launches apps
- Wild desktop → Music, Videos, Voice: launches apps
- Wild desktop → Archive: launches apps
- Desktop user → Windows mode: uses Windows mode (evidence: `README.md`)
- Windows mode → RemoteApp client: opens app windows (evidence: `packages/wildos-rdp/src/main.cpp`)
- Windows mode → Windows app bridge: bridges Windows apps
- Wild desktop → Windows mode: shows app windows (evidence: `README.md`)
- Desktop user → Encrypted backup: backs up files (evidence: `README.md`)
- Desktop user → Recovery: recovers system (evidence: `README.md`)
- Desktop user → Problem reports: prepares report (evidence: `packages/wildos-report/src/main.cpp`)
- Installer → Wild desktop: installs desktop
