# reduxjs/redux architecture

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

## Overview

Redux core turns dispatched actions into updated state through a store and reducer logic; middleware can extend dispatch, while subscribers observe state changes. The repository also contains documentation tooling for linking TypeScript docblocks, transpiling TypeScript code blocks, and selecting library-specific navigation. The workflow reflects the README and sampled core source; unsampled documentation components are grouped at their exact directory, and no unverified runtime links are asserted.

Main entry points: [`src/index.ts`](https://github.com/reduxjs/redux/blob/master/src/index.ts) (Public API), [`src/createStore.ts`](https://github.com/reduxjs/redux/blob/master/src/createStore.ts) (State Store), [`src/combineReducers.ts`](https://github.com/reduxjs/redux/blob/master/src/combineReducers.ts) (Reducer Composition), [`src/types`](https://github.com/reduxjs/redux/tree/master/src/types) (Core Types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Redux Core"]
  node_public_api["Public API<br/>[index.ts]"]
  node_store[("State Store<br/>[createStore.ts]")]
  node_reducer_composition["Reducer Composition<br/>[combineReducers.ts]"]
  node_middleware["Middleware<br/>[applyMiddleware.ts]"]
  node_compose["Function Composition<br/>[compose.ts]"]
  node_action_binding["Action Binding"]
end

subgraph group_types["Type Contracts"]
  node_contracts["Core Types"]
end

subgraph group_utilities["Runtime Utilities"]
  node_action_guards["Action Validation<br/>[isAction.ts]"]
  node_plain_object["Plain Object Check<br/>[isPlainObject.ts]"]
  node_runtime_kind["Runtime Type Check<br/>[kindOf.ts]"]
  node_action_types["Internal Action Types<br/>[actionTypes.ts]"]
  node_observable["Observable Support"]
end

subgraph group_docs["Documentation Tooling"]
  node_doc_plugins["Remark Plugins"]
  node_code_compiler["Codeblock Compiler<br/>[compiler.ts]"]
  node_docblock_extractor["Docblock Extraction<br/>[extract.ts]"]
  node_typescript_bridge["TypeScript Bridge<br/>[ts7.cjs]"]
  node_library_selector["Library Selection"]
  node_docs_site["Documentation Site"]
end

node_developer(("Application"))

node_developer -->|"uses"| node_public_api
node_public_api -->|"exports"| node_store
node_public_api -->|"exports"| node_reducer_composition
node_public_api -->|"exports"| node_middleware
node_public_api -->|"exports"| node_compose
node_public_api -->|"exports"| node_action_binding
node_public_api -->|"exports types"| node_contracts
node_public_api -->|"exports"| node_action_guards
node_public_api -->|"exports"| node_plain_object
node_developer -->|"dispatches actions"| node_store
node_store -->|"invokes reducer"| node_reducer_composition
node_store -->|"implements contracts"| node_contracts
node_reducer_composition -->|"uses initialization types"| node_action_types
node_reducer_composition -->|"checks state"| node_plain_object
node_reducer_composition -->|"checks value types"| node_runtime_kind
node_middleware -->|"uses composition"| node_compose
node_middleware -->|"uses contracts"| node_contracts
node_action_binding -->|"uses contracts"| node_contracts
node_action_binding -->|"checks values"| node_runtime_kind
node_store -->|"validates actions"| node_plain_object
node_store -->|"checks value types"| node_runtime_kind
node_store -->|"provides observable"| node_observable
node_doc_plugins -->|"uses compiler"| node_code_compiler
node_doc_plugins -->|"uses extractor"| node_docblock_extractor
node_docblock_extractor -->|"imports API"| node_typescript_bridge
node_code_compiler -->|"loads TypeScript"| node_typescript_bridge
node_docs_site -.->|"uses library selection"| node_library_selector

click node_public_api "https://github.com/reduxjs/redux/blob/master/src/index.ts"
click node_store "https://github.com/reduxjs/redux/blob/master/src/createStore.ts"
click node_reducer_composition "https://github.com/reduxjs/redux/blob/master/src/combineReducers.ts"
click node_middleware "https://github.com/reduxjs/redux/blob/master/src/applyMiddleware.ts"
click node_compose "https://github.com/reduxjs/redux/blob/master/src/compose.ts"
click node_action_binding "https://github.com/reduxjs/redux/blob/master/src/bindActionCreators.ts"
click node_contracts "https://github.com/reduxjs/redux/tree/master/src/types"
click node_action_guards "https://github.com/reduxjs/redux/blob/master/src/utils/isAction.ts"
click node_plain_object "https://github.com/reduxjs/redux/blob/master/src/utils/isPlainObject.ts"
click node_runtime_kind "https://github.com/reduxjs/redux/blob/master/src/utils/kindOf.ts"
click node_action_types "https://github.com/reduxjs/redux/blob/master/src/utils/actionTypes.ts"
click node_observable "https://github.com/reduxjs/redux/blob/master/src/utils/symbol-observable.ts"
click node_doc_plugins "https://github.com/reduxjs/redux/tree/master/website/plugins/remark-typescript-tools"
click node_code_compiler "https://github.com/reduxjs/redux/blob/master/website/plugins/remark-typescript-tools/transpileCodeblocks/compiler.ts"
click node_docblock_extractor "https://github.com/reduxjs/redux/blob/master/website/plugins/remark-typescript-tools/linkDocblocks/extract.ts"
click node_typescript_bridge "https://github.com/reduxjs/redux/blob/master/website/plugins/remark-typescript-tools/ts7.cjs"
click node_library_selector "https://github.com/reduxjs/redux/blob/master/website/src/components/useCurrentLibrary.ts"
click node_docs_site "https://github.com/reduxjs/redux/tree/master/website/src"

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_public_api,node_store,node_reducer_composition,node_middleware,node_compose,node_action_binding toneBlue
class node_contracts toneAmber
class node_action_guards,node_plain_object,node_runtime_kind,node_action_types,node_observable toneMint
class node_doc_plugins,node_code_compiler,node_docblock_extractor,node_typescript_bridge,node_library_selector,node_docs_site toneRose
class node_developer toneIndigo
```

## Components

### Redux Core

- [Public API](https://github.com/reduxjs/redux/blob/master/src/index.ts): `src/index.ts`
- [State Store](https://github.com/reduxjs/redux/blob/master/src/createStore.ts): `src/createStore.ts`
- [Reducer Composition](https://github.com/reduxjs/redux/blob/master/src/combineReducers.ts): `src/combineReducers.ts`
- [Middleware](https://github.com/reduxjs/redux/blob/master/src/applyMiddleware.ts): `src/applyMiddleware.ts`
- [Function Composition](https://github.com/reduxjs/redux/blob/master/src/compose.ts): `src/compose.ts`
- [Action Binding](https://github.com/reduxjs/redux/blob/master/src/bindActionCreators.ts): `src/bindActionCreators.ts`

### Type Contracts

- [Core Types](https://github.com/reduxjs/redux/tree/master/src/types): `src/types`

### Runtime Utilities

- [Action Validation](https://github.com/reduxjs/redux/blob/master/src/utils/isAction.ts): `src/utils/isAction.ts`
- [Plain Object Check](https://github.com/reduxjs/redux/blob/master/src/utils/isPlainObject.ts): `src/utils/isPlainObject.ts`
- [Runtime Type Check](https://github.com/reduxjs/redux/blob/master/src/utils/kindOf.ts): `src/utils/kindOf.ts`
- [Internal Action Types](https://github.com/reduxjs/redux/blob/master/src/utils/actionTypes.ts): `src/utils/actionTypes.ts`
- [Observable Support](https://github.com/reduxjs/redux/blob/master/src/utils/symbol-observable.ts): `src/utils/symbol-observable.ts`

### Documentation Tooling

- [Remark Plugins](https://github.com/reduxjs/redux/tree/master/website/plugins/remark-typescript-tools): `website/plugins/remark-typescript-tools`
- [Codeblock Compiler](https://github.com/reduxjs/redux/blob/master/website/plugins/remark-typescript-tools/transpileCodeblocks/compiler.ts): `website/plugins/remark-typescript-tools/transpileCodeblocks/compiler.ts`
- [Docblock Extraction](https://github.com/reduxjs/redux/blob/master/website/plugins/remark-typescript-tools/linkDocblocks/extract.ts): `website/plugins/remark-typescript-tools/linkDocblocks/extract.ts`
- [TypeScript Bridge](https://github.com/reduxjs/redux/blob/master/website/plugins/remark-typescript-tools/ts7.cjs): `website/plugins/remark-typescript-tools/ts7.cjs`
- [Library Selection](https://github.com/reduxjs/redux/blob/master/website/src/components/useCurrentLibrary.ts): `website/src/components/useCurrentLibrary.ts`
- [Documentation Site](https://github.com/reduxjs/redux/tree/master/website/src): `website/src`

### Other components

- **Application**

## Connections

- Application → Public API: uses (evidence: `README.md`)
- Public API → State Store: exports (evidence: `src/index.ts`)
- Public API → Reducer Composition: exports (evidence: `src/index.ts`)
- Public API → Middleware: exports (evidence: `src/index.ts`)
- Public API → Function Composition: exports (evidence: `src/index.ts`)
- Public API → Action Binding: exports (evidence: `src/index.ts`)
- Public API → Core Types: exports types (evidence: `src/index.ts`)
- Public API → Action Validation: exports (evidence: `src/index.ts`)
- Public API → Plain Object Check: exports (evidence: `src/index.ts`)
- Application → State Store: dispatches actions (evidence: `README.md`)
- State Store → Reducer Composition: invokes reducer (evidence: `src/createStore.ts`)
- State Store → Core Types: implements contracts (evidence: `src/types/store.ts`)
- Reducer Composition → Internal Action Types: uses initialization types (evidence: `src/combineReducers.ts`)
- Reducer Composition → Plain Object Check: checks state (evidence: `src/combineReducers.ts`)
- Reducer Composition → Runtime Type Check: checks value types (evidence: `src/combineReducers.ts`)
- Middleware → Function Composition: uses composition (evidence: `src/applyMiddleware.ts`)
- Middleware → Core Types: uses contracts (evidence: `src/applyMiddleware.ts`)
- Action Binding → Core Types: uses contracts (evidence: `src/bindActionCreators.ts`)
- Action Binding → Runtime Type Check: checks values (evidence: `src/bindActionCreators.ts`)
- State Store → Plain Object Check: validates actions (evidence: `src/createStore.ts`)
- State Store → Runtime Type Check: checks value types (evidence: `src/createStore.ts`)
- State Store → Observable Support: provides observable (evidence: `src/createStore.ts`)
- Remark Plugins → Codeblock Compiler: uses compiler (evidence: `website/plugins/remark-typescript-tools/index.ts`)
- Remark Plugins → Docblock Extraction: uses extractor (evidence: `website/plugins/remark-typescript-tools/index.ts`)
- Docblock Extraction → TypeScript Bridge: imports API (evidence: `website/plugins/remark-typescript-tools/linkDocblocks/extract.ts`)
- Codeblock Compiler → TypeScript Bridge: loads TypeScript (evidence: `website/plugins/remark-typescript-tools/transpileCodeblocks/compiler.ts`)
- Documentation Site → Library Selection: uses library selection (evidence: `website/src/components/LibraryDropdownNavbarItem.tsx`)
