# mon4sm/monasm-dots architecture

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

- Interactive diagram: https://gitdiagram.com/mon4sm/monasm-dots
- Repository: https://github.com/mon4sm/monasm-dots

## Overview

##### Project type and purpose
- This is a “dotfiles” repository for configuring an Arch Linux desktop environment.
- Its goal is to set up and customize:
- A Wayland compositor (Hyprland)
- Widget/status bar framework (EWW) with custom scripts
- Terminal emulator (Kitty)
- Neovim editor with plugin ecosystem
- Prompt (Starship) and system info (Fastfetch)
- It’s essentially a collection of configuration files and helper scripts that, when applied, produce a cohesive user environment.

##### File structure
- Top-level “.config” directories map to each application’s config folder.
- Key directories:
- .config/hypr → Hyprland config + window-management scripts
- .config/eww → EWW UI definitions (yuck/scss) + status scripts
- .config/kitty → Terminal emulator theming
- .config/nvim → Neovim init.lua + plugin configs/lua modules
- .config/fastfetch → Fastfetch system info template
- starship.toml + font/ + install/ → supplementary configs and installer code
- No traditional “frontend/backend,” but rather a pipeline: configuration → application → display.

##### README for additional insights
- Confirms tools in use (Hyprland, EWW, Kitty).
- Mentions an upcoming automated install script.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Installer
    Installer["Installer Script"]:::installer

    %% Configuration Artifacts
    subgraph "Configuration Artifacts"
        direction TB
        HyprlandConfig[".config/hypr (Hyprland Configs)"]:::config
        EWWConfig[".config/eww (EWW Configs)"]:::config
        KittyConfig[".config/kitty (Kitty Configs)"]:::config
        NVIMConfig[".config/nvim (Neovim Config)"]:::config
        FastfetchConfig[".config/fastfetch"]:::config
        StarshipConfig["starship.toml"]:::config
    end

    %% Scripts Middleware
    subgraph "Script Collection"
        direction TB
        HyprScripts[".config/hypr/scripts"]:::config
        EwwScripts[".config/eww/scripts"]:::config
    end

    %% Compositor/UI Layer
    subgraph "Compositor/UI Layer"
        direction TB
        Hyprland["Hyprland Compositor"]:::compUI
        EWW["EWW Widget Engine"]:::compUI
    end

    %% CLI Tools Layer
    subgraph "CLI Tools"
        direction TB
        Kitty["Kitty Terminal"]:::cli
        Starship["Starship Prompt"]:::cli
        Fastfetch["Fastfetch Info Renderer"]:::cli
        Neovim["Neovim Editor"]:::cli
    end

    %% Persistent Resources
    Font(("Font Resources")):::resource

    %% Relationships
    Installer -->|deploys configs to| HyprlandConfig
    Installer -->|deploys configs to| EWWConfig
    Installer -->|deploys configs to| KittyConfig
    Installer -->|deploys configs to| NVIMConfig
    Installer -->|deploys configs to| FastfetchConfig
    Installer -->|deploys config to| StarshipConfig
    Installer -->|installs fonts in| Font

    HyprlandConfig -->|reads| Hyprland
    Hyprland -->|spawns| EWW
    EWWConfig -->|reads| EWW

    HyprlandConfig --> HyprScripts
    EWWConfig --> EwwScripts

    HyprScripts -->|provides data to| Hyprland
    EwwScripts -->|provides data to| EWW

    KittyConfig -->|reads| Kitty
    Kitty -->|uses| Starship
    StarshipConfig -->|configures| Starship
    Kitty -->|launches shell ->| Neovim
    NVIMConfig -->|reads| Neovim

    FastfetchConfig -->|reads| Fastfetch
    EwwScripts -->|invoke| Fastfetch

    Font -->|used by| Kitty
    Font -->|used by| Hyprland
    Font -->|used by| Neovim

    %% Click Events
    click HyprlandConfig "https://github.com/mon4sm/monasm-dots/tree/main/.config/hypr"
    click HyprScripts "https://github.com/mon4sm/monasm-dots/tree/main/.config/hypr/scripts"
    click EWWConfig "https://github.com/mon4sm/monasm-dots/tree/main/.config/eww"
    click EwwScripts "https://github.com/mon4sm/monasm-dots/tree/main/.config/eww/scripts"
    click KittyConfig "https://github.com/mon4sm/monasm-dots/tree/main/.config/kitty"
    click NVIMConfig "https://github.com/mon4sm/monasm-dots/tree/main/.config/nvim"
    click FastfetchConfig "https://github.com/mon4sm/monasm-dots/tree/main/.config/fastfetch"
    click StarshipConfig "https://github.com/mon4sm/monasm-dots/blob/main/starship.toml"
    click Font "https://github.com/mon4sm/monasm-dots/tree/main/font"
    click Installer "https://github.com/mon4sm/monasm-dots/blob/main/install/install.c"

    %% Styles
    classDef compUI fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef cli fill:#98FB98,stroke:#333,stroke-width:1px
    classDef config fill:#FFDAB9,stroke:#333,stroke-width:1px
    classDef resource fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef installer fill:#FFB6C1,stroke:#333,stroke-width:1px
```
