# mobxjs/mobx architecture

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

## Overview

MobX is a reactive state-management library with companion React bindings, a Babel transform plugin, and ESLint rules. The principal workflow is to model state as observable, derive or react to changes, and update observed React UI when dependencies change. The graph includes the core runtime stages and the main companion packages. Relationships are limited to README statements and references visible in the supplied excerpts or SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`packages/mobx/src/api/observable.ts`](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/observable.ts) (Observable API), [`packages/mobx-react-lite/src/useObserver.ts`](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/useObserver.ts) (Hook Observer), [`packages/mobx-react/src/observerClass.ts`](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react/src/observerClass.ts) (Class Observer), [`packages/mobx/src/core/reaction.ts`](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/reaction.ts) (Reactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["MobX Runtime"]
  node_observable_api["Observable API<br/>[observable.ts]"]
  node_object_api["Object API<br/>[object-api.ts]"]
  node_observable_values["Observable Values"]
  node_actions["Actions<br/>[action.ts]"]
  node_computed["Computed Values<br/>[computedvalue.ts]"]
  node_derivations["Dependency Tracking<br/>[derivation.ts]"]
  node_reactions["Reactions<br/>[reaction.ts]"]
  node_global_state["Global State<br/>[globalstate.ts]"]
  node_autorun["Autorun<br/>[autorun.ts]"]
  node_flows["Async Flows<br/>[flow.ts]"]
end

subgraph group_react["React Bindings"]
  node_react_observer["Class Observer<br/>[observerClass.ts]"]
  node_react_component["Observer Wrapper<br/>[observer.tsx]"]
  node_hook_observer["Hook Observer<br/>[useObserver.ts]"]
  node_static_rendering["Static Rendering<br/>[staticRendering.ts]"]
  node_finalization_registry["Observer Registry"]
  node_universal_registry["Registry Fallback"]
end

subgraph group_transform["React Transform"]
  node_transformer["AST Transform<br/>[transform.ts]"]
  node_transform_imports["Import Rewriting<br/>[imports.ts]"]
  node_transform_options["Transform Options<br/>[options.ts]"]
end

subgraph group_lint["MobX Linting"]
  node_eslint_rules["MobX Rules"]
end

node_developer(("Application Developer"))

node_developer -->|"models state"| node_observable_api
node_developer -->|"wraps UI"| node_react_component
node_observable_api -->|"creates observables"| node_observable_values
node_react_component -->|"delegates to"| node_react_observer
node_react_observer -.->|"uses"| node_hook_observer
node_react_observer -->|"creates reaction"| node_reactions
node_hook_observer -->|"creates reaction"| node_reactions
node_hook_observer -->|"checks mode"| node_static_rendering
node_hook_observer -->|"registers observer"| node_finalization_registry
node_finalization_registry -->|"uses fallback"| node_universal_registry
node_transformer -->|"rewrites imports"| node_transform_imports
node_transformer -->|"reads options"| node_transform_options
node_observable_api -.->|"tracks dependencies"| node_derivations
node_derivations -->|"checks computed"| node_computed
node_developer -.->|"uses API"| node_object_api
node_developer -.->|"sets reactions"| node_autorun
node_developer -.->|"runs async work"| node_flows
node_developer -.->|"checks code"| node_eslint_rules
node_observable_api -.->|"annotates updates"| node_actions
node_reactions -.->|"uses runtime state"| node_global_state

click node_observable_api "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/observable.ts"
click node_object_api "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/object-api.ts"
click node_observable_values "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/types/observableobject.ts"
click node_actions "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/action.ts"
click node_computed "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/computedvalue.ts"
click node_derivations "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/derivation.ts"
click node_reactions "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/reaction.ts"
click node_global_state "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/globalstate.ts"
click node_autorun "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/autorun.ts"
click node_flows "https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/flow.ts"
click node_react_observer "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react/src/observerClass.ts"
click node_react_component "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react/src/observer.tsx"
click node_hook_observer "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/useObserver.ts"
click node_static_rendering "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/staticRendering.ts"
click node_finalization_registry "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/utils/observerFinalizationRegistry.ts"
click node_universal_registry "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/utils/UniversalFinalizationRegistry.ts"
click node_transformer "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-plugin/src/transform.ts"
click node_transform_imports "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-plugin/src/imports.ts"
click node_transform_options "https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-plugin/src/options.ts"
click node_eslint_rules "https://github.com/mobxjs/mobx/tree/main/packages/eslint-plugin-mobx/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_observable_api,node_object_api,node_observable_values,node_actions,node_computed,node_derivations,node_reactions,node_global_state,node_autorun,node_flows toneBlue
class node_react_observer,node_react_component,node_hook_observer,node_static_rendering,node_finalization_registry,node_universal_registry toneAmber
class node_transformer,node_transform_imports,node_transform_options toneMint
class node_eslint_rules toneRose
class node_developer toneIndigo
```

## Components

### MobX Runtime

- [Observable API](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/observable.ts): `packages/mobx/src/api/observable.ts`
- [Object API](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/object-api.ts): `packages/mobx/src/api/object-api.ts`
- [Observable Values](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/types/observableobject.ts): `packages/mobx/src/types/observableobject.ts`
- [Actions](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/action.ts): `packages/mobx/src/core/action.ts`
- [Computed Values](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/computedvalue.ts): `packages/mobx/src/core/computedvalue.ts`
- [Dependency Tracking](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/derivation.ts): `packages/mobx/src/core/derivation.ts`
- [Reactions](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/reaction.ts): `packages/mobx/src/core/reaction.ts`
- [Global State](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/core/globalstate.ts): `packages/mobx/src/core/globalstate.ts`
- [Autorun](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/autorun.ts): `packages/mobx/src/api/autorun.ts`
- [Async Flows](https://github.com/mobxjs/mobx/blob/main/packages/mobx/src/api/flow.ts): `packages/mobx/src/api/flow.ts`

### React Bindings

- [Class Observer](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react/src/observerClass.ts): `packages/mobx-react/src/observerClass.ts`
- [Observer Wrapper](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react/src/observer.tsx): `packages/mobx-react/src/observer.tsx`
- [Hook Observer](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/useObserver.ts): `packages/mobx-react-lite/src/useObserver.ts`
- [Static Rendering](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/staticRendering.ts): `packages/mobx-react-lite/src/staticRendering.ts`
- [Observer Registry](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/utils/observerFinalizationRegistry.ts): `packages/mobx-react-lite/src/utils/observerFinalizationRegistry.ts`
- [Registry Fallback](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-lite/src/utils/UniversalFinalizationRegistry.ts): `packages/mobx-react-lite/src/utils/UniversalFinalizationRegistry.ts`

### React Transform

- [AST Transform](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-plugin/src/transform.ts): `packages/mobx-react-plugin/src/transform.ts`
- [Import Rewriting](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-plugin/src/imports.ts): `packages/mobx-react-plugin/src/imports.ts`
- [Transform Options](https://github.com/mobxjs/mobx/blob/main/packages/mobx-react-plugin/src/options.ts): `packages/mobx-react-plugin/src/options.ts`

### MobX Linting

- [MobX Rules](https://github.com/mobxjs/mobx/tree/main/packages/eslint-plugin-mobx/src): `packages/eslint-plugin-mobx/src`

### Other components

- **Application Developer**

## Connections

- Application Developer → Observable API: models state (evidence: `README.md`)
- Application Developer → Observer Wrapper: wraps UI (evidence: `README.md`)
- Observable API → Observable Values: creates observables (evidence: `packages/mobx/src/api/observable.ts`)
- Observer Wrapper → Class Observer: delegates to (evidence: `packages/mobx-react/src/observer.tsx`)
- Class Observer → Hook Observer: uses
- Class Observer → Reactions: creates reaction (evidence: `packages/mobx-react/src/observerClass.ts`)
- Hook Observer → Reactions: creates reaction (evidence: `packages/mobx-react-lite/src/useObserver.ts`)
- Hook Observer → Static Rendering: checks mode (evidence: `packages/mobx-react-lite/src/useObserver.ts`)
- Hook Observer → Observer Registry: registers observer (evidence: `packages/mobx-react-lite/src/useObserver.ts`)
- Observer Registry → Registry Fallback: uses fallback (evidence: `packages/mobx-react-lite/src/utils/observerFinalizationRegistry.ts`)
- AST Transform → Import Rewriting: rewrites imports (evidence: `packages/mobx-react-plugin/src/transform.ts`)
- AST Transform → Transform Options: reads options (evidence: `packages/mobx-react-plugin/src/transform.ts`)
- Observable API → Dependency Tracking: tracks dependencies
- Dependency Tracking → Computed Values: checks computed (evidence: `packages/mobx/src/core/derivation.ts`)
- Application Developer → Object API: uses API
- Application Developer → Autorun: sets reactions
- Application Developer → Async Flows: runs async work
- Application Developer → MobX Rules: checks code
- Observable API → Actions: annotates updates
- Reactions → Global State: uses runtime state
