# jimuelportugal/.dofile architecture

> Architecture diagram of the GitHub repository jimuelportugal/.dofile, 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/jimuelportugal/.dofile
- Repository: https://github.com/jimuelportugal/.dofile

## Overview

This repository is a personal Linux desktop configuration for Hyprland, with an installer for deploying the configuration and documented desktop workflows such as opening the app drawer and quick-settings panel. The graph groups configuration by desktop responsibility and includes the documented CLI mode switchers. No source excerpts were provided, so relationships are limited to those stated in the README; implementation-level calls and integrations are not inferred.

Main entry points: [`.config/hypr/hyprland.lua`](https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/hyprland.lua) (Hyprland Configuration), [`install.sh`](https://github.com/jimuelportugal/.dofile/blob/main/install.sh) (Dotfiles Installer), [`.bashrc`](https://github.com/jimuelportugal/.dofile/blob/main/.bashrc) (Shell Configuration), [`.config/hypr/scripts/drawer.py`](https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/scripts/drawer.py) (App Drawer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and Tools"]
  node_installer["Dotfiles Installer<br/>[install.sh]"]
  node_shell["Shell Configuration<br/>[.bashrc]"]
  node_repo_cli["Dotfiles Git CLI<br/>[dotfiles-git]"]
  node_hypr_lua_cli["Lua Mode Switcher<br/>[hypr-lua]"]
  node_hypr_conf_cli["Fallback Mode Switcher<br/>[hypr-conf]"]
  node_hypr_status["Mode Status CLI<br/>[hypr-status]"]
end

subgraph group_session["Hyprland Session"]
  node_hypr["Hyprland Configuration<br/>[hyprland.lua]"]
  node_drawer["App Drawer<br/>[drawer.py]"]
  node_quicksettings["Quick Settings<br/>[quicksettings.py]"]
  node_workspace["Workspace Switcher"]
  node_screenshot["Active Screenshot"]
end

subgraph group_desktop["Desktop Interface"]
  node_waybar["Waybar Status Bar<br/>[config.jsonc]"]
  node_slider["Slider Popup<br/>[slider-popup.py]"]
  node_logout["Session Power Menu<br/>[layout]"]
  node_gtk["GTK Theme<br/>[gtk.css]"]
  node_thunar["Thunar Actions<br/>[uca.xml]"]
  node_thunar_prefs["Thunar Preferences<br/>[thunar.xml]"]
end

subgraph group_system["System Configuration"]
  node_fcitx["Input Method<br/>[config]"]
  node_remapper["Device Remapping<br/>[config.json]"]
  node_pipewire["Audio Routing<br/>[reverse-audio.conf]"]
  node_wifi_menu["Wi-Fi Menu Styling<br/>[wifi.rasi]"]
  node_drawer_style["Drawer Styling<br/>[drawer.css]"]
end

node_user(("Desktop User"))

node_user -->|"runs setup"| node_installer
node_installer -->|"links configuration"| node_hypr
node_installer -->|"configures PATH"| node_shell
node_user -->|"uses desktop"| node_hypr
node_hypr -->|"opens on Super+A"| node_drawer
node_hypr -->|"opens on Super+S"| node_quicksettings

click node_installer "https://github.com/jimuelportugal/.dofile/blob/main/install.sh"
click node_shell "https://github.com/jimuelportugal/.dofile/blob/main/.bashrc"
click node_repo_cli "https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/dotfiles-git"
click node_hypr_lua_cli "https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/hypr-lua"
click node_hypr_conf_cli "https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/hypr-conf"
click node_hypr_status "https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/hypr-status"
click node_hypr "https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/hyprland.lua"
click node_drawer "https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/scripts/drawer.py"
click node_quicksettings "https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/scripts/quicksettings.py"
click node_workspace "https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/scripts/scroll-workspace.sh"
click node_screenshot "https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/screenshot-active.sh"
click node_waybar "https://github.com/jimuelportugal/.dofile/blob/main/.config/waybar/config.jsonc"
click node_slider "https://github.com/jimuelportugal/.dofile/blob/main/.config/waybar/scripts/slider-popup.py"
click node_logout "https://github.com/jimuelportugal/.dofile/blob/main/.config/wlogout/layout"
click node_gtk "https://github.com/jimuelportugal/.dofile/blob/main/.config/gtk-3.0/gtk.css"
click node_thunar "https://github.com/jimuelportugal/.dofile/blob/main/.config/Thunar/uca.xml"
click node_thunar_prefs "https://github.com/jimuelportugal/.dofile/blob/main/.config/xfce4/xfconf/xfce-perchannel-xml/thunar.xml"
click node_fcitx "https://github.com/jimuelportugal/.dofile/blob/main/.config/fcitx5/config"
click node_remapper "https://github.com/jimuelportugal/.dofile/blob/main/.config/input-remapper-2/config.json"
click node_pipewire "https://github.com/jimuelportugal/.dofile/blob/main/.config/pipewire/pipewire.conf.d/reverse-audio.conf"
click node_wifi_menu "https://github.com/jimuelportugal/.dofile/blob/main/.config/rofi/wifi.rasi"
click node_drawer_style "https://github.com/jimuelportugal/.dofile/blob/main/.config/nwg-drawer/drawer.css"

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_installer,node_shell,node_repo_cli,node_hypr_lua_cli,node_hypr_conf_cli,node_hypr_status,node_user toneBlue
class node_hypr,node_drawer,node_quicksettings,node_workspace,node_screenshot toneAmber
class node_waybar,node_slider,node_logout,node_gtk,node_thunar,node_thunar_prefs toneMint
class node_fcitx,node_remapper,node_pipewire,node_wifi_menu,node_drawer_style toneRose
```

## Components

### Setup and Tools

- [Dotfiles Installer](https://github.com/jimuelportugal/.dofile/blob/main/install.sh): `install.sh`
- [Shell Configuration](https://github.com/jimuelportugal/.dofile/blob/main/.bashrc): `.bashrc`
- [Dotfiles Git CLI](https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/dotfiles-git): `.local/bin/dotfiles-git`
- [Lua Mode Switcher](https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/hypr-lua): `.local/bin/hypr-lua`
- [Fallback Mode Switcher](https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/hypr-conf): `.local/bin/hypr-conf`
- [Mode Status CLI](https://github.com/jimuelportugal/.dofile/blob/main/.local/bin/hypr-status): `.local/bin/hypr-status`

### Hyprland Session

- [Hyprland Configuration](https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/hyprland.lua): `.config/hypr/hyprland.lua`
- [App Drawer](https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/scripts/drawer.py): `.config/hypr/scripts/drawer.py`
- [Quick Settings](https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/scripts/quicksettings.py): `.config/hypr/scripts/quicksettings.py`
- [Workspace Switcher](https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/scripts/scroll-workspace.sh): `.config/hypr/scripts/scroll-workspace.sh`
- [Active Screenshot](https://github.com/jimuelportugal/.dofile/blob/main/.config/hypr/screenshot-active.sh): `.config/hypr/screenshot-active.sh`

### Desktop Interface

- [Waybar Status Bar](https://github.com/jimuelportugal/.dofile/blob/main/.config/waybar/config.jsonc): `.config/waybar/config.jsonc`
- [Slider Popup](https://github.com/jimuelportugal/.dofile/blob/main/.config/waybar/scripts/slider-popup.py): `.config/waybar/scripts/slider-popup.py`
- [Session Power Menu](https://github.com/jimuelportugal/.dofile/blob/main/.config/wlogout/layout): `.config/wlogout/layout`
- [GTK Theme](https://github.com/jimuelportugal/.dofile/blob/main/.config/gtk-3.0/gtk.css): `.config/gtk-3.0/gtk.css`
- [Thunar Actions](https://github.com/jimuelportugal/.dofile/blob/main/.config/Thunar/uca.xml): `.config/Thunar/uca.xml`
- [Thunar Preferences](https://github.com/jimuelportugal/.dofile/blob/main/.config/xfce4/xfconf/xfce-perchannel-xml/thunar.xml): `.config/xfce4/xfconf/xfce-perchannel-xml/thunar.xml`

### System Configuration

- [Input Method](https://github.com/jimuelportugal/.dofile/blob/main/.config/fcitx5/config): `.config/fcitx5/config`
- [Device Remapping](https://github.com/jimuelportugal/.dofile/blob/main/.config/input-remapper-2/config.json): `.config/input-remapper-2/config.json`
- [Audio Routing](https://github.com/jimuelportugal/.dofile/blob/main/.config/pipewire/pipewire.conf.d/reverse-audio.conf): `.config/pipewire/pipewire.conf.d/reverse-audio.conf`
- [Wi-Fi Menu Styling](https://github.com/jimuelportugal/.dofile/blob/main/.config/rofi/wifi.rasi): `.config/rofi/wifi.rasi`
- [Drawer Styling](https://github.com/jimuelportugal/.dofile/blob/main/.config/nwg-drawer/drawer.css): `.config/nwg-drawer/drawer.css`

### Other components

- **Desktop User**

## Connections

- Desktop User → Dotfiles Installer: runs setup (evidence: `README.md`)
- Dotfiles Installer → Hyprland Configuration: links configuration (evidence: `README.md`)
- Dotfiles Installer → Shell Configuration: configures PATH (evidence: `README.md`)
- Desktop User → Hyprland Configuration: uses desktop (evidence: `README.md`)
- Hyprland Configuration → App Drawer: opens on Super+A (evidence: `README.md`)
- Hyprland Configuration → Quick Settings: opens on Super+S (evidence: `README.md`)
