# reliefosproject/reliefos architecture

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

## Overview

ReliefOS is an x86_64 operating system with a graphical desktop, user applications, system services, and an installer. Its user-facing workflow includes installing or updating a system, creating accounts, and configuring the desktop; the README also describes login, application use, and service preferences. The tree shows a userland runtime and a separate ReliefNT kernel, but the supplied excerpts do not establish most runtime call paths. Accordingly, documented relationships are shown explicitly and uncertain wiring is omitted.

Main entry points: [`userland/apps/installer/main.c`](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/installer/main.c) (Installer), [`userland/apps/settings/main.c`](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/settings/main.c) (Settings), [`userland/apps/desktop`](https://github.com/reliefosproject/reliefos/tree/main/userland/apps/desktop) (Desktop), [`userland/apps`](https://github.com/reliefosproject/reliefos/tree/main/userland/apps) (User applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Install and setup"]
  node_installer["Installer<br/>[main.c]"]
  node_target[("Install target")]
end

subgraph group_platform["OS platform"]
  node_kernel["ReliefNT kernel"]
  node_runtime["Userland runtime"]
end

subgraph group_desktop["Desktop experience"]
  node_desktopapp["Desktop"]
  node_windowd["Window manager<br/>[main.c]"]
  node_settings["Settings<br/>[main.c]"]
  node_app_suite["User applications"]
  node_help["Help viewer<br/>[main.c]"]
  node_taskmgr["Task manager<br/>[main.c]"]
end

subgraph group_services["Accounts and services"]
  node_login["Login<br/>[main.c]"]
  node_sessiond["Session service<br/>[main.c]"]
  node_accounts[("Account store<br/>[account_store.c]")]
  node_servicemgr["Service manager<br/>[main.c]"]
end

node_user(("User"))

node_user -->|"installs or updates"| node_installer
node_installer -->|"mounts and copies"| node_target
node_user -->|"configures appearance"| node_settings
node_settings -->|"applies theme"| node_desktopapp
node_settings -->|"applies theme"| node_app_suite
node_installer -.->|"creates accounts"| node_accounts

click node_installer "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/installer/main.c"
click node_kernel "https://github.com/reliefosproject/reliefos/tree/main/kernel/reliefnt"
click node_runtime "https://github.com/reliefosproject/reliefos/tree/main/userland/runtime/src"
click node_desktopapp "https://github.com/reliefosproject/reliefos/tree/main/userland/apps/desktop"
click node_windowd "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/windowd/main.c"
click node_settings "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/settings/main.c"
click node_app_suite "https://github.com/reliefosproject/reliefos/tree/main/userland/apps"
click node_help "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/oshlp/main.c"
click node_taskmgr "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/taskmgr/main.c"
click node_login "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/login/main.c"
click node_sessiond "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/sessiond/main.c"
click node_accounts "https://github.com/reliefosproject/reliefos/blob/main/userland/auth/account_store.c"
click node_servicemgr "https://github.com/reliefosproject/reliefos/blob/main/userland/apps/servicemgr/main.c"

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_installer,node_target,node_user toneBlue
class node_kernel,node_runtime toneAmber
class node_desktopapp,node_windowd,node_settings,node_app_suite,node_help,node_taskmgr toneMint
class node_login,node_sessiond,node_accounts,node_servicemgr toneRose
```

## Components

### Install and setup

- [Installer](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/installer/main.c): `userland/apps/installer/main.c`
- **Install target**

### OS platform

- [ReliefNT kernel](https://github.com/reliefosproject/reliefos/tree/main/kernel/reliefnt): `kernel/reliefnt`
- [Userland runtime](https://github.com/reliefosproject/reliefos/tree/main/userland/runtime/src): `userland/runtime/src`

### Desktop experience

- [Desktop](https://github.com/reliefosproject/reliefos/tree/main/userland/apps/desktop): `userland/apps/desktop`
- [Window manager](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/windowd/main.c): `userland/apps/windowd/main.c`
- [Settings](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/settings/main.c): `userland/apps/settings/main.c`
- [User applications](https://github.com/reliefosproject/reliefos/tree/main/userland/apps): `userland/apps`
- [Help viewer](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/oshlp/main.c): `userland/apps/oshlp/main.c`
- [Task manager](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/taskmgr/main.c): `userland/apps/taskmgr/main.c`

### Accounts and services

- [Login](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/login/main.c): `userland/apps/login/main.c`
- [Session service](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/sessiond/main.c): `userland/apps/sessiond/main.c`
- [Account store](https://github.com/reliefosproject/reliefos/blob/main/userland/auth/account_store.c): `userland/auth/account_store.c`
- [Service manager](https://github.com/reliefosproject/reliefos/blob/main/userland/apps/servicemgr/main.c): `userland/apps/servicemgr/main.c`

### Other components

- **User**

## Connections

- User → Installer: installs or updates
- Installer → Install target: mounts and copies (evidence: `userland/apps/installer/main.c`)
- User → Settings: configures appearance
- Settings → Desktop: applies theme
- Settings → User applications: applies theme (evidence: `userland/apps/settings/main.c`)
- Installer → Account store: creates accounts
