# reactivex/rxjs architecture

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

## Overview

This repository’s main product is RxJS 9, a platform-based library for composing asynchronous and event-driven programs, alongside a conditional Observable polyfill and a migration tool. The principal runtime workflow is consumer code using platform Observables and RxJS Symbol-keyed factories/operators, with ColdObservable available for producer-per-subscription behavior and AbortSignal-based cancellation. The migration package analyzes legacy test code, applies semantic and optional framework transformations, and reports diagnostics. Edges are limited to README-documented behavior and source-index or excerpt evidence; unsampled internals are not assumed to connect.

Main entry points: [`packages/migrate/src/index.ts`](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/index.ts) (Migration API), [`packages/migrate/src/semantics.ts`](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/semantics.ts) (Semantic Migration), [`packages/migrate/src/diagnostics.ts`](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/diagnostics.ts) (Diagnostics), [`packages/rxjs/src/index.ts`](https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/index.ts) (RxJS API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["RxJS Runtime"]
  node_rxjs["RxJS API<br/>[index.ts]"]
  node_factory["Observable Factory<br/>[create.ts]"]
  node_cold["Cold Observable<br/>[cold-observable.ts]"]
  node_operators["Symbol Operators<br/>[map.ts]"]
  node_subjects["Subjects<br/>[subject.ts]"]
  node_grouping["Group By<br/>[group-by.ts]"]
end

subgraph group_fallback["Platform Fallback"]
  node_polyfill["Observable Polyfill<br/>[index.ts]"]
end

subgraph group_migration["Migration Engine"]
  node_migrate["Migration API<br/>[index.ts]"]
  node_analysis["Source Analysis<br/>[analyze.ts]"]
  node_capabilities["Capability Registry<br/>[capabilities.ts]"]
  node_semantics["Semantic Migration<br/>[semantics.ts]"]
  node_framework["Framework Adapter"]
  node_diagnostics["Diagnostics<br/>[diagnostics.ts]"]
  node_schemas["Migration Schemas<br/>[schemas.ts]"]
  node_migration_types["Migration Contracts<br/>[types.ts]"]
end

subgraph group_contracts["Runtime Contracts"]
  node_platform["Platform Observable"]
end

node_consumer(("Library Consumer"))

node_consumer -->|"uses"| node_platform
node_consumer -->|"uses extensions"| node_rxjs
node_consumer -->|"creates producer"| node_cold
node_rxjs -.->|"exports symbols"| node_operators
node_rxjs -.->|"exports API"| node_factory
node_polyfill -->|"provides fallback"| node_platform
node_grouping -->|"creates stream"| node_factory
node_grouping -->|"creates groups"| node_subjects
node_consumer -.->|"requests migration"| node_migrate
node_migrate -->|"runs semantics"| node_semantics
node_migrate -->|"adapts framework"| node_framework
node_migrate -->|"sorts diagnostics"| node_diagnostics
node_semantics -->|"reports issues"| node_diagnostics
node_semantics -->|"validates registry"| node_schemas
node_semantics -->|"loads mappings"| node_capabilities
node_analysis -->|"uses registry"| node_capabilities
node_framework -->|"creates diagnostics"| node_diagnostics
node_diagnostics -->|"uses contracts"| node_migration_types
node_capabilities -->|"uses contracts"| node_migration_types
node_schemas -->|"validates contracts"| node_migration_types

click node_rxjs "https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/index.ts"
click node_factory "https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/create.ts"
click node_cold "https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/cold-observable.ts"
click node_operators "https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/map.ts"
click node_subjects "https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/subject.ts"
click node_grouping "https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/group-by.ts"
click node_polyfill "https://github.com/reactivex/rxjs/blob/master/packages/observable-polyfill/src/index.ts"
click node_migrate "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/index.ts"
click node_analysis "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/analyze.ts"
click node_capabilities "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/capabilities.ts"
click node_semantics "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/semantics.ts"
click node_framework "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/mocha-chai-vitest.ts"
click node_diagnostics "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/diagnostics.ts"
click node_schemas "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/schemas.ts"
click node_migration_types "https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/types.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_rxjs,node_factory,node_cold,node_operators,node_subjects,node_grouping toneBlue
class node_polyfill toneAmber
class node_migrate,node_analysis,node_capabilities,node_semantics,node_framework,node_diagnostics,node_schemas,node_migration_types toneMint
class node_platform toneRose
class node_consumer toneIndigo
```

## Components

### RxJS Runtime

- [RxJS API](https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/index.ts): `packages/rxjs/src/index.ts`
- [Observable Factory](https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/create.ts): `packages/rxjs/src/create.ts`
- [Cold Observable](https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/cold-observable.ts): `packages/rxjs/src/cold-observable.ts`
- [Symbol Operators](https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/map.ts): `packages/rxjs/src/map.ts`
- [Subjects](https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/subject.ts): `packages/rxjs/src/subject.ts`
- [Group By](https://github.com/reactivex/rxjs/blob/master/packages/rxjs/src/group-by.ts): `packages/rxjs/src/group-by.ts`

### Platform Fallback

- [Observable Polyfill](https://github.com/reactivex/rxjs/blob/master/packages/observable-polyfill/src/index.ts): `packages/observable-polyfill/src/index.ts`

### Migration Engine

- [Migration API](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/index.ts): `packages/migrate/src/index.ts`
- [Source Analysis](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/analyze.ts): `packages/migrate/src/analyze.ts`
- [Capability Registry](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/capabilities.ts): `packages/migrate/src/capabilities.ts`
- [Semantic Migration](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/semantics.ts): `packages/migrate/src/semantics.ts`
- [Framework Adapter](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/mocha-chai-vitest.ts): `packages/migrate/src/mocha-chai-vitest.ts`
- [Diagnostics](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/diagnostics.ts): `packages/migrate/src/diagnostics.ts`
- [Migration Schemas](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/schemas.ts): `packages/migrate/src/schemas.ts`
- [Migration Contracts](https://github.com/reactivex/rxjs/blob/master/packages/migrate/src/types.ts): `packages/migrate/src/types.ts`

### Runtime Contracts

- **Platform Observable**

### Other components

- **Library Consumer**

## Connections

- Library Consumer → Platform Observable: uses (evidence: `README.md`)
- Library Consumer → RxJS API: uses extensions (evidence: `README.md`)
- Library Consumer → Cold Observable: creates producer (evidence: `README.md`)
- RxJS API → Symbol Operators: exports symbols
- RxJS API → Observable Factory: exports API
- Observable Polyfill → Platform Observable: provides fallback (evidence: `README.md`)
- Group By → Observable Factory: creates stream (evidence: `packages/rxjs/src/group-by.ts`)
- Group By → Subjects: creates groups (evidence: `packages/rxjs/src/group-by.ts`)
- Library Consumer → Migration API: requests migration
- Migration API → Semantic Migration: runs semantics (evidence: `packages/migrate/src/index.ts`)
- Migration API → Framework Adapter: adapts framework (evidence: `packages/migrate/src/index.ts`)
- Migration API → Diagnostics: sorts diagnostics (evidence: `packages/migrate/src/index.ts`)
- Semantic Migration → Diagnostics: reports issues (evidence: `packages/migrate/src/semantics.ts`)
- Semantic Migration → Migration Schemas: validates registry (evidence: `packages/migrate/src/semantics.ts`)
- Semantic Migration → Capability Registry: loads mappings (evidence: `packages/migrate/src/semantics.ts`)
- Source Analysis → Capability Registry: uses registry (evidence: `packages/migrate/src/analyze.ts`)
- Framework Adapter → Diagnostics: creates diagnostics (evidence: `packages/migrate/src/mocha-chai-vitest.ts`)
- Diagnostics → Migration Contracts: uses contracts (evidence: `packages/migrate/src/diagnostics.ts`)
- Capability Registry → Migration Contracts: uses contracts (evidence: `packages/migrate/src/capabilities.ts`)
- Migration Schemas → Migration Contracts: validates contracts (evidence: `packages/migrate/src/schemas.ts`)
