# josephgrossberg/dotfiles-for-portable-configuration architecture

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

- Interactive diagram: https://gitdiagram.com/josephgrossberg/dotfiles-for-portable-configuration
- Repository: https://github.com/josephgrossberg/dotfiles-for-portable-configuration

## Overview

##### Main Components

a. Shell Environment Configuration
- Bash configuration (.bash_profile, .bashrc, .bash_aliases)
- Zsh configuration (.zshrc, .zprofile, .zsh_aliases, .p10k.zsh)
- Custom theme (joegrossberg.zsh-theme)

b. Editor Configuration
- Emacs setup (.emacs, .emacs.d/)
- Vim setup (.vimrc)
- Theme files and customizations

c. Development Tools Configuration
- Git configuration (.gitconfig, .gitignore_global)
- Ruby tools (.gemrc, .irbrc, .rspec)
- Database configuration (.my.cnf)

d. Terminal Customization
- Fonts (SF-Mono-Powerline/, Inconsolata-dz)
- Terminal utilities (bin/)

e. Application Configuration
- StartAll.app (macOS automation)
- Chrome configuration (chrome_search_engines.sql)

- ┌─ Shell Environment ─┐
- ┌─ Editors ──────┐ │
- ┌─ Dev Tools ┐ │ │

- ┘ │ │
- ┘ │
- ┘

##### Component Relationships

- Configuration inheritance (e.g., .bashrc → .bash_aliases)
- Tool integration (e.g., git completion → shell)

##### Important Elements to Highlight

a. Core Configuration Files:
- Related configs together
- Extension points

b. Custom Scripts and Utilities:
- Bin/ directory contents
- Integration with shell environment

c. Visual Customization:
- Fonts and themes
- Application to different tools

##### Implementation Details

Use these symbols and conventions:
- Rectangles: Main components
- Rounded rectangles: Configuration files
- Hexagons: Applications

##### The separation between shell, editor, and tool configurations

Remember to maintain a balance between showing the complexity of the configuration system while keeping it understandable at a glance. The goal is to communicate how these various configuration files and tools work together to create a consistent and productive development environment.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Shell
        ShellEnv[Shell Environment]
        BashConfig[Bash Configuration]:::bash
        ZshConfig[Zsh Configuration]:::zsh
        ShellUtils[Shell Utilities]:::utils
        
        ShellEnv --> BashConfig
        ShellEnv --> ZshConfig
        ShellEnv --> ShellUtils
        
        BashConfig --> BashRC[".bashrc"]:::file
        BashConfig --> BashProfile[".bash_profile"]:::file
        BashConfig --> BashAliases[".bash_aliases"]:::file
        BashConfig --> BashPrompt[".bash_prompt"]:::file
        
        ZshConfig --> ZshRC[".zshrc"]:::file
        ZshConfig --> ZshProfile[".zprofile"]:::file
        ZshConfig --> ZshAliases[".zsh_aliases"]:::file
        ZshConfig --> P10k[".p10k.zsh"]:::file
        ZshConfig --> ZshTheme["joegrossberg.zsh-theme"]:::file
        
        ShellUtils --> CustomScripts["Custom Scripts"]:::dir
        CustomScripts --> GHWD["ghwd"]:::file
        CustomScripts --> GitOpen["git-open"]:::file
        CustomScripts --> ImgCat["imgcat"]:::file
        CustomScripts --> P["p"]:::file
        CustomScripts --> Replace["replace"]:::file
        CustomScripts --> Z["z.sh"]:::file
    end
    
    subgraph Editors
        EditConfig[Editor Configuration]
        EmacsConfig[Emacs Configuration]:::emacs
        VimConfig[Vim Configuration]:::vim
        
        EditConfig --> EmacsConfig
        EditConfig --> VimConfig
        
        EmacsConfig --> EmacsFile[".emacs"]:::file
        EmacsConfig --> EmacsD[".emacs.d/"]:::dir
        EmacsD --> EmacsThemes[".emacs.d/themes/"]:::dir
        
        VimConfig --> VimRC[".vimrc"]:::file
    end
    
    subgraph DevTools
        DevConfig[Development Tools]
        GitConfig[Git Configuration]:::git
        RubyConfig[Ruby Configuration]:::ruby
        DBConfig[Database Configuration]:::db
        
        DevConfig --> GitConfig
        DevConfig --> RubyConfig
        DevConfig --> DBConfig
        
        GitConfig --> GitConfigFile[".gitconfig"]:::file
        GitConfig --> GitIgnore[".gitignore_global"]:::file
        GitConfig --> GitCompletion["git-completion.bash"]:::file
        
        RubyConfig --> GemRC[".gemrc"]:::file
        RubyConfig --> IrbRC[".irbrc"]:::file
        RubyConfig --> RSpec[".rspec"]:::file
        
        DBConfig --> MyCnf[".my.cnf"]:::file
    end
    
    subgraph Terminal
        TermConfig[Terminal Customization]
        Fonts[Fonts]:::fonts
        ColorSchemes[Color Schemes]:::colors
        
        TermConfig --> Fonts
        TermConfig --> ColorSchemes
        
        Fonts --> SFMono["SF-Mono-Powerline/"]:::dir
        Fonts --> Inconsolata["Inconsolata-dz for Powerline.otf"]:::file
        
        ColorSchemes --> MonokaiSoda["Monokai Soda.itermcolors"]:::file
    end
    
    subgraph Apps
        AppConfig[Application Configuration]
        StartAll["StartAll.app/"]:::dir
        ChromeConfig["chrome_search_engines.sql"]:::file
        
        AppConfig --> StartAll
        AppConfig --> ChromeConfig
    end
    
    %% Click events for component mapping
    click BashRC "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.bashrc"
    click BashProfile "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.bash_profile"
    click BashAliases "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.bash_aliases"
    click BashPrompt "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.bash_prompt"
    click ZshRC "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.zshrc"
    click ZshProfile "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.zprofile"
    click ZshAliases "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.zsh_aliases"
    click P10k "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.p10k.zsh"
    click ZshTheme "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/joegrossberg.zsh-theme"
    click EmacsFile "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.emacs"
    click EmacsD "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/.emacs.d/"
    click EmacsThemes "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/.emacs.d/themes/"
    click VimRC "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.vimrc"
    click GitConfigFile "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.gitconfig"
    click GitIgnore "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.gitignore_global"
    click GitCompletion "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/git-completion.bash"
    click GemRC "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.gemrc"
    click IrbRC "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.irbrc"
    click RSpec "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.rspec"
    click MyCnf "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/.my.cnf"
    click SFMono "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/SF-Mono-Powerline/"
    click Inconsolata "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/Inconsolata-dz for Powerline.otf"
    click MonokaiSoda "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/Monokai%20Soda.itermcolors"
    click GHWD "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/bin/ghwd"
    click GitOpen "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/bin/git-open"
    click ImgCat "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/bin/imgcat"
    click P "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/bin/p"
    click Replace "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/bin/replace"
    click Z "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/bin/z.sh"
    click StartAll "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/tree/master/StartAll.app/"
    click ChromeConfig "https://github.com/josephgrossberg/dotfiles-for-portable-configuration/blob/master/chrome_search_engines.sql"
    
    %% Styling
    classDef file fill:#f9f,stroke:#333,stroke-width:2px
    classDef dir fill:#bbf,stroke:#333,stroke-width:2px
    classDef bash fill:#ddf,stroke:#333
    classDef zsh fill:#dfd,stroke:#333
    classDef utils fill:#fdd,stroke:#333
    classDef emacs fill:#dff,stroke:#333
    classDef vim fill:#fdf,stroke:#333
    classDef git fill:#ffd,stroke:#333
    classDef ruby fill:#dff,stroke:#333
    classDef db fill:#fdf,stroke:#333
    classDef fonts fill:#ddf,stroke:#333
    classDef colors fill:#fdd,stroke:#333
```
