# urbanisierung/dotfiles architecture

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

- Interactive diagram: https://gitdiagram.com/urbanisierung/dotfiles
- Repository: https://github.com/urbanisierung/dotfiles

## Overview

##### Core Components (Main Layer)
- "System Configuration" as a parent container encompassing all components

##### Configuration Groups (Secondary Layer)
Create distinct groups for:
a. Window Management
- i3 config
- i3blocks (status bar)
- Screen layout
- Wallpaper management

b. Shell Environment
- ZSH configuration
- Starship prompt
- Terminal utilities

c. Development Tools
- VSCode configuration
- Docker setup
- Development utilities

##### System Integration Layer
Connections between:
- Scripts directory (system control scripts)
- Backup/Sync mechanisms
- External tools integration

##### Status and Monitoring
- System metrics (CPU, memory, disk)
- Network status
- Device status (battery, brightness)
- External services (weather, updates)

##### Component Representations
- Rectangles: Core components
- Rounded rectangles: Configuration files
- Hexagons: Scripts and utilities
- Circles: External services

Key Elements to Include:

##### Configuration Flow
- How sync.sh connects to various configuration locations
- Backup paths and mechanisms

##### Script Integration
- How scripts interact with system components
- Automation workflows

##### Tool Chain
- VSCode integration
- Container tooling connections
- Development utility integration

##### Status Bar Architecture
- Detail i3blocks module organization
- Data flow for system monitoring

Special Considerations:

##### Modular nature of the configuration
- How components can be individually synchronized
- Independence of different tools

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph System_Configuration
        i3Core["i3 Window Manager"]:::core
        click i3Core "https://github.com/urbanisierung/dotfiles/tree/master/i3/config"

        subgraph Window_Management
            i3Config["i3 Configuration"]:::config
            i3Blocks["i3blocks Status Bar"]:::config
            click i3Blocks "https://github.com/urbanisierung/dotfiles/blob/master/i3/i3blocks.conf"
            ScreenLayout["Screen Layout"]:::config
            click ScreenLayout "https://github.com/urbanisierung/dotfiles/blob/master/screenlayout/workplace.sh"
            Wallpaper["Wallpaper System"]:::config
            click Wallpaper "https://github.com/urbanisierung/dotfiles/tree/master/wallpaper/"
        end

        subgraph Shell_Environment
            ZSH["ZSH Config"]:::shell
            click ZSH "https://github.com/urbanisierung/dotfiles/blob/master/config/.zshrc"
            Starship["Starship Prompt"]:::shell
            click Starship "https://github.com/urbanisierung/dotfiles/blob/master/config/starship.toml"
            TermUtils["Terminal Utilities"]:::utils
        end

        subgraph Development_Tools
            VSCode["VSCode Setup"]:::dev
            click VSCode "https://github.com/urbanisierung/dotfiles/blob/master/vscode/extensions.sh"
            VSCodeExt["VSCode Extensions"]:::dev
            click VSCodeExt "https://github.com/urbanisierung/dotfiles/blob/master/vscode/vs_code_extensions_list.txt"
            Docker["Docker Setup"]:::dev
            DevUtils["Dev Utilities"]:::utils
        end

        subgraph System_Integration
            Scripts["System Scripts"]:::scripts
            click Scripts "https://github.com/urbanisierung/dotfiles/tree/master/scripts/"
            Backup["Backup System"]:::scripts
            click Backup "https://github.com/urbanisierung/dotfiles/blob/master/backup.sh"
            HomeBackup["Home Backup"]:::scripts
            click HomeBackup "https://github.com/urbanisierung/dotfiles/blob/master/homebackup.mjs"
            Sync["Sync Mechanism"]:::scripts
            click Sync "https://github.com/urbanisierung/dotfiles/blob/master/sync.sh"
        end

        subgraph Status_Monitoring
            SystemMetrics["System Metrics"]:::monitor
            click SystemMetrics "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/"
            
            subgraph Metrics
                CPU["CPU"]:::metric
                click CPU "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/cpu"
                Memory["Memory"]:::metric
                click Memory "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/memory"
                Disk["Disk"]:::metric
                click Disk "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/disk"
            end

            subgraph Network
                Bandwidth["Bandwidth"]:::network
                click Bandwidth "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/bandwidth"
                WiFi["WiFi"]:::network
                click WiFi "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/wifi"
                NetStatus["Network Status"]:::network
                click NetStatus "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/network"
            end

            subgraph Device_Status
                Battery["Battery"]:::device
                click Battery "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/battery"
                Brightness["Brightness"]:::device
                click Brightness "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/brightness"
                Temp["Temperature"]:::device
                click Temp "https://github.com/urbanisierung/dotfiles/tree/master/i3blocks/temperature"
            end
        end

        subgraph System_Control
            PowerMgmt["Power Management"]:::control
            click PowerMgmt "https://github.com/urbanisierung/dotfiles/tree/master/bin/i3exit"
            DisplayMgmt["Display Management"]:::control
            click DisplayMgmt "https://github.com/urbanisierung/dotfiles/tree/master/bin/i3undock"
            
            subgraph Audio
                VolUp["Volume Up"]:::audio
                click VolUp "https://github.com/urbanisierung/dotfiles/blob/master/scripts/volup.sh"
                VolDown["Volume Down"]:::audio
                click VolDown "https://github.com/urbanisierung/dotfiles/blob/master/scripts/voldown.sh"
                VolToggle["Volume Toggle"]:::audio
                click VolToggle "https://github.com/urbanisierung/dotfiles/blob/master/scripts/voltoggle.sh"
            end
        end
    end

    %% Connections
    i3Core --> Window_Management
    i3Core --> Shell_Environment
    i3Core --> Development_Tools
    i3Core --> System_Integration
    i3Core --> Status_Monitoring
    i3Core --> System_Control

    %% Styles
    classDef core fill:#3498db,stroke:#2980b9,stroke-width:2px
    classDef config fill:#2ecc71,stroke:#27ae60,stroke-width:2px
    classDef shell fill:#3498db,stroke:#2980b9,stroke-width:2px
    classDef utils fill:#e67e22,stroke:#d35400,stroke-width:2px
    classDef dev fill:#9b59b6,stroke:#8e44ad,stroke-width:2px
    classDef scripts fill:#e67e22,stroke:#d35400,stroke-width:2px
    classDef monitor fill:#f1c40f,stroke:#f39c12,stroke-width:2px
    classDef metric fill:#1abc9c,stroke:#16a085,stroke-width:2px
    classDef network fill:#e74c3c,stroke:#c0392b,stroke-width:2px
    classDef device fill:#95a5a6,stroke:#7f8c8d,stroke-width:2px
    classDef control fill:#34495e,stroke:#2c3e50,stroke-width:2px
    classDef audio fill:#e74c3c,stroke:#c0392b,stroke-width:2px
```
