# reduxjs/react-redux architecture

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

## Overview

React Redux provides React components and hooks that expose a Redux store to a component tree, select state, and bind dispatch behavior. The main workflow begins with Provider publishing the store and subscription context; components then use hooks or connect to read state and dispatch actions, with subscriptions coordinating updates. The connect path additionally derives and merges component props. The graph reflects the README’s stated role and the sampled implementation; unsampled modules are included where the source index identifies them, but their internal behavior is not inferred beyond listed references.

Main entry points: [`src/components/connect.tsx`](https://github.com/reduxjs/react-redux/blob/master/src/components/connect.tsx) (connect wrapper), [`src/connect/selectorFactory.ts`](https://github.com/reduxjs/react-redux/blob/master/src/connect/selectorFactory.ts) (Props selector), [`src/components/Provider.tsx`](https://github.com/reduxjs/react-redux/blob/master/src/components/Provider.tsx) (Provider), [`src/exports.ts`](https://github.com/reduxjs/react-redux/blob/master/src/exports.ts) (Public exports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_context["Store Context"]
  node_provider["Provider<br/>[Provider.tsx]"]
  node_contextvalue["Redux context<br/>[Context.ts]"]
end

subgraph group_bindings["React Bindings"]
  node_selectorhook["useSelector<br/>[useSelector.ts]"]
  node_dispatchhook["useDispatch<br/>[useDispatch.ts]"]
  node_storehook["useStore<br/>[useStore.ts]"]
  node_contexthook["Context hook<br/>[useReduxContext.ts]"]
  node_publicapi["Public exports<br/>[exports.ts]"]
end

subgraph group_connect["Connected Components"]
  node_connect["connect wrapper<br/>[connect.tsx]"]
  node_selectorfactory["Props selector<br/>[selectorFactory.ts]"]
  node_mapstate["State mapping<br/>[mapStateToProps.ts]"]
  node_mapdispatch["Dispatch mapping"]
  node_mergeprops["Prop merging<br/>[mergeProps.ts]"]
  node_wrapmap["Mapper wrapping<br/>[wrapMapToProps.ts]"]
end

subgraph group_internals["Shared Internals"]
  node_subscription["Subscriptions<br/>[Subscription.ts]"]
  node_effect["Layout effect"]
  node_equality["Shallow equality<br/>[shallowEqual.ts]"]
end

node_app(("React application"))
node_redux[("Redux store")]
node_react["React runtime"]
node_externalselector["External selector utility"]

node_app -->|"wraps tree"| node_provider
node_provider -->|"receives store"| node_redux
node_provider -->|"creates subscription"| node_subscription
node_provider -->|"provides context"| node_contextvalue
node_provider -->|"uses effect"| node_effect
node_contextvalue -->|"creates context"| node_react
node_connect -->|"reads context"| node_contextvalue
node_connect -->|"creates subscription"| node_subscription
node_connect -->|"uses effect"| node_effect
node_connect -->|"configures selector"| node_selectorfactory
node_connect -->|"configures mapper"| node_mapstate
node_connect -->|"configures mapper"| node_mapdispatch
node_connect -->|"configures merger"| node_mergeprops
node_connect -->|"uses equality"| node_equality
node_selectorfactory -->|"calls mapper"| node_mapstate
node_selectorfactory -->|"calls mapper"| node_mapdispatch
node_selectorfactory -->|"merges props"| node_mergeprops
node_selectorfactory -->|"initializes mappers"| node_wrapmap
node_selectorfactory -->|"initializes mappers"| node_wrapmap
node_selectorfactory -->|"checks subselectors"| node_react
node_selectorhook -->|"gets context"| node_contexthook
node_selectorhook -->|"reads store context"| node_contextvalue
node_selectorhook -->|"subscribes and selects"| node_externalselector
node_storehook -->|"gets context"| node_contexthook
node_contexthook -->|"reads context"| node_contextvalue
node_dispatchhook -->|"gets store"| node_storehook
node_publicapi -->|"exports"| node_provider
node_publicapi -->|"exports"| node_connect
node_publicapi -->|"exports"| node_selectorhook
node_publicapi -->|"exports"| node_dispatchhook
node_publicapi -->|"exports"| node_storehook

click node_provider "https://github.com/reduxjs/react-redux/blob/master/src/components/Provider.tsx"
click node_contextvalue "https://github.com/reduxjs/react-redux/blob/master/src/components/Context.ts"
click node_subscription "https://github.com/reduxjs/react-redux/blob/master/src/utils/Subscription.ts"
click node_connect "https://github.com/reduxjs/react-redux/blob/master/src/components/connect.tsx"
click node_selectorfactory "https://github.com/reduxjs/react-redux/blob/master/src/connect/selectorFactory.ts"
click node_mapstate "https://github.com/reduxjs/react-redux/blob/master/src/connect/mapStateToProps.ts"
click node_mapdispatch "https://github.com/reduxjs/react-redux/blob/master/src/connect/mapDispatchToProps.ts"
click node_mergeprops "https://github.com/reduxjs/react-redux/blob/master/src/connect/mergeProps.ts"
click node_wrapmap "https://github.com/reduxjs/react-redux/blob/master/src/connect/wrapMapToProps.ts"
click node_selectorhook "https://github.com/reduxjs/react-redux/blob/master/src/hooks/useSelector.ts"
click node_dispatchhook "https://github.com/reduxjs/react-redux/blob/master/src/hooks/useDispatch.ts"
click node_storehook "https://github.com/reduxjs/react-redux/blob/master/src/hooks/useStore.ts"
click node_contexthook "https://github.com/reduxjs/react-redux/blob/master/src/hooks/useReduxContext.ts"
click node_effect "https://github.com/reduxjs/react-redux/blob/master/src/utils/useIsomorphicLayoutEffect.ts"
click node_equality "https://github.com/reduxjs/react-redux/blob/master/src/utils/shallowEqual.ts"
click node_publicapi "https://github.com/reduxjs/react-redux/blob/master/src/exports.ts"

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_provider,node_contextvalue toneBlue
class node_selectorhook,node_dispatchhook,node_storehook,node_contexthook,node_publicapi,node_redux toneAmber
class node_connect,node_selectorfactory,node_mapstate,node_mapdispatch,node_mergeprops,node_wrapmap toneMint
class node_subscription,node_effect,node_equality toneRose
class node_app,node_react,node_externalselector toneIndigo
```

## Components

### Store Context

- [Provider](https://github.com/reduxjs/react-redux/blob/master/src/components/Provider.tsx): `src/components/Provider.tsx`
- [Redux context](https://github.com/reduxjs/react-redux/blob/master/src/components/Context.ts): `src/components/Context.ts`

### React Bindings

- [useSelector](https://github.com/reduxjs/react-redux/blob/master/src/hooks/useSelector.ts): `src/hooks/useSelector.ts`
- [useDispatch](https://github.com/reduxjs/react-redux/blob/master/src/hooks/useDispatch.ts): `src/hooks/useDispatch.ts`
- [useStore](https://github.com/reduxjs/react-redux/blob/master/src/hooks/useStore.ts): `src/hooks/useStore.ts`
- [Context hook](https://github.com/reduxjs/react-redux/blob/master/src/hooks/useReduxContext.ts): `src/hooks/useReduxContext.ts`
- [Public exports](https://github.com/reduxjs/react-redux/blob/master/src/exports.ts): `src/exports.ts`

### Connected Components

- [connect wrapper](https://github.com/reduxjs/react-redux/blob/master/src/components/connect.tsx): `src/components/connect.tsx`
- [Props selector](https://github.com/reduxjs/react-redux/blob/master/src/connect/selectorFactory.ts): `src/connect/selectorFactory.ts`
- [State mapping](https://github.com/reduxjs/react-redux/blob/master/src/connect/mapStateToProps.ts): `src/connect/mapStateToProps.ts`
- [Dispatch mapping](https://github.com/reduxjs/react-redux/blob/master/src/connect/mapDispatchToProps.ts): `src/connect/mapDispatchToProps.ts`
- [Prop merging](https://github.com/reduxjs/react-redux/blob/master/src/connect/mergeProps.ts): `src/connect/mergeProps.ts`
- [Mapper wrapping](https://github.com/reduxjs/react-redux/blob/master/src/connect/wrapMapToProps.ts): `src/connect/wrapMapToProps.ts`

### Shared Internals

- [Subscriptions](https://github.com/reduxjs/react-redux/blob/master/src/utils/Subscription.ts): `src/utils/Subscription.ts`
- [Layout effect](https://github.com/reduxjs/react-redux/blob/master/src/utils/useIsomorphicLayoutEffect.ts): `src/utils/useIsomorphicLayoutEffect.ts`
- [Shallow equality](https://github.com/reduxjs/react-redux/blob/master/src/utils/shallowEqual.ts): `src/utils/shallowEqual.ts`

### Other components

- **React application**
- **Redux store**
- **React runtime**
- **External selector utility**

## Connections

- React application → Provider: wraps tree (evidence: `README.md`)
- Provider → Redux store: receives store (evidence: `src/components/Provider.tsx`)
- Provider → Subscriptions: creates subscription (evidence: `src/components/Provider.tsx`)
- Provider → Redux context: provides context (evidence: `src/components/Provider.tsx`)
- Provider → Layout effect: uses effect (evidence: `src/components/Provider.tsx`)
- Redux context → React runtime: creates context (evidence: `src/components/Context.ts`)
- connect wrapper → Redux context: reads context (evidence: `src/components/connect.tsx`)
- connect wrapper → Subscriptions: creates subscription (evidence: `src/components/connect.tsx`)
- connect wrapper → Layout effect: uses effect (evidence: `src/components/connect.tsx`)
- connect wrapper → Props selector: configures selector (evidence: `src/components/connect.tsx`)
- connect wrapper → State mapping: configures mapper (evidence: `src/components/connect.tsx`)
- connect wrapper → Dispatch mapping: configures mapper (evidence: `src/components/connect.tsx`)
- connect wrapper → Prop merging: configures merger (evidence: `src/components/connect.tsx`)
- connect wrapper → Shallow equality: uses equality (evidence: `src/components/connect.tsx`)
- Props selector → State mapping: calls mapper (evidence: `src/connect/selectorFactory.ts`)
- Props selector → Dispatch mapping: calls mapper (evidence: `src/connect/selectorFactory.ts`)
- Props selector → Prop merging: merges props (evidence: `src/connect/selectorFactory.ts`)
- Props selector → Mapper wrapping: initializes mappers (evidence: `src/connect/mapStateToProps.ts`)
- Props selector → Mapper wrapping: initializes mappers (evidence: `src/connect/mapDispatchToProps.ts`)
- Props selector → React runtime: checks subselectors (evidence: `src/connect/selectorFactory.ts`)
- useSelector → Context hook: gets context (evidence: `src/hooks/useSelector.ts`)
- useSelector → Redux context: reads store context (evidence: `src/hooks/useSelector.ts`)
- useSelector → External selector utility: subscribes and selects (evidence: `src/hooks/useSelector.ts`)
- useStore → Context hook: gets context (evidence: `src/hooks/useStore.ts`)
- Context hook → Redux context: reads context (evidence: `src/hooks/useReduxContext.ts`)
- useDispatch → useStore: gets store (evidence: `src/hooks/useDispatch.ts`)
- Public exports → Provider: exports (evidence: `src/exports.ts`)
- Public exports → connect wrapper: exports (evidence: `src/exports.ts`)
- Public exports → useSelector: exports (evidence: `src/exports.ts`)
- Public exports → useDispatch: exports (evidence: `src/exports.ts`)
- Public exports → useStore: exports (evidence: `src/exports.ts`)
