# csullaez/dotfiles architecture

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

- Interactive diagram: https://gitdiagram.com/csullaez/dotfiles
- Repository: https://github.com/csullaez/dotfiles

## Overview

This repository is a personal tool-configuration collection, chiefly for Vim and Neovim, with additional Tmux, Spaceship, and terminal settings. The documented editor workflow is to source `.vimrc`, then use vim-plug to install configured plugins. The tree shows distinct Neovim capabilities including LSP, completion, search, snippets, and Git tools, but their internal wiring was not sampled; those relationships are therefore left unasserted. The `config.h` excerpt documents terminal appearance and input mappings.

Main entry points: [`.vimrc`](https://github.com/csullaez/dotfiles/blob/main/.vimrc) (Vim entry config), [`lua/main.lua`](https://github.com/csullaez/dotfiles/blob/main/lua/main.lua) (Neovim setup), [`init.lua`](https://github.com/csullaez/dotfiles/blob/main/init.lua) (Neovim entry), [`vimrc/plugins`](https://github.com/csullaez/dotfiles/tree/main/vimrc/plugins) (Vim plugin config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vim["Vim configuration"]
  node_vim_config["Vim entry config<br/>[.vimrc]"]
  node_vim_settings["Vim settings"]
  node_vim_mappings["Vim mappings<br/>[mappings.vim]"]
  node_vim_plugins["Vim plugin config"]
end

subgraph group_nvim["Neovim configuration"]
  node_nvim_entry["Neovim entry<br/>[init.lua]"]
  node_nvim_core["Neovim setup<br/>[main.lua]"]
  node_nvim_plugins["Plugin definitions"]
  node_nvim_lsp["LSP configuration"]
  node_completion["Completion"]
  node_telescope["Search and picker"]
  node_snippets["Code snippets<br/>[package.json]"]
  node_git_tools["Git integrations<br/>[gitsigns.lua]"]
end

subgraph group_shell["Shell and sessions"]
  node_tmux["Tmux settings<br/>[.tmux.conf]"]
  node_spaceship["Spaceship settings<br/>[.spaceshiprc.zsh]"]
end

subgraph group_terminal["Terminal settings"]
  node_terminal_config["Terminal configuration<br/>[config.h]"]
end

node_user(("User"))
node_vim_plug["vim-plug"]

node_user -->|"sources config"| node_vim_config
node_user -->|"installs plugins"| node_vim_plug
node_vim_config -->|"loads plugin config"| node_vim_plugins
node_nvim_entry -.->|"initializes"| node_nvim_core
node_nvim_core -.->|"configures plugins"| node_nvim_plugins

click node_vim_config "https://github.com/csullaez/dotfiles/blob/main/.vimrc"
click node_vim_settings "https://github.com/csullaez/dotfiles/tree/main/vimrc/settings"
click node_vim_mappings "https://github.com/csullaez/dotfiles/blob/main/vimrc/mappings/mappings.vim"
click node_vim_plugins "https://github.com/csullaez/dotfiles/tree/main/vimrc/plugins"
click node_nvim_entry "https://github.com/csullaez/dotfiles/blob/main/init.lua"
click node_nvim_core "https://github.com/csullaez/dotfiles/blob/main/lua/main.lua"
click node_nvim_plugins "https://github.com/csullaez/dotfiles/tree/main/lua/plugins"
click node_nvim_lsp "https://github.com/csullaez/dotfiles/tree/main/lua/alpha/lsp"
click node_completion "https://github.com/csullaez/dotfiles/tree/main/lua/alpha/completition"
click node_telescope "https://github.com/csullaez/dotfiles/tree/main/lua/alpha/telescope"
click node_snippets "https://github.com/csullaez/dotfiles/blob/main/lua/alpha/snippets/package.json"
click node_git_tools "https://github.com/csullaez/dotfiles/blob/main/lua/plugins/gitsigns.lua"
click node_tmux "https://github.com/csullaez/dotfiles/blob/main/.tmux.conf"
click node_spaceship "https://github.com/csullaez/dotfiles/blob/main/.spaceshiprc.zsh"
click node_terminal_config "https://github.com/csullaez/dotfiles/blob/main/config.h"

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_vim_config,node_vim_settings,node_vim_mappings,node_vim_plugins,node_user toneBlue
class node_nvim_entry,node_nvim_core,node_nvim_plugins,node_nvim_lsp,node_completion,node_telescope,node_snippets,node_git_tools toneAmber
class node_tmux,node_spaceship toneMint
class node_terminal_config toneRose
class node_vim_plug toneIndigo
```

## Components

### Vim configuration

- [Vim entry config](https://github.com/csullaez/dotfiles/blob/main/.vimrc): `.vimrc`
- [Vim settings](https://github.com/csullaez/dotfiles/tree/main/vimrc/settings): `vimrc/settings`
- [Vim mappings](https://github.com/csullaez/dotfiles/blob/main/vimrc/mappings/mappings.vim): `vimrc/mappings/mappings.vim`
- [Vim plugin config](https://github.com/csullaez/dotfiles/tree/main/vimrc/plugins): `vimrc/plugins`

### Neovim configuration

- [Neovim entry](https://github.com/csullaez/dotfiles/blob/main/init.lua): `init.lua`
- [Neovim setup](https://github.com/csullaez/dotfiles/blob/main/lua/main.lua): `lua/main.lua`
- [Plugin definitions](https://github.com/csullaez/dotfiles/tree/main/lua/plugins): `lua/plugins`
- [LSP configuration](https://github.com/csullaez/dotfiles/tree/main/lua/alpha/lsp): `lua/alpha/lsp`
- [Completion](https://github.com/csullaez/dotfiles/tree/main/lua/alpha/completition): `lua/alpha/completition`
- [Search and picker](https://github.com/csullaez/dotfiles/tree/main/lua/alpha/telescope): `lua/alpha/telescope`
- [Code snippets](https://github.com/csullaez/dotfiles/blob/main/lua/alpha/snippets/package.json): `lua/alpha/snippets/package.json`
- [Git integrations](https://github.com/csullaez/dotfiles/blob/main/lua/plugins/gitsigns.lua): `lua/plugins/gitsigns.lua`

### Shell and sessions

- [Tmux settings](https://github.com/csullaez/dotfiles/blob/main/.tmux.conf): `.tmux.conf`
- [Spaceship settings](https://github.com/csullaez/dotfiles/blob/main/.spaceshiprc.zsh): `.spaceshiprc.zsh`

### Terminal settings

- [Terminal configuration](https://github.com/csullaez/dotfiles/blob/main/config.h): `config.h`

### Other components

- **User**
- **vim-plug**

## Connections

- User → Vim entry config: sources config (evidence: `README.md`)
- User → vim-plug: installs plugins (evidence: `README.md`)
- Vim entry config → Vim plugin config: loads plugin config (evidence: `README.md`)
- Neovim entry → Neovim setup: initializes
- Neovim setup → Plugin definitions: configures plugins
