# vuejs/vuex architecture

> Architecture diagram of the GitHub repository vuejs/vuex, 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/vuejs/vuex
- Repository: https://github.com/vuejs/vuex

## Overview

Vuex is a centralized state-management library for Vue: application code creates a store, installs it into a Vue app, then reads state/getters and dispatches actions or commits mutations; updates are observable by subscribers and Vue Devtools. Modules provide namespaced, dynamically managed domains. The graph also includes component mapping/injection helpers and the optional logger. Devtools snapshot import/export and time-travel are README-documented capabilities; the sampled excerpt confirms inspector editing and mutation/action timelines, but not the complete snapshot or time-travel wiring.

Main entry points: [`src/store.js`](https://github.com/vuejs/vuex/blob/main/src/store.js) (Store API), [`src/store-util.js`](https://github.com/vuejs/vuex/blob/main/src/store-util.js) (Store operations), [`src/index.js`](https://github.com/vuejs/vuex/blob/main/src/index.js) (Vuex exports), [`src/plugins/logger.js`](https://github.com/vuejs/vuex/blob/main/src/plugins/logger.js) (Logger plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Vue integration"]
  node_api["Vuex exports<br/>[index.js]"]
  node_injection["Store injection<br/>[injectKey.js]"]
  node_mappers["Component mappers<br/>[helpers.js]"]
end

subgraph group_runtime["Store runtime"]
  node_store["Store API<br/>[store.js]"]
  node_runtime_utils["Store operations<br/>[store-util.js]"]
  node_vue_reactivity["Vue reactivity"]
end

subgraph group_domains["Modules and state"]
  node_collection["Module collection"]
  node_module["Module definition<br/>[module.js]"]
end

subgraph group_observability["Debugging and plugins"]
  node_devtools["Vue Devtools"]
  node_devtool_plugin["Devtools integration<br/>[devtool.js]"]
  node_logger["Logger plugin<br/>[logger.js]"]
end

node_app(("Vue application"))
node_console["Console"]

node_api -->|"exports API"| node_store
node_api -->|"exports injection"| node_injection
node_api -->|"exports mappers"| node_mappers
node_api -->|"exports logger"| node_logger
node_app -->|"creates store"| node_store
node_app -->|"installs store"| node_store
node_store -->|"provides key"| node_injection
node_app -->|"injects store"| node_injection
node_app -->|"maps store access"| node_mappers
node_store -->|"constructs modules"| node_collection
node_collection -->|"creates modules"| node_module
node_store -->|"installs modules"| node_runtime_utils
node_runtime_utils -->|"reads definitions"| node_module
node_store -->|"resets store"| node_runtime_utils
node_runtime_utils -->|"builds reactive state"| node_vue_reactivity
node_store -->|"watches state"| node_vue_reactivity
node_store -->|"dispatches actions"| node_runtime_utils
node_store -->|"commits mutations"| node_runtime_utils
node_store -->|"registers modules"| node_collection
node_store -->|"updates modules"| node_collection
node_store -->|"registers integration"| node_devtool_plugin
node_devtool_plugin -->|"adds inspector and timeline"| node_devtools
node_app -.->|"configures plugin"| node_logger
node_logger -->|"subscribes to events"| node_store
node_logger -->|"writes logs"| node_console

click node_api "https://github.com/vuejs/vuex/blob/main/src/index.js"
click node_injection "https://github.com/vuejs/vuex/blob/main/src/injectKey.js"
click node_mappers "https://github.com/vuejs/vuex/blob/main/src/helpers.js"
click node_store "https://github.com/vuejs/vuex/blob/main/src/store.js"
click node_runtime_utils "https://github.com/vuejs/vuex/blob/main/src/store-util.js"
click node_collection "https://github.com/vuejs/vuex/blob/main/src/module/module-collection.js"
click node_module "https://github.com/vuejs/vuex/blob/main/src/module/module.js"
click node_devtool_plugin "https://github.com/vuejs/vuex/blob/main/src/plugins/devtool.js"
click node_logger "https://github.com/vuejs/vuex/blob/main/src/plugins/logger.js"

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_api,node_injection,node_mappers toneBlue
class node_store,node_runtime_utils,node_vue_reactivity toneAmber
class node_collection,node_module toneMint
class node_devtools,node_devtool_plugin,node_logger toneRose
class node_app,node_console toneIndigo
```

## Components

### Vue integration

- [Vuex exports](https://github.com/vuejs/vuex/blob/main/src/index.js): `src/index.js`
- [Store injection](https://github.com/vuejs/vuex/blob/main/src/injectKey.js): `src/injectKey.js`
- [Component mappers](https://github.com/vuejs/vuex/blob/main/src/helpers.js): `src/helpers.js`

### Store runtime

- [Store API](https://github.com/vuejs/vuex/blob/main/src/store.js): `src/store.js`
- [Store operations](https://github.com/vuejs/vuex/blob/main/src/store-util.js): `src/store-util.js`
- **Vue reactivity**

### Modules and state

- [Module collection](https://github.com/vuejs/vuex/blob/main/src/module/module-collection.js): `src/module/module-collection.js`
- [Module definition](https://github.com/vuejs/vuex/blob/main/src/module/module.js): `src/module/module.js`

### Debugging and plugins

- **Vue Devtools**
- [Devtools integration](https://github.com/vuejs/vuex/blob/main/src/plugins/devtool.js): `src/plugins/devtool.js`
- [Logger plugin](https://github.com/vuejs/vuex/blob/main/src/plugins/logger.js): `src/plugins/logger.js`

### Other components

- **Vue application**
- **Console**

## Connections

- Vuex exports → Store API: exports API (evidence: `src/index.js`)
- Vuex exports → Store injection: exports injection (evidence: `src/index.js`)
- Vuex exports → Component mappers: exports mappers (evidence: `src/index.js`)
- Vuex exports → Logger plugin: exports logger (evidence: `src/index.js`)
- Vue application → Store API: creates store (evidence: `src/store.js`)
- Vue application → Store API: installs store (evidence: `src/store.js`)
- Store API → Store injection: provides key (evidence: `src/store.js`)
- Vue application → Store injection: injects store (evidence: `src/injectKey.js`)
- Vue application → Component mappers: maps store access (evidence: `src/helpers.js`)
- Store API → Module collection: constructs modules (evidence: `src/store.js`)
- Module collection → Module definition: creates modules (evidence: `src/module/module-collection.js`)
- Store API → Store operations: installs modules (evidence: `src/store.js`)
- Store operations → Module definition: reads definitions (evidence: `src/store-util.js`)
- Store API → Store operations: resets store (evidence: `src/store.js`)
- Store operations → Vue reactivity: builds reactive state (evidence: `src/store-util.js`)
- Store API → Vue reactivity: watches state (evidence: `src/store.js`)
- Store API → Store operations: dispatches actions (evidence: `src/store.js`)
- Store API → Store operations: commits mutations (evidence: `src/store.js`)
- Store API → Module collection: registers modules (evidence: `src/store.js`)
- Store API → Module collection: updates modules (evidence: `src/store.js`)
- Store API → Devtools integration: registers integration (evidence: `src/store.js`)
- Devtools integration → Vue Devtools: adds inspector and timeline (evidence: `src/plugins/devtool.js`)
- Vue application → Logger plugin: configures plugin
- Logger plugin → Store API: subscribes to events (evidence: `src/plugins/logger.js`)
- Logger plugin → Console: writes logs (evidence: `src/plugins/logger.js`)
