# tonykevin/dotfiles architecture

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

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

## Overview

This repository is a personal Linux dotfiles collection. Its user-to-result workflow is linking selected settings into application and shell configuration locations; the README documents this for R, pip, and Zsh. It also documents Kitty and Neovim settings, linters, and startup applications. The tree identifies Neovim’s configuration areas, but no source excerpts show how they interact, so those are represented as separate capabilities. Relationships beyond the README’s explicit setup guidance are omitted.

Main entry points: [`zprofile`](https://github.com/tonykevin/dotfiles/blob/master/zprofile) (Zsh Startup), [`Renviron`](https://github.com/tonykevin/dotfiles/blob/master/Renviron) (R Environment), [`config/pip/pip.conf`](https://github.com/tonykevin/dotfiles/blob/master/config/pip/pip.conf) (Pip Settings), [`zshenv`](https://github.com/tonykevin/dotfiles/blob/master/zshenv) (Zsh Environment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_terminal["Terminal"]
  node_kitty["Kitty Settings<br/>[kitty.conf]"]
  node_kitty_theme["Tokyo Night Theme<br/>[tokyonight.conf]"]
end

subgraph group_editor["Editor"]
  node_nvim_init["Neovim Entry<br/>[init.vim]"]
  node_nvim_config["Neovim Configuration"]
  node_nvim_keys["Key Mappings"]
  node_nvim_plugins["Plugin Settings"]
  node_nvim_ftplugin["Filetype Settings<br/>[javascript.vim]"]
  node_nvim_extra["Extra Settings"]
end

subgraph group_language["Language Tools"]
  node_r_env["R Environment"]
  node_pip["Pip Settings<br/>[pip.conf]"]
  node_linters["Linter Settings"]
end

subgraph group_shell["Shell Environment"]
  node_zsh_env["Zsh Environment"]
  node_zsh_profile["Zsh Startup"]
  node_startup_apps["Startup Applications"]
end

node_user(("User"))

node_user -->|"symlinks"| node_r_env
node_user -->|"symlinks"| node_pip
node_user -->|"symlinks"| node_zsh_env
node_user -->|"symlinks"| node_zsh_profile
node_zsh_profile -->|"starts"| node_startup_apps

click node_kitty "https://github.com/tonykevin/dotfiles/blob/master/config/kitty/kitty.conf"
click node_kitty_theme "https://github.com/tonykevin/dotfiles/blob/master/config/kitty/themes/tokyonight.conf"
click node_nvim_init "https://github.com/tonykevin/dotfiles/blob/master/nvim/init.vim"
click node_nvim_config "https://github.com/tonykevin/dotfiles/tree/master/nvim/config"
click node_nvim_keys "https://github.com/tonykevin/dotfiles/tree/master/nvim/keys"
click node_nvim_plugins "https://github.com/tonykevin/dotfiles/tree/master/nvim/bundle"
click node_nvim_ftplugin "https://github.com/tonykevin/dotfiles/blob/master/nvim/ftplugin/javascript.vim"
click node_nvim_extra "https://github.com/tonykevin/dotfiles/tree/master/nvim/extra"
click node_r_env "https://github.com/tonykevin/dotfiles/blob/master/Renviron"
click node_pip "https://github.com/tonykevin/dotfiles/blob/master/config/pip/pip.conf"
click node_linters "https://github.com/tonykevin/dotfiles/tree/master/linters"
click node_zsh_env "https://github.com/tonykevin/dotfiles/blob/master/zshenv"
click node_zsh_profile "https://github.com/tonykevin/dotfiles/blob/master/zprofile"

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_kitty,node_kitty_theme,node_user toneBlue
class node_nvim_init,node_nvim_config,node_nvim_keys,node_nvim_plugins,node_nvim_ftplugin,node_nvim_extra toneAmber
class node_r_env,node_pip,node_linters toneMint
class node_zsh_env,node_zsh_profile,node_startup_apps toneRose
```

## Components

### Terminal

- [Kitty Settings](https://github.com/tonykevin/dotfiles/blob/master/config/kitty/kitty.conf): `config/kitty/kitty.conf`
- [Tokyo Night Theme](https://github.com/tonykevin/dotfiles/blob/master/config/kitty/themes/tokyonight.conf): `config/kitty/themes/tokyonight.conf`

### Editor

- [Neovim Entry](https://github.com/tonykevin/dotfiles/blob/master/nvim/init.vim): `nvim/init.vim`
- [Neovim Configuration](https://github.com/tonykevin/dotfiles/tree/master/nvim/config): `nvim/config`
- [Key Mappings](https://github.com/tonykevin/dotfiles/tree/master/nvim/keys): `nvim/keys`
- [Plugin Settings](https://github.com/tonykevin/dotfiles/tree/master/nvim/bundle): `nvim/bundle`
- [Filetype Settings](https://github.com/tonykevin/dotfiles/blob/master/nvim/ftplugin/javascript.vim): `nvim/ftplugin/javascript.vim`
- [Extra Settings](https://github.com/tonykevin/dotfiles/tree/master/nvim/extra): `nvim/extra`

### Language Tools

- [R Environment](https://github.com/tonykevin/dotfiles/blob/master/Renviron): `Renviron`
- [Pip Settings](https://github.com/tonykevin/dotfiles/blob/master/config/pip/pip.conf): `config/pip/pip.conf`
- [Linter Settings](https://github.com/tonykevin/dotfiles/tree/master/linters): `linters`

### Shell Environment

- [Zsh Environment](https://github.com/tonykevin/dotfiles/blob/master/zshenv): `zshenv`
- [Zsh Startup](https://github.com/tonykevin/dotfiles/blob/master/zprofile): `zprofile`
- **Startup Applications**

### Other components

- **User**

## Connections

- User → R Environment: symlinks (evidence: `README.md`)
- User → Pip Settings: symlinks (evidence: `README.md`)
- User → Zsh Environment: symlinks (evidence: `README.md`)
- User → Zsh Startup: symlinks (evidence: `README.md`)
- Zsh Startup → Startup Applications: starts (evidence: `README.md`)
