# jakoolit/hyprland-dots architecture

> Architecture diagram of the GitHub repository jakoolit/hyprland-dots, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-02-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jakoolit/hyprland-dots
- Repository: https://github.com/jakoolit/hyprland-dots

## Overview

##### Project Type and Purpose
This is a desktop environment configuration project centered around Hyprland (a Wayland compositor), featuring a complete suite of customization tools and configurations for a Linux desktop environment.

##### Main Components

Core Components:
- Hyprland (Window Manager/Compositor)
- Waybar (Status Bar)
- AGS (Widget System)
- Configuration Management
- Theme Management (Wallust)
- User Interface Elements

A. Primary Layer (Core Components):
**┌─────────────────────────────────────────┐**
- Hyprland Compositor          │
- ┘

B. Interface Layer:
**┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐**
- Waybar  │ │  Rofi   │ │  AGS    │ │ Wlogout │
- (Status  │ │(Launcher│ │(Widgets)│ │(Session)│
- Bar)   │ │ Menu)   │ │         │ │         │
- ┘ └─────────┘ └─────────┘ └─────────┘

C. Configuration Management Layer:
**┌─────────────────────────────────────────────┐**
- Configuration System           │
- ┐ ┌─────────┐ ┌─────────┐ ┌───────┤
- Hypr    │ │ Theme   │ │ Wallust │ │ User  │
- Config  │ │ Manager │ │         │ │Scripts│
- ┘ └─────────┘ └─────────┘ └───────┘

D. Theme/Style Layer:
**┌─────────────────────────────────────────┐**
- Theme Components             │
- ┐ ┌────────┐ ┌────────┐ ┌──────┤
- ┘ └────────┘ └────────┘ └──────┘

##### Important Elements to Highlight

- Blue hexagons for core components
- Green rectangles for user interface elements
- Orange rounded rectangles for configuration components
- Purple diamonds for theme/style components

##### Notes Section

A notes section explaining:
- Installation requirements
- Dependencies
- Configuration hierarchy
- Update/upgrade procedures

## Diagram (Mermaid)

```mermaid
graph TB
    %% Core Components
    subgraph Core
        Hyprland[("Hyprland Compositor")]:::core
    end

    %% Interface Layer
    subgraph Interface
        Waybar["Waybar Status Bar"]:::interface
        Rofi["Rofi Launcher"]:::interface
        AGS["AGS Widget System"]:::interface
        Wlogout["Wlogout Session"]:::interface
    end

    %% Configuration Management Layer
    subgraph ConfigSystem
        ConfigMgmt["Configuration Management"]:::config
        ThemeMgr["Theme Manager"]:::config
        Wallust["Wallust"]:::config
        UserScripts["User Scripts"]:::config
        SysScripts["System Scripts"]:::config
        WallpaperEffects["Wallpaper Effects"]:::config
        Animations["Animation Configs"]:::config
    end

    %% Theme Layer
    subgraph ThemeComponents
        Kvantum["Kvantum Theme"]:::theme
        QtTheme["Qt Theming"]:::theme
        WaybarStyle["Waybar Styles"]:::theme
        StyleTemplates["Style Templates"]:::theme
    end

    %% Relationships
    Hyprland --> Waybar
    Hyprland --> AGS
    Hyprland --> Rofi
    Hyprland --> Wlogout
    
    ConfigMgmt --> Hyprland
    ThemeMgr --> Wallust
    Wallust --> Kvantum
    Wallust --> QtTheme
    Wallust --> WaybarStyle
    
    UserScripts --> Hyprland
    SysScripts --> Hyprland
    WallpaperEffects --> Hyprland
    Animations --> Hyprland
    
    StyleTemplates --> Wallust

    %% Click Events
    click Hyprland "https://github.com/JaKooLit/Hyprland-Dots/blob/main/config/hypr/hyprland.conf"
    click Waybar "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/waybar/"
    click AGS "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/ags/"
    click Rofi "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/rofi/"
    click Wlogout "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/wlogout/"
    click Wallust "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/wallust/"
    click Kvantum "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/Kvantum/"
    click QtTheme "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/qt5ct/"
    click ConfigMgmt "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/hypr/UserConfigs/"
    click UserScripts "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/hypr/UserScripts/"
    click WallpaperEffects "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/hypr/wallpaper_effects/"
    click Animations "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/hypr/animations/"
    click SysScripts "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/hypr/scripts/"
    click StyleTemplates "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/wallust/templates/"
    click WaybarStyle "https://github.com/JaKooLit/Hyprland-Dots/tree/main/config/waybar/style/"

    %% Styles
    classDef core fill:#3498db,stroke:#2980b9,stroke-width:2px
    classDef interface fill:#2ecc71,stroke:#27ae60,stroke-width:2px
    classDef config fill:#e67e22,stroke:#d35400,stroke-width:2px
    classDef theme fill:#9b59b6,stroke:#8e44ad,stroke-width:2px

    %% Legend
    subgraph Legend
        L1[("Core Component")]:::core
        L2["Interface Element"]:::interface
        L3["Configuration Component"]:::config
        L4["Theme Component"]:::theme
    end
```
