# aerixsystem/dracolaxos architecture

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

- Interactive diagram: https://gitdiagram.com/aerixsystem/dracolaxos
- Repository: https://github.com/aerixsystem/dracolaxos

## Overview

DracolaxOS is a custom x86-64 operating system. Its documented runtime path begins with kernel boot and hardware setup, then starts scheduled tasks; the graphical mode uses a framebuffer compositor and desktop, while text/shell modes use framebuffer console output. The repository also contains storage, networking, services, built-in apps, Linux syscall stubs, and the LXScript language. Some connections below are documented only at README level; unsampled modules are represented by their exact tree paths rather than assumed call chains.

Main entry points: [`kernel/main.c`](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/main.c) (Kernel Entry), [`gui/desktop/default-desktop/desktop.c`](https://github.com/aerixsystem/dracolaxos/blob/main/gui/desktop/default-desktop/desktop.c) (Desktop), [`lxscript/lxscript.c`](https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/lxscript.c) (LXScript), [`gui/compositor/compositor.c`](https://github.com/aerixsystem/dracolaxos/blob/main/gui/compositor/compositor.c) (Compositor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Kernel and Hardware"]
  node_bootentry["Kernel Entry<br/>[main.c]"]
  node_bootmode["Boot Mode<br/>[bootmode.c]"]
  node_memory["Memory Management"]
  node_scheduler["Task Scheduler"]
  node_arch["x86 Architecture"]
  node_drivers["Hardware Drivers"]
end

subgraph group_gui["Graphical Environment"]
  node_framebuffer["Framebuffer<br/>[fb.c]"]
  node_compositor["Compositor<br/>[compositor.c]"]
  node_desktop["Desktop<br/>[desktop.c]"]
  node_widgets["Widget Toolkit<br/>[widgets.c]"]
  node_windowmgr["Window Manager<br/>[wm.c]"]
  node_icons["Icon Data<br/>[icon_data.h]"]
end

subgraph group_os["OS Facilities"]
  node_appman["App Manager"]
  node_apps["Built-in Apps"]
  node_vfs["Virtual Filesystem<br/>[vfs.c]"]
  node_ramfs["RAMFS<br/>[ramfs.c]"]
  node_procfs["procfs<br/>[procfs.c]"]
  node_network["Network Stack<br/>[net_driver.c]"]
  node_services["System Services"]
  node_linuxcompat["Linux Syscall Stubs"]
end

subgraph group_lang["Language Runtime"]
  node_lxscript["LXScript<br/>[lxscript.c]"]
  node_lexer["Lexer<br/>[lexer.c]"]
  node_parser["Parser<br/>[parser.c]"]
  node_codegen["Code Generator<br/>[codegen.c]"]
  node_vm["Virtual Machine<br/>[vm.c]"]
end

node_user(("OS User"))

node_bootentry -->|"initializes"| node_bootmode
node_bootentry -->|"initializes"| node_arch
node_bootentry -->|"initializes"| node_memory
node_bootentry -->|"initializes"| node_scheduler
node_bootentry -->|"initializes"| node_drivers
node_bootentry -->|"initializes"| node_framebuffer
node_bootentry -->|"initializes"| node_linuxcompat
node_bootentry -->|"boots"| node_user
node_desktop -->|"uses"| node_compositor
node_desktop -->|"uses"| node_widgets
node_widgets -->|"draws through"| node_compositor
node_compositor -->|"renders to"| node_framebuffer
node_compositor -->|"uses"| node_icons
node_desktop -->|"uses"| node_windowmgr
node_desktop -->|"uses"| node_appman
node_appman -.->|"launches"| node_apps
node_vfs -->|"supports"| node_ramfs
node_vfs -->|"supports"| node_procfs
node_services -.->|"manages"| node_network
node_lxscript -.->|"uses"| node_lexer
node_lxscript -.->|"uses"| node_parser
node_lxscript -.->|"uses"| node_codegen
node_lxscript -.->|"uses"| node_vm

click node_bootentry "https://github.com/aerixsystem/dracolaxos/blob/main/kernel/main.c"
click node_bootmode "https://github.com/aerixsystem/dracolaxos/blob/main/kernel/bootmode.c"
click node_memory "https://github.com/aerixsystem/dracolaxos/tree/main/kernel/mm"
click node_scheduler "https://github.com/aerixsystem/dracolaxos/tree/main/kernel/sched"
click node_arch "https://github.com/aerixsystem/dracolaxos/tree/main/kernel/arch/x86_64"
click node_drivers "https://github.com/aerixsystem/dracolaxos/tree/main/kernel/drivers"
click node_framebuffer "https://github.com/aerixsystem/dracolaxos/blob/main/kernel/drivers/vga/fb.c"
click node_compositor "https://github.com/aerixsystem/dracolaxos/blob/main/gui/compositor/compositor.c"
click node_desktop "https://github.com/aerixsystem/dracolaxos/blob/main/gui/desktop/default-desktop/desktop.c"
click node_widgets "https://github.com/aerixsystem/dracolaxos/blob/main/gui/widgets/widgets.c"
click node_windowmgr "https://github.com/aerixsystem/dracolaxos/blob/main/gui/wm/wm.c"
click node_icons "https://github.com/aerixsystem/dracolaxos/blob/main/gui/icons/icon_data.h"
click node_appman "https://github.com/aerixsystem/dracolaxos/tree/main/kernel/appman"
click node_apps "https://github.com/aerixsystem/dracolaxos/tree/main/apps"
click node_vfs "https://github.com/aerixsystem/dracolaxos/blob/main/kernel/fs/vfs.c"
click node_ramfs "https://github.com/aerixsystem/dracolaxos/blob/main/kernel/fs/ramfs.c"
click node_procfs "https://github.com/aerixsystem/dracolaxos/blob/main/kernel/fs/procfs.c"
click node_network "https://github.com/aerixsystem/dracolaxos/blob/main/kernel/drivers/net/net_driver.c"
click node_services "https://github.com/aerixsystem/dracolaxos/tree/main/services"
click node_linuxcompat "https://github.com/aerixsystem/dracolaxos/tree/main/kernel/linux"
click node_lxscript "https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/lxscript.c"
click node_lexer "https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/lexer/lexer.c"
click node_parser "https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/parser/parser.c"
click node_codegen "https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/codegen/codegen.c"
click node_vm "https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/vm/vm.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_bootentry,node_bootmode,node_memory,node_scheduler,node_arch,node_drivers,node_user toneBlue
class node_framebuffer,node_compositor,node_desktop,node_widgets,node_windowmgr,node_icons toneAmber
class node_appman,node_apps,node_vfs,node_ramfs,node_procfs,node_network,node_services,node_linuxcompat toneMint
class node_lxscript,node_lexer,node_parser,node_codegen,node_vm toneRose
```

## Components

### Kernel and Hardware

- [Kernel Entry](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/main.c): `kernel/main.c`
- [Boot Mode](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/bootmode.c): `kernel/bootmode.c`
- [Memory Management](https://github.com/aerixsystem/dracolaxos/tree/main/kernel/mm): `kernel/mm`
- [Task Scheduler](https://github.com/aerixsystem/dracolaxos/tree/main/kernel/sched): `kernel/sched`
- [x86 Architecture](https://github.com/aerixsystem/dracolaxos/tree/main/kernel/arch/x86_64): `kernel/arch/x86_64`
- [Hardware Drivers](https://github.com/aerixsystem/dracolaxos/tree/main/kernel/drivers): `kernel/drivers`

### Graphical Environment

- [Framebuffer](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/drivers/vga/fb.c): `kernel/drivers/vga/fb.c`
- [Compositor](https://github.com/aerixsystem/dracolaxos/blob/main/gui/compositor/compositor.c): `gui/compositor/compositor.c`
- [Desktop](https://github.com/aerixsystem/dracolaxos/blob/main/gui/desktop/default-desktop/desktop.c): `gui/desktop/default-desktop/desktop.c`
- [Widget Toolkit](https://github.com/aerixsystem/dracolaxos/blob/main/gui/widgets/widgets.c): `gui/widgets/widgets.c`
- [Window Manager](https://github.com/aerixsystem/dracolaxos/blob/main/gui/wm/wm.c): `gui/wm/wm.c`
- [Icon Data](https://github.com/aerixsystem/dracolaxos/blob/main/gui/icons/icon_data.h): `gui/icons/icon_data.h`

### OS Facilities

- [App Manager](https://github.com/aerixsystem/dracolaxos/tree/main/kernel/appman): `kernel/appman`
- [Built-in Apps](https://github.com/aerixsystem/dracolaxos/tree/main/apps): `apps`
- [Virtual Filesystem](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/fs/vfs.c): `kernel/fs/vfs.c`
- [RAMFS](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/fs/ramfs.c): `kernel/fs/ramfs.c`
- [procfs](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/fs/procfs.c): `kernel/fs/procfs.c`
- [Network Stack](https://github.com/aerixsystem/dracolaxos/blob/main/kernel/drivers/net/net_driver.c): `kernel/drivers/net/net_driver.c`
- [System Services](https://github.com/aerixsystem/dracolaxos/tree/main/services): `services`
- [Linux Syscall Stubs](https://github.com/aerixsystem/dracolaxos/tree/main/kernel/linux): `kernel/linux`

### Language Runtime

- [LXScript](https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/lxscript.c): `lxscript/lxscript.c`
- [Lexer](https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/lexer/lexer.c): `lxscript/lexer/lexer.c`
- [Parser](https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/parser/parser.c): `lxscript/parser/parser.c`
- [Code Generator](https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/codegen/codegen.c): `lxscript/codegen/codegen.c`
- [Virtual Machine](https://github.com/aerixsystem/dracolaxos/blob/main/lxscript/vm/vm.c): `lxscript/vm/vm.c`

### Other components

- **OS User**

## Connections

- Kernel Entry → Boot Mode: initializes (evidence: `kernel/main.c`)
- Kernel Entry → x86 Architecture: initializes (evidence: `kernel/main.c`)
- Kernel Entry → Memory Management: initializes (evidence: `kernel/main.c`)
- Kernel Entry → Task Scheduler: initializes (evidence: `kernel/main.c`)
- Kernel Entry → Hardware Drivers: initializes (evidence: `kernel/main.c`)
- Kernel Entry → Framebuffer: initializes (evidence: `kernel/main.c`)
- Kernel Entry → Linux Syscall Stubs: initializes (evidence: `kernel/main.c`)
- Kernel Entry → OS User: boots
- Desktop → Compositor: uses (evidence: `gui/desktop/default-desktop/desktop.c`)
- Desktop → Widget Toolkit: uses (evidence: `gui/desktop/default-desktop/desktop.c`)
- Widget Toolkit → Compositor: draws through (evidence: `gui/widgets/widgets.c`)
- Compositor → Framebuffer: renders to (evidence: `gui/compositor/compositor.c`)
- Compositor → Icon Data: uses (evidence: `gui/compositor/compositor.c`)
- Desktop → Window Manager: uses (evidence: `gui/desktop/default-desktop/desktop.c`)
- Desktop → App Manager: uses (evidence: `gui/desktop/default-desktop/desktop.c`)
- App Manager → Built-in Apps: launches
- Virtual Filesystem → RAMFS: supports
- Virtual Filesystem → procfs: supports
- System Services → Network Stack: manages
- LXScript → Lexer: uses
- LXScript → Parser: uses
- LXScript → Code Generator: uses
- LXScript → Virtual Machine: uses
