# laluka/skillarch architecture

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

- Interactive diagram: https://gitdiagram.com/laluka/skillarch
- Repository: https://github.com/laluka/skillarch

## Overview

##### Project Type & Purpose
- SkillArch is an open-source “dotfiles/configuration management” tool for provisioning and customizing a Linux desktop (CachyOS Gnome → i3wm).
- It uses Makefile targets, Bash scripts, Dockerfiles, and GitHub Actions to install packages, apply UI configs (i3, polybar, kitty, rofi, nvim, zsh, etc.), build Docker images (lite/full), and run CI security checks.

##### File-Structure Analysis
- Top‐Level files:
- Makefile – orchestrates install/update/docker workflows
- Dockerfile-lite / Dockerfile-full – define CLI‐only vs GUI‐enabled containers
- .github/workflows/cicd.yml – CI pipeline for security scans & image builds
- readme.md – project overview, install instructions, command reference
- Directories:
- config/ – all per-app dotfiles (i3, kitty, nvim, polybar, rofi, tmux, zsh, etc.)
- assets/ – logos, background PSDs for docs/branding
- .trivyignore, .gitignore – security & repo hygiene
- Patterns:
- Infrastructure-as-code: configs driven by scripts/Makefile
- Modular targets: install-base, install-cli-tools, install-gui, update, docker-build, docker-run
- CI/CD: GitHub Actions builds Docker images and runs Trivy/aquasecurity scans

##### Key README Insights
- Lists Makefile targets that map to install phases
- Explains CI badges, Docker Hub usage, security considerations
- Describes fork+upstream workflow (git remote merge strategy)
- Enumerates hundreds of packages, extensions, cloned repos and wordlists

##### Detail & Clarity
- Critical paths (e.g., “idempotent script applies configs”, “CI fails on scan error”)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Code Artifacts"
        Repo["GitHub Repo"]:::artifact
        Gitignore[".gitignore"]:::artifact
        TrivyIgnore[".trivyignore"]:::artifact
        Readme["readme.md"]:::artifact
        MakefileNode["Makefile & Bash Scripts"]:::artifact
        DockerLite["Dockerfile-lite"]:::artifact
        DockerFull["Dockerfile-full"]:::artifact
        subgraph "Configuration Store"
            i3conf["i3 config"]:::artifact
            polybarcfg["polybar config.ini"]:::artifact
            polybarlaunch["polybar launch.sh"]:::artifact
            kitty["kitty.conf"]:::artifact
            roficfg["rofi config.rasi"]:::artifact
            rofidark["rofi spotlight-dark.rasi"]:::artifact
            nvim["neovim init.lua"]:::artifact
            picom["picom.conf"]:::artifact
            tmux["tmux.conf"]:::artifact
            vimrc["vimrc"]:::artifact
            zshrc["zshrc"]:::artifact
            xorg["30-touchpad.conf"]:::artifact
            aliases["aliases"]:::artifact
            chromeext["chrome-extensions.lst"]:::artifact
            extensions["extensions.txt"]:::artifact
        end
        subgraph "Assets"
            bgpsd["bg.psd"]:::artifact
            logopsd["logo.psd"]:::artifact
        end
    end

    subgraph "Runtime Components"
        Local["Developer / User Local Machine"]:::runtime
        PM["Package Manager (pacman/yay)"]:::runtime
        DockerEngine["Docker Engine"]:::runtime
        ContainerLite["Container (lite)"]:::runtime
        ContainerFull["Container (full)"]:::runtime
        ConfigDir["~/.config"]:::runtime
    end

    subgraph "External Services"
        GHRunner["GitHub Actions Runner"]:::service
        DockerHub["Docker Hub"]:::service
        TrivyScan["Trivy Scan"]:::service
    end

    Repo -->|"git clone/pull"| Local
    Local -->|"make install-*"| MakefileNode
    MakefileNode -->|"install scripts"| PM
    MakefileNode -->|"apply configs"| ConfigDir
    Local -->|"make docker-build"| DockerEngine
    DockerEngine -->|"build lite"| ContainerLite
    DockerEngine -->|"build full"| ContainerFull

    Repo -->|"push/tag"| GHRunner
    GHRunner -->|"docker build & scan"| DockerEngine
    GHRunner -->|"trivy scan"| TrivyScan
    GHRunner -->|"push images"| DockerHub

    ContainerLite -.->|"mount X11 & config"| Local
    ContainerFull -.->|"mount X11 & config"| Local

    click GHRunner "https://github.com/laluka/skillarch/blob/main/.github/workflows/cicd.yml"
    click TrivyIgnore "https://github.com/laluka/skillarch/blob/main/.trivyignore"
    click Gitignore "https://github.com/laluka/skillarch/blob/main/.gitignore"
    click MakefileNode "https://github.com/laluka/skillarch/tree/main/Makefile"
    click DockerLite "https://github.com/laluka/skillarch/tree/main/Dockerfile-lite"
    click DockerFull "https://github.com/laluka/skillarch/tree/main/Dockerfile-full"
    click i3conf "https://github.com/laluka/skillarch/tree/main/config/i3/config"
    click polybarcfg "https://github.com/laluka/skillarch/blob/main/config/polybar/config.ini"
    click polybarlaunch "https://github.com/laluka/skillarch/blob/main/config/polybar/launch.sh"
    click kitty "https://github.com/laluka/skillarch/blob/main/config/kitty/kitty.conf"
    click roficfg "https://github.com/laluka/skillarch/blob/main/config/rofi/config.rasi"
    click rofidark "https://github.com/laluka/skillarch/blob/main/config/rofi/spotlight-dark.rasi"
    click nvim "https://github.com/laluka/skillarch/blob/main/config/nvim/init.lua"
    click picom "https://github.com/laluka/skillarch/blob/main/config/picom.conf"
    click tmux "https://github.com/laluka/skillarch/blob/main/config/tmux.conf"
    click vimrc "https://github.com/laluka/skillarch/tree/main/config/vimrc"
    click zshrc "https://github.com/laluka/skillarch/tree/main/config/zshrc"
    click xorg "https://github.com/laluka/skillarch/blob/main/config/xorg.conf.d/30-touchpad.conf"
    click aliases "https://github.com/laluka/skillarch/tree/main/config/aliases"
    click chromeext "https://github.com/laluka/skillarch/blob/main/config/chrome-extensions.lst"
    click extensions "https://github.com/laluka/skillarch/blob/main/config/extensions.txt"
    click bgpsd "https://github.com/laluka/skillarch/blob/main/assets/bg.psd"
    click logopsd "https://github.com/laluka/skillarch/blob/main/assets/logo.psd"
    click Readme "https://github.com/laluka/skillarch/blob/main/readme.md"

    classDef artifact fill:#BBDEFB,stroke:#0D47A1
    classDef runtime fill:#C8E6C9,stroke:#2E7D32
    classDef service fill:#FFE0B2,stroke:#E65100
```
