# raytolfas/os architecture

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

- Interactive diagram: https://gitdiagram.com/raytolfas/os
- Repository: https://github.com/raytolfas/os

## Overview

Raytolfas OS is a desktop Linux distribution whose user-facing workflow is installation, boot, and use of a KDE Plasma/Wayland desktop with Android and Windows compatibility. Its Welcome and Control Center apps provide first-run completion and system/update status. The graph preserves the documented installer, boot, kernel, compatibility, and security capabilities; unsampled subsystem links are omitted or marked unverified rather than inferred from filenames.

Main entry points: [`apps/control-center/main.py`](https://github.com/raytolfas/os/blob/main/apps/control-center/main.py) (Control Center Backend), [`apps/welcome/main.py`](https://github.com/raytolfas/os/blob/main/apps/welcome/main.py) (Welcome Backend), [`kernel/limine.conf`](https://github.com/raytolfas/os/blob/main/kernel/limine.conf) (Limine Bootloader), [`config/calamares`](https://github.com/raytolfas/os/tree/main/config/calamares) (Calamares Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation"]
  node_installer["Calamares Installer"]
  node_installer_branding["Installer Branding<br/>[stylesheet.qss]"]
end

subgraph group_system["Boot and System"]
  node_limine["Limine Bootloader<br/>[limine.conf]"]
  node_boot_entries["Boot Entries"]
  node_kernel_config["Kernel Config<br/>[d1-alpha.fragment]"]
  node_security_rules["Polkit Rules<br/>[40-raytolfas.rules]"]
end

subgraph group_desktop["Desktop Apps"]
  node_desktop["Plasma on Wayland"]
  node_welcome["Welcome Backend<br/>[main.py]"]
  node_welcome_ui["Welcome UI<br/>[Welcome.qml]"]
  node_welcome_state["Welcome Marker"]
  node_control["Control Center Backend<br/>[main.py]"]
  node_control_ui["Control Center UI<br/>[ControlCenter.qml]"]
end

subgraph group_compat["Compatibility"]
  node_waydroid_tools["Android Utilities"]
  node_apk_install["APK Installer"]
  node_waydroid["Waydroid"]
  node_proton_tool["Proton Utility"]
  node_proton_ge["Proton-GE"]
end

node_user(("User"))
node_update_service["Update Service"]

node_user -->|"installs system"| node_installer
node_installer -.->|"uses styling"| node_installer_branding
node_user -->|"boots system"| node_limine
node_limine -.->|"loads entries"| node_boot_entries
node_kernel_config -.->|"configures kernel"| node_limine
node_user -->|"uses desktop"| node_desktop
node_user -->|"opens app"| node_welcome
node_welcome -->|"loads UI"| node_welcome_ui
node_welcome -->|"writes marker"| node_welcome_state
node_user -->|"opens app"| node_control
node_control -->|"loads UI"| node_control_ui
node_control -->|"checks releases"| node_update_service
node_control -->|"checks status"| node_waydroid
node_waydroid_tools -.->|"supports Android"| node_waydroid
node_apk_install -.->|"installs APKs"| node_waydroid
node_proton_tool -.->|"uses runtime"| node_proton_ge
node_user -->|"runs Android apps"| node_waydroid_tools
node_user -->|"runs Windows apps"| node_proton_tool

click node_installer "https://github.com/raytolfas/os/tree/main/config/calamares"
click node_installer_branding "https://github.com/raytolfas/os/blob/main/assets/branding/calamares/stylesheet.qss"
click node_limine "https://github.com/raytolfas/os/blob/main/kernel/limine.conf"
click node_boot_entries "https://github.com/raytolfas/os/blob/main/boot/systemd-boot/entries/raytolfas-d1-alpha.conf"
click node_kernel_config "https://github.com/raytolfas/os/blob/main/kernel/configs/d1-alpha.fragment"
click node_security_rules "https://github.com/raytolfas/os/blob/main/config/polkit/40-raytolfas.rules"
click node_welcome "https://github.com/raytolfas/os/blob/main/apps/welcome/main.py"
click node_welcome_ui "https://github.com/raytolfas/os/blob/main/apps/welcome/Welcome.qml"
click node_control "https://github.com/raytolfas/os/blob/main/apps/control-center/main.py"
click node_control_ui "https://github.com/raytolfas/os/blob/main/apps/control-center/ControlCenter.qml"
click node_waydroid_tools "https://github.com/raytolfas/os/blob/main/scripts/tools/raytolfas-android"
click node_apk_install "https://github.com/raytolfas/os/blob/main/scripts/tools/raytolfas-apk-install"
click node_proton_tool "https://github.com/raytolfas/os/blob/main/scripts/tools/raytolfas-proton"

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_installer_branding,node_user toneBlue
class node_limine,node_boot_entries,node_kernel_config,node_security_rules toneAmber
class node_desktop,node_welcome,node_welcome_ui,node_welcome_state,node_control,node_control_ui toneMint
class node_waydroid_tools,node_apk_install,node_waydroid,node_proton_tool,node_proton_ge toneRose
class node_update_service toneIndigo
```

## Components

### Installation

- [Calamares Installer](https://github.com/raytolfas/os/tree/main/config/calamares): `config/calamares`
- [Installer Branding](https://github.com/raytolfas/os/blob/main/assets/branding/calamares/stylesheet.qss): `assets/branding/calamares/stylesheet.qss`

### Boot and System

- [Limine Bootloader](https://github.com/raytolfas/os/blob/main/kernel/limine.conf): `kernel/limine.conf`
- [Boot Entries](https://github.com/raytolfas/os/blob/main/boot/systemd-boot/entries/raytolfas-d1-alpha.conf): `boot/systemd-boot/entries/raytolfas-d1-alpha.conf`
- [Kernel Config](https://github.com/raytolfas/os/blob/main/kernel/configs/d1-alpha.fragment): `kernel/configs/d1-alpha.fragment`
- [Polkit Rules](https://github.com/raytolfas/os/blob/main/config/polkit/40-raytolfas.rules): `config/polkit/40-raytolfas.rules`

### Desktop Apps

- **Plasma on Wayland**
- [Welcome Backend](https://github.com/raytolfas/os/blob/main/apps/welcome/main.py): `apps/welcome/main.py`
- [Welcome UI](https://github.com/raytolfas/os/blob/main/apps/welcome/Welcome.qml): `apps/welcome/Welcome.qml`
- **Welcome Marker**
- [Control Center Backend](https://github.com/raytolfas/os/blob/main/apps/control-center/main.py): `apps/control-center/main.py`
- [Control Center UI](https://github.com/raytolfas/os/blob/main/apps/control-center/ControlCenter.qml): `apps/control-center/ControlCenter.qml`

### Compatibility

- [Android Utilities](https://github.com/raytolfas/os/blob/main/scripts/tools/raytolfas-android): `scripts/tools/raytolfas-android`
- [APK Installer](https://github.com/raytolfas/os/blob/main/scripts/tools/raytolfas-apk-install): `scripts/tools/raytolfas-apk-install`
- **Waydroid**
- [Proton Utility](https://github.com/raytolfas/os/blob/main/scripts/tools/raytolfas-proton): `scripts/tools/raytolfas-proton`
- **Proton-GE**

### Other components

- **User**
- **Update Service**

## Connections

- User → Calamares Installer: installs system (evidence: `README.md`)
- Calamares Installer → Installer Branding: uses styling
- User → Limine Bootloader: boots system (evidence: `README.md`)
- Limine Bootloader → Boot Entries: loads entries
- Kernel Config → Limine Bootloader: configures kernel
- User → Plasma on Wayland: uses desktop (evidence: `README.md`)
- User → Welcome Backend: opens app (evidence: `README.md`)
- Welcome Backend → Welcome UI: loads UI (evidence: `apps/welcome/main.py`)
- Welcome Backend → Welcome Marker: writes marker (evidence: `apps/welcome/main.py`)
- User → Control Center Backend: opens app (evidence: `README.md`)
- Control Center Backend → Control Center UI: loads UI (evidence: `apps/control-center/main.py`)
- Control Center Backend → Update Service: checks releases (evidence: `apps/control-center/main.py`)
- Control Center Backend → Waydroid: checks status (evidence: `apps/control-center/main.py`)
- Android Utilities → Waydroid: supports Android
- APK Installer → Waydroid: installs APKs
- Proton Utility → Proton-GE: uses runtime
- User → Android Utilities: runs Android apps (evidence: `README.md`)
- User → Proton Utility: runs Windows apps (evidence: `README.md`)
