# dhruvmistry2000/mybash architecture

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

- Interactive diagram: https://gitdiagram.com/dhruvmistry2000/mybash
- Repository: https://github.com/dhruvmistry2000/mybash

## Overview

##### Project type and purpose
- This is a user‐environment bootstrapper for Linux shells (a configuration/installation tool).
- Its goal is to automate installing and configuring tools like Starship, fzf, zoxide, Fastfetch, Rofi NM, blueman, and personalized Bash settings.

##### File structure
- Top‐level files:
– setup.sh: the entry point script that orchestrates everything
– config.jsonc: parameter store for tool versions or options
– starship.toml, .bashrc, .vimrc: configuration artifacts to be deployed
– .github/workflows/main.yml: CI pipeline to lint or test scripts on push
- Directory execution_scripts:
– compile_setup.sh, fastfetch.sh, numlock.sh, rofi_nm.sh, yay_setup.sh, etc.
– Each one installs or configures a specific component

##### README for additional insights
- Lists the key tools, their roles, and the single‐command installation approach.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entities
    User["User / Local Host"]:::user
    Repo["GitHub Repo (Source of Truth)"]:::repo
    Actions["GitHub Actions CI"]:::ci
    setup["setup.sh (Orchestrator)"]:::orchestrator
    config["config.jsonc"]:::config

    %% Execution Scripts Subgraph
    subgraph "Execution Scripts"
        direction TB
        compile["compile_setup.sh"]:::script
        fastfetch["fastfetch.sh"]:::script
        numlock["numlock.sh"]:::script
        rofi["rofi_nm.sh"]:::script
        yay["yay_setup.sh"]:::script
    end

    %% External Package Sources
    subgraph "External Package Sources"
        direction TB
        APT["apt / pacman"]:::external
        YAYPM["yay"]:::external
        GHREL["GitHub Releases"]:::external
    end

    %% Config Files
    bashrc[".bashrc"]:::config
    vimrc[".vimrc"]:::config
    starship["starship.toml"]:::config

    %% Home Directory
    Home["User Home Directory"]:::home

    %% Relationships
    User -->|"clones / pulls"| Repo
    Repo -->|push triggers| Actions
    Actions -->|"validation status"| Repo
    User -->|"runs single-command install"| setup
    setup -->|"reads parameters"| config
    setup -->|"delegates to"| compile
    setup -->|"delegates to"| fastfetch
    setup -->|"delegates to"| numlock
    setup -->|"delegates to"| rofi
    setup -->|"delegates to"| yay

    compile -->|"installs via"| APT
    fastfetch -->|"installs via"| GHREL
    numlock -->|"installs via"| APT
    rofi -->|"installs via"| GHREL
    yay -->|"installs via"| YAYPM

    compile -->|"deploys config to"| Home
    fastfetch -->|"deploys config to"| Home
    numlock -->|"deploys config to"| Home
    rofi -->|"deploys config to"| Home
    yay -->|"deploys config to"| Home

    Repo -->|"contains"| bashrc
    Repo -->|"contains"| vimrc
    Repo -->|"contains"| starship

    bashrc -->|"links to"| Home
    vimrc -->|"links to"| Home
    starship -->|"links to"| Home

    %% Click Events
    click setup "https://github.com/dhruvmistry2000/mybash/blob/main/setup.sh"
    click config "https://github.com/dhruvmistry2000/mybash/blob/main/config.jsonc"
    click compile "https://github.com/dhruvmistry2000/mybash/blob/main/execution_scripts/compile_setup.sh"
    click fastfetch "https://github.com/dhruvmistry2000/mybash/blob/main/execution_scripts/fastfetch.sh"
    click numlock "https://github.com/dhruvmistry2000/mybash/blob/main/execution_scripts/numlock.sh"
    click rofi "https://github.com/dhruvmistry2000/mybash/blob/main/execution_scripts/rofi_nm.sh"
    click yay "https://github.com/dhruvmistry2000/mybash/blob/main/execution_scripts/yay_setup.sh"
    click bashrc "https://github.com/dhruvmistry2000/mybash/blob/main/.bashrc"
    click vimrc "https://github.com/dhruvmistry2000/mybash/blob/main/.vimrc"
    click starship "https://github.com/dhruvmistry2000/mybash/blob/main/starship.toml"
    click Actions "https://github.com/dhruvmistry2000/mybash/blob/main/.github/workflows/main.yml"
    click Repo "https://github.com/dhruvmistry2000/mybash/blob/main/README.md"
    click Repo "https://github.com/dhruvmistry2000/mybash/blob/main/.gitignore"
    click Repo "https://github.com/dhruvmistry2000/mybash/tree/main/execution_scripts/"

    %% Styles
    classDef user fill:#E3F2FD,stroke:#0D47A1,color:#0D47A1;
    classDef repo fill:#E8F5E9,stroke:#1B5E20,color:#1B5E20;
    classDef orchestrator fill:#FFF3E0,stroke:#E65100,color:#E65100;
    classDef config fill:#F3E5F5,stroke:#6A1B9A,color:#6A1B9A;
    classDef script fill:#E1F5FE,stroke:#01579B,color:#01579B;
    classDef external fill:#FFEBEE,stroke:#B71C1C,color:#B71C1C;
    classDef ci fill:#FFF8E1,stroke:#F57F17,color:#F57F17;
    classDef home fill:#ECEFF1,stroke:#37474F,color:#37474F;
```
