# syl20bnr/spacemacs architecture

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

- Interactive diagram: https://gitdiagram.com/syl20bnr/spacemacs
- Repository: https://github.com/syl20bnr/spacemacs

## Overview

Spacemacs is an Emacs configuration and extensible editing environment. The user launches it in Emacs, explores mnemonic key bindings, and uses configured layers for editing and development capabilities. The graph preserves the README’s documented layer, UI, documentation, and ergonomics branches, plus the two indexed language-support modules. Most runtime wiring was not sampled, so unverified connections are dashed with no evidence path; the README supports only the broader product relationships.

Main entry points: [`core/core-configuration-layer.el`](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-configuration-layer.el) (Configuration Layers), [`core/core-spacemacs.el`](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-spacemacs.el) (Core Runtime), [`early-init.el`](https://github.com/syl20bnr/spacemacs/blob/develop/early-init.el) (Early Initialization), [`init.el`](https://github.com/syl20bnr/spacemacs/blob/develop/init.el) (Initialization Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and Configuration"]
  node_early["Early Initialization<br/>[early-init.el]"]
  node_init["Initialization Entry<br/>[init.el]"]
  node_core["Core Runtime<br/>[core-spacemacs.el]"]
  node_userconfig["User Configuration"]
  node_layers["Configuration Layers"]
end

subgraph group_interaction["Editing Experience"]
  node_keys["Mnemonic Keybindings"]
  node_display["Display and Themes"]
  node_modeline["Mode Line"]
  node_docs["Interactive Documentation"]
end

subgraph group_capabilities["Layer Capabilities"]
  node_completion["Completion"]
  node_sourcecontrol["Source Control"]
  node_tools["Developer Tools"]
end

subgraph group_language["Language Support"]
  node_cpp["C/C++ Configuration<br/>[global_conf.py]"]
  node_pylookup["Python Doc Lookup<br/>[pylookup.py]"]
end

node_user(("Editor User"))
node_emacs["Emacs Runtime"]

node_user -->|"launches"| node_emacs
node_emacs -.->|"loads configuration"| node_early
node_early -.->|"continues startup"| node_init
node_init -.->|"starts runtime"| node_core
node_core -.->|"loads settings"| node_userconfig
node_core -.->|"configures layers"| node_layers
node_user -->|"explores bindings"| node_keys
node_user -->|"opens help"| node_docs
node_layers -.->|"enables capabilities"| node_completion
node_layers -.->|"enables capabilities"| node_sourcecontrol
node_layers -.->|"enables capabilities"| node_tools
node_layers -.->|"configures language support"| node_cpp
node_layers -.->|"provides documentation lookup"| node_pylookup
node_user -->|"uses interface"| node_display
node_user -->|"views mode line"| node_modeline

click node_early "https://github.com/syl20bnr/spacemacs/blob/develop/early-init.el"
click node_init "https://github.com/syl20bnr/spacemacs/blob/develop/init.el"
click node_core "https://github.com/syl20bnr/spacemacs/blob/develop/core/core-spacemacs.el"
click node_userconfig "https://github.com/syl20bnr/spacemacs/blob/develop/core/core-dotspacemacs.el"
click node_layers "https://github.com/syl20bnr/spacemacs/blob/develop/core/core-configuration-layer.el"
click node_keys "https://github.com/syl20bnr/spacemacs/blob/develop/core/core-keybindings.el"
click node_display "https://github.com/syl20bnr/spacemacs/blob/develop/core/core-display-init.el"
click node_modeline "https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Bspacemacs/spacemacs-modeline"
click node_docs "https://github.com/syl20bnr/spacemacs/blob/develop/core/core-documentation.el"
click node_completion "https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Bcompletion"
click node_sourcecontrol "https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Bsource-control"
click node_tools "https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Btools"
click node_cpp "https://github.com/syl20bnr/spacemacs/blob/develop/layers/%2Blang/c-c%2B%2B/global_conf.py"
click node_pylookup "https://github.com/syl20bnr/spacemacs/blob/develop/layers/%2Blang/python/local/pylookup/pylookup.py"

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_early,node_init,node_core,node_userconfig,node_layers,node_user toneBlue
class node_keys,node_display,node_modeline,node_docs toneAmber
class node_completion,node_sourcecontrol,node_tools toneMint
class node_cpp,node_pylookup toneRose
class node_emacs toneIndigo
```

## Components

### Startup and Configuration

- [Early Initialization](https://github.com/syl20bnr/spacemacs/blob/develop/early-init.el): `early-init.el`
- [Initialization Entry](https://github.com/syl20bnr/spacemacs/blob/develop/init.el): `init.el`
- [Core Runtime](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-spacemacs.el): `core/core-spacemacs.el`
- [User Configuration](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-dotspacemacs.el): `core/core-dotspacemacs.el`
- [Configuration Layers](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-configuration-layer.el): `core/core-configuration-layer.el`

### Editing Experience

- [Mnemonic Keybindings](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-keybindings.el): `core/core-keybindings.el`
- [Display and Themes](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-display-init.el): `core/core-display-init.el`
- [Mode Line](https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Bspacemacs/spacemacs-modeline): `layers/+spacemacs/spacemacs-modeline`
- [Interactive Documentation](https://github.com/syl20bnr/spacemacs/blob/develop/core/core-documentation.el): `core/core-documentation.el`

### Layer Capabilities

- [Completion](https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Bcompletion): `layers/+completion`
- [Source Control](https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Bsource-control): `layers/+source-control`
- [Developer Tools](https://github.com/syl20bnr/spacemacs/tree/develop/layers/%2Btools): `layers/+tools`

### Language Support

- [C/C++ Configuration](https://github.com/syl20bnr/spacemacs/blob/develop/layers/%2Blang/c-c%2B%2B/global_conf.py): `layers/+lang/c-c++/global_conf.py`
- [Python Doc Lookup](https://github.com/syl20bnr/spacemacs/blob/develop/layers/%2Blang/python/local/pylookup/pylookup.py): `layers/+lang/python/local/pylookup/pylookup.py`

### Other components

- **Editor User**
- **Emacs Runtime**

## Connections

- Editor User → Emacs Runtime: launches (evidence: `README.md`)
- Emacs Runtime → Early Initialization: loads configuration
- Early Initialization → Initialization Entry: continues startup
- Initialization Entry → Core Runtime: starts runtime
- Core Runtime → User Configuration: loads settings
- Core Runtime → Configuration Layers: configures layers
- Editor User → Mnemonic Keybindings: explores bindings (evidence: `README.md`)
- Editor User → Interactive Documentation: opens help (evidence: `README.md`)
- Configuration Layers → Completion: enables capabilities
- Configuration Layers → Source Control: enables capabilities
- Configuration Layers → Developer Tools: enables capabilities
- Configuration Layers → C/C++ Configuration: configures language support
- Configuration Layers → Python Doc Lookup: provides documentation lookup
- Editor User → Display and Themes: uses interface (evidence: `README.md`)
- Editor User → Mode Line: views mode line (evidence: `README.md`)
