# carlhuda/janus architecture

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

- Interactive diagram: https://gitdiagram.com/carlhuda/janus
- Repository: https://github.com/carlhuda/janus

## Overview

Janus is a customizable Vim/Gvim/MacVim distribution: users start Vim with Janus installed, then use its default settings, mappings, colors, and plugin integrations while optionally overriding settings or adding plugins. The tree separates core configuration, language support, tools, and color schemes. The README documents these capabilities, but the sampled Ruby files concern installation-task helpers and do not show Vim’s runtime loading or dispatch, so runtime edges are limited to documented relationships.

Main entry points: [`janus/vim/core/before/plugin`](https://github.com/carlhuda/janus/tree/master/janus/vim/core/before/plugin) (Core Settings), [`janus/vim/core/before/plugin/mappings.vim`](https://github.com/carlhuda/janus/blob/master/janus/vim/core/before/plugin/mappings.vim) (Core Mappings), [`janus/vim/core/plugins.vim`](https://github.com/carlhuda/janus/blob/master/janus/vim/core/plugins.vim) (Plugin Setup), [`janus/vim/core/janus/after/plugin`](https://github.com/carlhuda/janus/tree/master/janus/vim/core/janus/after/plugin) (User Overrides)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core Vim Configuration"]
  node_core_config["Core Settings"]
  node_core_mappings["Core Mappings<br/>[mappings.vim]"]
  node_core_plugins["Plugin Setup<br/>[plugins.vim]"]
  node_custom_overrides["User Overrides"]
end

subgraph group_language["Language Support"]
  node_language_plugins["Language Plugins"]
end

subgraph group_tools["Editing Tools"]
  node_tool_plugins["Editing Plugins"]
  node_plugin_overrides["Plugin Settings"]
end

subgraph group_appearance["Color Schemes"]
  node_colors["Color Schemes"]
end

node_user(("Vim User"))
node_vim["Vim / Gvim"]
node_custom_plugins["User Plugins"]

node_user -->|"uses"| node_vim
node_vim -->|"uses settings"| node_core_config
node_vim -->|"uses mappings"| node_core_mappings
node_vim -->|"uses plugins"| node_core_plugins
node_vim -->|"uses language support"| node_language_plugins
node_vim -->|"uses plugins"| node_tool_plugins
node_vim -->|"uses schemes"| node_colors
node_user -->|"customizes settings"| node_custom_overrides
node_user -->|"adds plugins"| node_custom_plugins
node_user -->|"customizes plugins"| node_plugin_overrides

click node_core_config "https://github.com/carlhuda/janus/tree/master/janus/vim/core/before/plugin"
click node_core_mappings "https://github.com/carlhuda/janus/blob/master/janus/vim/core/before/plugin/mappings.vim"
click node_core_plugins "https://github.com/carlhuda/janus/blob/master/janus/vim/core/plugins.vim"
click node_custom_overrides "https://github.com/carlhuda/janus/tree/master/janus/vim/core/janus/after/plugin"
click node_language_plugins "https://github.com/carlhuda/janus/tree/master/janus/vim/langs"
click node_tool_plugins "https://github.com/carlhuda/janus/tree/master/janus/vim/tools"
click node_plugin_overrides "https://github.com/carlhuda/janus/tree/master/janus/vim/tools/janus/after/plugin"
click node_colors "https://github.com/carlhuda/janus/tree/master/janus/vim/colors"

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_core_config,node_core_mappings,node_core_plugins,node_custom_overrides,node_user,node_custom_plugins toneBlue
class node_language_plugins toneAmber
class node_tool_plugins,node_plugin_overrides toneMint
class node_colors toneRose
class node_vim toneIndigo
```

## Components

### Core Vim Configuration

- [Core Settings](https://github.com/carlhuda/janus/tree/master/janus/vim/core/before/plugin): `janus/vim/core/before/plugin`
- [Core Mappings](https://github.com/carlhuda/janus/blob/master/janus/vim/core/before/plugin/mappings.vim): `janus/vim/core/before/plugin/mappings.vim`
- [Plugin Setup](https://github.com/carlhuda/janus/blob/master/janus/vim/core/plugins.vim): `janus/vim/core/plugins.vim`
- [User Overrides](https://github.com/carlhuda/janus/tree/master/janus/vim/core/janus/after/plugin): `janus/vim/core/janus/after/plugin`

### Language Support

- [Language Plugins](https://github.com/carlhuda/janus/tree/master/janus/vim/langs): `janus/vim/langs`

### Editing Tools

- [Editing Plugins](https://github.com/carlhuda/janus/tree/master/janus/vim/tools): `janus/vim/tools`
- [Plugin Settings](https://github.com/carlhuda/janus/tree/master/janus/vim/tools/janus/after/plugin): `janus/vim/tools/janus/after/plugin`

### Color Schemes

- [Color Schemes](https://github.com/carlhuda/janus/tree/master/janus/vim/colors): `janus/vim/colors`

### Other components

- **Vim User**
- **Vim / Gvim**
- **User Plugins**

## Connections

- Vim User → Vim / Gvim: uses (evidence: `README.md`)
- Vim / Gvim → Core Settings: uses settings (evidence: `README.md`)
- Vim / Gvim → Core Mappings: uses mappings (evidence: `README.md`)
- Vim / Gvim → Plugin Setup: uses plugins (evidence: `README.md`)
- Vim / Gvim → Language Plugins: uses language support (evidence: `README.md`)
- Vim / Gvim → Editing Plugins: uses plugins (evidence: `README.md`)
- Vim / Gvim → Color Schemes: uses schemes (evidence: `README.md`)
- Vim User → User Overrides: customizes settings (evidence: `README.md`)
- Vim User → User Plugins: adds plugins (evidence: `README.md`)
- Vim User → Plugin Settings: customizes plugins (evidence: `README.md`)
