# hmofet/unodos architecture

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

## Overview

UnoDOS is a family of graphical operating systems, with pc64 as its bare-metal modern-PC flagship. The main user workflow is booting the OS into its desktop, launching an app, and using it to produce a result such as a viewed web page or edited office document. The README documents the major capabilities and several integrations; many implementation paths below are directory-level because their source was not sampled, so those links are cited as documented rather than inferred from imports.

Main entry points: [`pc64/app_loader.c`](https://github.com/hmofet/unodos/blob/master/pc64/app_loader.c) (App modules), [`pc64`](https://github.com/hmofet/unodos/tree/master/pc64) (pc64 OS), [`unoweb/uw_layout.c`](https://github.com/hmofet/unodos/blob/master/unoweb/uw_layout.c) (Browser), [`unoui/unoui.c`](https://github.com/hmofet/unodos/blob/master/unoui/unoui.c) (Desktop UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop and apps"]
  node_desktopui["Desktop UI<br/>[unoui.c]"]
  node_moduleloader["App modules<br/>[app_loader.c]"]
end

subgraph group_weboffice["Web and productivity"]
  node_office["Office suite<br/>[uoword.c]"]
  node_docformats["Office formats<br/>[ud_xls.c]"]
  node_browser["Browser<br/>[uw_layout.c]"]
  node_css["CSS engine<br/>[stylesheet.c]"]
  node_jsvm["UnoJS VM<br/>[ujs_comp.c]"]
  node_quickjs["QuickJS engine"]
  node_media["Media codecs<br/>[um_vp8.c]"]
  node_compiler["UnoC compiler<br/>[ucc.c]"]
end

subgraph group_platform["Platform services"]
  node_pc["pc64 OS"]
  node_network["Network stack"]
  node_tls["TLS engine<br/>[ssl_engine.c]"]
  node_storage["Storage authoring<br/>[unostorage.c]"]
  node_fat["FAT filesystem<br/>[fat.h]"]
  node_hypervisor["Hypervisor"]
end

subgraph group_install["Install and automation"]
  node_installer["Installer"]
  node_usbflasher["macOS flasher<br/>[FlashModel.swift]"]
  node_urc["Remote control"]
end

subgraph group_family["Shared family contracts"]
  node_contract["Platform contract"]
  node_ports["Platform ports"]
end

node_user(("User"))

node_user -->|"boots"| node_pc
node_pc -->|"presents desktop"| node_desktopui
node_user -->|"uses desktop"| node_desktopui
node_desktopui -->|"discovers apps"| node_moduleloader
node_moduleloader -->|"loads module"| node_office
node_office -->|"reads and writes"| node_docformats
node_moduleloader -->|"loads module"| node_browser
node_browser -.->|"uses layout option"| node_css
node_browser -->|"dispatches scripts"| node_jsvm
node_browser -->|"switches engine"| node_quickjs
node_moduleloader -->|"loads module"| node_compiler
node_moduleloader -.->|"loads media apps"| node_media
node_network -->|"uses TLS"| node_tls
node_storage -->|"formats volume"| node_fat
node_pc -->|"provides networking"| node_network
node_pc -->|"provides storage"| node_storage
node_pc -->|"runs guests"| node_hypervisor
node_user -->|"installs OS"| node_installer
node_installer -->|"authors disk"| node_storage
node_usbflasher -.->|"flashes USB"| node_installer
node_user -->|"remotely controls"| node_urc
node_contract -->|"defines shared contract"| node_ports

click node_pc "https://github.com/hmofet/unodos/tree/master/pc64"
click node_desktopui "https://github.com/hmofet/unodos/blob/master/unoui/unoui.c"
click node_moduleloader "https://github.com/hmofet/unodos/blob/master/pc64/app_loader.c"
click node_office "https://github.com/hmofet/unodos/blob/master/pc64/apps/uoword.c"
click node_docformats "https://github.com/hmofet/unodos/blob/master/unodoc/ud_xls.c"
click node_browser "https://github.com/hmofet/unodos/blob/master/unoweb/uw_layout.c"
click node_css "https://github.com/hmofet/unodos/blob/master/csslib/css/src/stylesheet.c"
click node_jsvm "https://github.com/hmofet/unodos/blob/master/unojs/ujs_comp.c"
click node_quickjs "https://github.com/hmofet/unodos/tree/master/pc64/quickjs"
click node_media "https://github.com/hmofet/unodos/blob/master/unomedia/um_vp8.c"
click node_compiler "https://github.com/hmofet/unodos/blob/master/pc64/apps/ucc.c"
click node_tls "https://github.com/hmofet/unodos/blob/master/pc64/bearssl/src/ssl/ssl_engine.c"
click node_storage "https://github.com/hmofet/unodos/blob/master/pc64/unostorage.c"
click node_fat "https://github.com/hmofet/unodos/blob/master/pc64/fat.h"
click node_hypervisor "https://github.com/hmofet/unodos/tree/master/pc64"
click node_installer "https://github.com/hmofet/unodos/tree/master/pc64"
click node_usbflasher "https://github.com/hmofet/unodos/blob/master/pc64/flash/mac/Sources/UnoDosFlasher/FlashModel.swift"
click node_urc "https://github.com/hmofet/unodos/tree/master/pc64"
click node_contract "https://github.com/hmofet/unodos/tree/master/unodef"
click node_ports "https://github.com/hmofet/unodos/tree/master/amiga"

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_desktopui,node_moduleloader,node_user toneBlue
class node_office,node_docformats,node_browser,node_css,node_jsvm,node_quickjs,node_media,node_compiler toneAmber
class node_pc,node_network,node_tls,node_storage,node_fat,node_hypervisor toneMint
class node_installer,node_usbflasher,node_urc toneRose
class node_contract,node_ports toneIndigo
```

## Components

### Desktop and apps

- [Desktop UI](https://github.com/hmofet/unodos/blob/master/unoui/unoui.c): `unoui/unoui.c`
- [App modules](https://github.com/hmofet/unodos/blob/master/pc64/app_loader.c): `pc64/app_loader.c`

### Web and productivity

- [Office suite](https://github.com/hmofet/unodos/blob/master/pc64/apps/uoword.c): `pc64/apps/uoword.c`
- [Office formats](https://github.com/hmofet/unodos/blob/master/unodoc/ud_xls.c): `unodoc/ud_xls.c`
- [Browser](https://github.com/hmofet/unodos/blob/master/unoweb/uw_layout.c): `unoweb/uw_layout.c`
- [CSS engine](https://github.com/hmofet/unodos/blob/master/csslib/css/src/stylesheet.c): `csslib/css/src/stylesheet.c`
- [UnoJS VM](https://github.com/hmofet/unodos/blob/master/unojs/ujs_comp.c): `unojs/ujs_comp.c`
- [QuickJS engine](https://github.com/hmofet/unodos/tree/master/pc64/quickjs): `pc64/quickjs`
- [Media codecs](https://github.com/hmofet/unodos/blob/master/unomedia/um_vp8.c): `unomedia/um_vp8.c`
- [UnoC compiler](https://github.com/hmofet/unodos/blob/master/pc64/apps/ucc.c): `pc64/apps/ucc.c`

### Platform services

- [pc64 OS](https://github.com/hmofet/unodos/tree/master/pc64): `pc64`
- **Network stack**
- [TLS engine](https://github.com/hmofet/unodos/blob/master/pc64/bearssl/src/ssl/ssl_engine.c): `pc64/bearssl/src/ssl/ssl_engine.c`
- [Storage authoring](https://github.com/hmofet/unodos/blob/master/pc64/unostorage.c): `pc64/unostorage.c`
- [FAT filesystem](https://github.com/hmofet/unodos/blob/master/pc64/fat.h): `pc64/fat.h`
- [Hypervisor](https://github.com/hmofet/unodos/tree/master/pc64): `pc64`

### Install and automation

- [Installer](https://github.com/hmofet/unodos/tree/master/pc64): `pc64`
- [macOS flasher](https://github.com/hmofet/unodos/blob/master/pc64/flash/mac/Sources/UnoDosFlasher/FlashModel.swift): `pc64/flash/mac/Sources/UnoDosFlasher/FlashModel.swift`
- [Remote control](https://github.com/hmofet/unodos/tree/master/pc64): `pc64`

### Shared family contracts

- [Platform contract](https://github.com/hmofet/unodos/tree/master/unodef): `unodef`
- [Platform ports](https://github.com/hmofet/unodos/tree/master/amiga): `amiga`

### Other components

- **User**

## Connections

- User → pc64 OS: boots (evidence: `README.md`)
- pc64 OS → Desktop UI: presents desktop (evidence: `README.md`)
- User → Desktop UI: uses desktop (evidence: `README.md`)
- Desktop UI → App modules: discovers apps (evidence: `README.md`)
- App modules → Office suite: loads module (evidence: `README.md`)
- Office suite → Office formats: reads and writes (evidence: `README.md`)
- App modules → Browser: loads module (evidence: `README.md`)
- Browser → CSS engine: uses layout option (evidence: `README.md`)
- Browser → UnoJS VM: dispatches scripts (evidence: `README.md`)
- Browser → QuickJS engine: switches engine (evidence: `README.md`)
- App modules → UnoC compiler: loads module (evidence: `README.md`)
- App modules → Media codecs: loads media apps (evidence: `README.md`)
- Network stack → TLS engine: uses TLS (evidence: `README.md`)
- Storage authoring → FAT filesystem: formats volume (evidence: `pc64/unostorage.c`)
- pc64 OS → Network stack: provides networking (evidence: `README.md`)
- pc64 OS → Storage authoring: provides storage (evidence: `README.md`)
- pc64 OS → Hypervisor: runs guests (evidence: `README.md`)
- User → Installer: installs OS (evidence: `README.md`)
- Installer → Storage authoring: authors disk (evidence: `pc64/unostorage.h`)
- macOS flasher → Installer: flashes USB (evidence: `README.md`)
- User → Remote control: remotely controls (evidence: `README.md`)
- Platform contract → Platform ports: defines shared contract (evidence: `README.md`)
