# regolith-linux/ilia architecture

> Architecture diagram of the GitHub repository regolith-linux/ilia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/regolith-linux/ilia
- Repository: https://github.com/regolith-linux/ilia

## Overview

##### Main Components

a. Core Application Layer:
- Configuration management system (Config.vala.base)
- Dialog window system (DialogWindow.vala)
- Utility services (IconLoader.vala, Util.vala)

b. Feature Pages (Modules):
- Apps Page (DesktopAppPage)
- Commands Page (CommandPage)
- Keybindings Page (KeybindingsPage)
- Notifications Page (RoficationPage)
- Text List Page (TextListPage)
- Tracker Page (TrackerPage)
- Windows Page (WindowPage)

c. External Services:
- I3 Window Manager (connected to Keybindings)
- Rofication Daemon (connected to Notifications)
- System File System (XDG_DATA_DIRS for apps)
- GSettings Configuration Store

##### Component Relationships

- Core Application → Feature Pages (ModuleApi.vala interface)
- Keybindings Page → I3 IPC (I3Ipc.vala)
- Notifications Page → Rofication Client
- Apps Page → XDG_DATA_DIRS
- Configuration → GSettings

**┌─ External Services ─────────────┐**
- ┌─────────┐ ┌────────────────┐ │
- I3    │ │   Rofication   │ │
- ┘ └────────────────┘ │
- ┬─┘

**┌─ Core Application ────────────┼─┐**
- ┌─────────┐ ┌──────────────┐ │ │
- Main   │ │ Application  │ │ │
- ┘ └──────────────┘ │ │
- ┌─────────┐ ┌──────────────┐ │ │
- Config  │ │ DialogWindow │ │ │
- ┘ └──────────────┘ │ │
- ┼─┘

**┌─ Feature Pages ───────────────┼─┐**
- ┌─────────┐ ┌──────────────┐ │ │
- Apps   │ │ Keybindings  │ │ │
- ┘ └──────────────┘ │ │
- ┌─────────┐ ┌──────────────┐ │ │
- Windows │ │Notifications │ │ │
- ┘ └──────────────┘ │ │
- ┘

##### Important Details
- ModuleApi interface between core and pages
- Configuration paths for GSettings
- File system access points
- IPC communication channels

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef core fill:#b3d1ff,stroke:#333
    classDef page fill:#90EE90,stroke:#333
    classDef external fill:#FFB366,stroke:#333
    classDef data fill:#E6E6E6,stroke:#333
    classDef interface fill:#FFE6CC,stroke:#333

    %% External Services Layer
    subgraph ExternalServices
        I3[I3 Window Manager]:::external
        Rofication[Rofication Daemon]:::external
        XDG[XDG_DATA_DIRS]:::external
        GSettings[GSettings Store]:::data
    end

    %% Core Application Layer
    subgraph CoreApp
        Main[Main]:::core
        App[Application]:::core
        Config[Configuration]:::core
        Dialog[Dialog Window]:::core
        ModuleApi[Module API]:::interface
        IconLoader[Icon Loader]:::core
        Util[Utilities]:::core
    end

    %% Feature Pages Layer
    subgraph FeaturePages
        AppsPage[Apps Page]:::page
        CommandsPage[Commands Page]:::page
        KeybindingsPage[Keybindings Page]:::page
        NotificationsPage[Notifications Page]:::page
        TextListPage[Text List Page]:::page
        TrackerPage[Tracker Page]:::page
        WindowsPage[Windows Page]:::page
    end

    %% Relationships
    Main --> App
    App --> Config
    App --> Dialog
    App --> ModuleApi
    App --> IconLoader
    App --> Util
    
    ModuleApi --> AppsPage
    ModuleApi --> CommandsPage
    ModuleApi --> KeybindingsPage
    ModuleApi --> NotificationsPage
    ModuleApi --> TextListPage
    ModuleApi --> TrackerPage
    ModuleApi --> WindowsPage

    KeybindingsPage --> I3
    NotificationsPage --> Rofication
    AppsPage --> XDG
    Config --> GSettings

    %% Click Events
    click Main "https://github.com/regolith-linux/ilia/blob/main/src/Main.vala"
    click App "https://github.com/regolith-linux/ilia/blob/main/src/Application.vala"
    click Config "https://github.com/regolith-linux/ilia/blob/main/src/Config.vala.base"
    click Dialog "https://github.com/regolith-linux/ilia/blob/main/src/DialogWindow.vala"
    click ModuleApi "https://github.com/regolith-linux/ilia/blob/main/src/ModuleApi.vala"
    click IconLoader "https://github.com/regolith-linux/ilia/blob/main/src/IconLoader.vala"
    click Util "https://github.com/regolith-linux/ilia/blob/main/src/Util.vala"
    click AppsPage "https://github.com/regolith-linux/ilia/blob/main/src/apps/DesktopAppPage.vala"
    click CommandsPage "https://github.com/regolith-linux/ilia/blob/main/src/commands/CommandPage.vala"
    click KeybindingsPage "https://github.com/regolith-linux/ilia/blob/main/src/keybindings/KeybindingsPage.vala"
    click NotificationsPage "https://github.com/regolith-linux/ilia/blob/main/src/notifications/RoficationPage.vala"
    click TextListPage "https://github.com/regolith-linux/ilia/blob/main/src/textlist/TextListPage.vala"
    click TrackerPage "https://github.com/regolith-linux/ilia/blob/main/src/tracker/TrackerPage.vala"
    click WindowsPage "https://github.com/regolith-linux/ilia/blob/main/src/windows/WindowPage.vala"
    click GSettings "https://github.com/regolith-linux/ilia/blob/main/data/org.regolith-linux.ilia.gschema.xml"

    %% Legend
    subgraph Legend
        CoreComponent[Core Component]:::core
        PageComponent[Feature Page]:::page
        ExternalComponent[External Service]:::external
        DataComponent[Data Store]:::data
        InterfaceComponent[Interface]:::interface
    end
```
