# evren-os/hyprblaze architecture

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

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

## Overview

##### Main System Components

a) Core System Layer
- Hyprland (Window Manager)
- SDDM (Display Manager)
- System Services & Utilities

b) Configuration Layer
- Theme Engine
- Wallpaper Management
- Application Configs

c) User Interface Layer
- Waybar
- Rofi Launchers
- Notification System

##### Component Relationships

a) Theme Management Flow:
**Theme Engine (hyde) → Configuration Files → UI Components**
- ↓
- Wallbash System → Application Theming

b) User Interaction Flow:
**User Input → Keybinding Handler → System Actions**
- ↓
- Rofi Launchers → Applications/Scripts

##### Detailed Component Breakdown

Create subsections showing:

a) Configuration Management:
**/Configs/.config/**
- hypr/        (Window Manager Config)
- waybar/      (Status Bar)
- rofi/        (Application Launcher)
- themes/      (Theme Configurations)

b) Script Architecture:
**/Scripts/**
- install.sh   (Main Installation)
- restore_cfg.sh (Config Management)
- wallbash.sh  (Theme Generation)

##### Integration Points

Integration points:
- Theme Engine ↔ Application Configs
- Keybinding System ↔ Global Controls

##### Data Flow

Flow of:
- User Configuration Changes
- Theme Updates
- System Events
- Notifications

##### Implementation Details

Technical notes for:
- Configuration File Formats
- Theme Generation Process
- Installation Dependencies
- Update Mechanisms

##### The integration between components

Use standardized symbols:
- Rectangles: Components
- Diamonds: Decision Points

This system design should help developers understand both the high-level architecture and the detailed interactions between components while maintaining clarity about the project's primary purpose as a highly customizable desktop environment configuration system.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and Classes
    classDef core fill:#a4c2f4,stroke:#2f528f
    classDef config fill:#b6d7a8,stroke:#274e13
    classDef ui fill:#d5a6bd,stroke:#741b47
    classDef script fill:#f9cb9c,stroke:#b45f06
    classDef storage fill:#ead1dc,stroke:#741b47

    %% Legend
    subgraph Legend
        L1[Core Components]:::core
        L2[Configuration Components]:::config
        L3[User Interface Elements]:::ui
        L4[Scripts & Utilities]:::script
        L5[(Storage & Configs)]:::storage
    end

    %% Core System Layer
    subgraph CoreSystem
        Hyprland[Hyprland Window Manager]:::core
        SDDM[SDDM Display Manager]:::core
        SystemServices[System Services]:::core
    end

    %% Configuration Layer
    subgraph ConfigLayer
        ThemeEngine["Theme Engine (hyde)"]:::config
        WallpaperMgmt[Wallpaper Management]:::config
        AppConfigs[(Application Configs)]:::storage
        ConfigMgmt[Configuration Management]:::script
    end

    %% User Interface Layer
    subgraph UILayer
        Waybar[Waybar Status Bar]:::ui
        Rofi[Rofi Launchers]:::ui
        Notifications[Notification System]:::ui
        LockScreen[Lock Screen]:::ui
    end

    %% System Controls
    subgraph Controls
        VolumeCtrl[Volume Control]:::script
        BrightnessCtrl[Brightness Control]:::script
        GlobalCtrl[Global Control]:::script
    end

    %% Theme Management
    subgraph ThemeSystem
        WallbashEngine[Wallbash System]:::script
        GTKTheme[(GTK Theme)]:::storage
        QTTheme[(QT Theme)]:::storage
        Terminal[(Terminal Config)]:::storage
    end

    %% Relationships
    Hyprland --> WallpaperMgmt
    ThemeEngine --> AppConfigs
    ThemeEngine --> WallbashEngine
    WallbashEngine --> GTKTheme
    WallbashEngine --> QTTheme
    WallbashEngine --> Terminal
    ConfigMgmt --> AppConfigs
    Rofi --> SystemServices
    GlobalCtrl --> VolumeCtrl
    GlobalCtrl --> BrightnessCtrl

    %% Click Events
    click Hyprland "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/hypr/"
    click ThemeEngine "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/hyde/"
    click Waybar "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/waybar/"
    click Rofi "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/rofi/"
    click Notifications "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/dunst/"
    click WallpaperMgmt "https://github.com/Evren-os/hyprblaze/blob/main/Configs/.local/share/bin/swwwallpaper.sh"
    click WallbashEngine "https://github.com/Evren-os/hyprblaze/blob/main/Configs/.local/share/bin/wallbash.sh"
    click ConfigMgmt "https://github.com/Evren-os/hyprblaze/blob/main/Scripts/restore_cfg.sh"
    click GTKTheme "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/gtk-3.0/"
    click QTTheme "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/qt5ct/"
    click Terminal "https://github.com/Evren-os/hyprblaze/tree/main/Configs/.config/alacritty/"
    click LockScreen "https://github.com/Evren-os/hyprblaze/blob/main/Configs/.config/hypr/hyprlock.conf"
    click VolumeCtrl "https://github.com/Evren-os/hyprblaze/blob/main/Configs/.local/share/bin/volumecontrol.sh"
    click BrightnessCtrl "https://github.com/Evren-os/hyprblaze/blob/main/Configs/.local/share/bin/brightnesscontrol.sh"
    click GlobalCtrl "https://github.com/Evren-os/hyprblaze/blob/main/Configs/.local/share/bin/globalcontrol.sh"
```
