# jedwatson/react-select architecture

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

## Overview

React Select is a customizable React select control. The principal workflow is a user opening the control, searching and choosing options, then receiving a single or multi-value change; state management can be controlled by props or maintained internally. The graph also captures async loading, option creation, accessibility, menu behavior, component injection, styling, and animation. Relationships are limited to README statements and indexed imports or excerpted calls; unsampled feature wiring is not asserted.

Main entry points: [`packages/react-select/src/Select.tsx`](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/Select.tsx) (Select control), [`packages/react-select/src/styles.ts`](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/styles.ts) (Style API), [`packages/react-select/src/components/index.ts`](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/index.ts) (Injectable components), [`packages/react-select/src/components/MultiValue.tsx`](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/MultiValue.tsx) (Value rendering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Selection interaction"]
  node_select["Select control<br/>[Select.tsx]"]
  node_accessibility["Screen reader guidance<br/>[index.ts]"]
  node_live["Live announcements<br/>[LiveRegion.tsx]"]
  node_scroll["Scroll management<br/>[ScrollManager.tsx]"]
end

subgraph group_extensions["Selection extensions"]
  node_async["Async options<br/>[useAsync.ts]"]
  node_asynccontrol["Async select<br/>[Async.tsx]"]
  node_creation["Option creation<br/>[useCreatable.ts]"]
  node_creatablecontrol["Creatable select<br/>[Creatable.tsx]"]
  node_asynccreation["Async creatable<br/>[AsyncCreatable.tsx]"]
end

subgraph group_presentation["UI and presentation"]
  node_components["Injectable components<br/>[index.ts]"]
  node_menu["Menu and portal<br/>[Menu.tsx]"]
  node_valueui["Value rendering<br/>[MultiValue.tsx]"]
  node_indicators["Control indicators<br/>[indicators.tsx]"]
  node_layout["Control layout<br/>[containers.tsx]"]
  node_styles["Style API<br/>[styles.ts]"]
  node_theme["Theme<br/>[theme.ts]"]
  node_animation["Animated components<br/>[transitions.tsx]"]
end

subgraph group_foundation["State and behavior"]
  node_state["Controllable state<br/>[useStateManager.ts]"]
  node_statewrapper["State wrapper<br/>[stateManager.tsx]"]
  node_filtering["Option filtering<br/>[filters.ts]"]
  node_sharedutils["Shared utilities<br/>[utils.ts]"]
  node_types["Shared types<br/>[types.ts]"]
end

node_user(("User"))

node_user -->|"uses"| node_select
node_select -->|"uses state"| node_state
node_statewrapper -->|"wraps"| node_state
node_statewrapper -->|"renders"| node_select
node_select -->|"filters options"| node_filtering
node_select -->|"uses helpers"| node_sharedutils
node_asynccontrol -.->|"uses"| node_async
node_asynccontrol -.->|"renders"| node_select
node_creatablecontrol -.->|"uses"| node_creation
node_creatablecontrol -.->|"renders"| node_select
node_asynccreation -.->|"combines"| node_async
node_asynccreation -.->|"combines"| node_creation
node_select -->|"uses components"| node_components
node_select -->|"renders menu"| node_menu
node_select -->|"renders announcements"| node_live
node_select -->|"uses guidance"| node_accessibility
node_live -->|"uses guidance"| node_accessibility
node_select -->|"manages scrolling"| node_scroll
node_menu -->|"uses helpers"| node_sharedutils
node_valueui -->|"uses icon"| node_indicators
node_components -->|"exports"| node_valueui
node_components -->|"exports"| node_layout
node_components -->|"exports"| node_indicators
node_styles -->|"styles"| node_layout
node_styles -->|"styles"| node_menu
node_styles -->|"styles"| node_valueui
node_styles -->|"styles"| node_indicators
node_select -->|"uses styles"| node_styles
node_select -->|"uses theme"| node_theme
node_animation -->|"animates values"| node_valueui
node_types -->|"types"| node_select

click node_select "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/Select.tsx"
click node_state "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/useStateManager.ts"
click node_statewrapper "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/stateManager.tsx"
click node_filtering "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/filters.ts"
click node_sharedutils "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/utils.ts"
click node_async "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/useAsync.ts"
click node_asynccontrol "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/Async.tsx"
click node_creation "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/useCreatable.ts"
click node_creatablecontrol "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/Creatable.tsx"
click node_asynccreation "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/AsyncCreatable.tsx"
click node_components "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/index.ts"
click node_menu "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/Menu.tsx"
click node_valueui "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/MultiValue.tsx"
click node_indicators "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/indicators.tsx"
click node_layout "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/containers.tsx"
click node_styles "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/styles.ts"
click node_theme "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/theme.ts"
click node_animation "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/animated/transitions.tsx"
click node_accessibility "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/accessibility/index.ts"
click node_live "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/LiveRegion.tsx"
click node_scroll "https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/internal/ScrollManager.tsx"
click node_types "https://github.com/jedwatson/react-select/blob/master/packages/react-select/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_select,node_accessibility,node_live,node_scroll,node_user toneBlue
class node_async,node_asynccontrol,node_creation,node_creatablecontrol,node_asynccreation toneAmber
class node_components,node_menu,node_valueui,node_indicators,node_layout,node_styles,node_theme,node_animation toneMint
class node_state,node_statewrapper,node_filtering,node_sharedutils,node_types toneRose
```

## Components

### Selection interaction

- [Select control](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/Select.tsx): `packages/react-select/src/Select.tsx`
- [Screen reader guidance](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/accessibility/index.ts): `packages/react-select/src/accessibility/index.ts`
- [Live announcements](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/LiveRegion.tsx): `packages/react-select/src/components/LiveRegion.tsx`
- [Scroll management](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/internal/ScrollManager.tsx): `packages/react-select/src/internal/ScrollManager.tsx`

### Selection extensions

- [Async options](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/useAsync.ts): `packages/react-select/src/useAsync.ts`
- [Async select](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/Async.tsx): `packages/react-select/src/Async.tsx`
- [Option creation](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/useCreatable.ts): `packages/react-select/src/useCreatable.ts`
- [Creatable select](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/Creatable.tsx): `packages/react-select/src/Creatable.tsx`
- [Async creatable](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/AsyncCreatable.tsx): `packages/react-select/src/AsyncCreatable.tsx`

### UI and presentation

- [Injectable components](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/index.ts): `packages/react-select/src/components/index.ts`
- [Menu and portal](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/Menu.tsx): `packages/react-select/src/components/Menu.tsx`
- [Value rendering](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/MultiValue.tsx): `packages/react-select/src/components/MultiValue.tsx`
- [Control indicators](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/indicators.tsx): `packages/react-select/src/components/indicators.tsx`
- [Control layout](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/components/containers.tsx): `packages/react-select/src/components/containers.tsx`
- [Style API](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/styles.ts): `packages/react-select/src/styles.ts`
- [Theme](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/theme.ts): `packages/react-select/src/theme.ts`
- [Animated components](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/animated/transitions.tsx): `packages/react-select/src/animated/transitions.tsx`

### State and behavior

- [Controllable state](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/useStateManager.ts): `packages/react-select/src/useStateManager.ts`
- [State wrapper](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/stateManager.tsx): `packages/react-select/src/stateManager.tsx`
- [Option filtering](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/filters.ts): `packages/react-select/src/filters.ts`
- [Shared utilities](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/utils.ts): `packages/react-select/src/utils.ts`
- [Shared types](https://github.com/jedwatson/react-select/blob/master/packages/react-select/src/types.ts): `packages/react-select/src/types.ts`

### Other components

- **User**

## Connections

- User → Select control: uses (evidence: `README.md`)
- Select control → Controllable state: uses state (evidence: `packages/react-select/src/useStateManager.ts`)
- State wrapper → Controllable state: wraps (evidence: `packages/react-select/src/stateManager.tsx`)
- State wrapper → Select control: renders (evidence: `packages/react-select/src/stateManager.tsx`)
- Select control → Option filtering: filters options (evidence: `packages/react-select/src/Select.tsx`)
- Select control → Shared utilities: uses helpers (evidence: `packages/react-select/src/Select.tsx`)
- Async select → Async options: uses
- Async select → Select control: renders
- Creatable select → Option creation: uses
- Creatable select → Select control: renders
- Async creatable → Async options: combines
- Async creatable → Option creation: combines
- Select control → Injectable components: uses components (evidence: `packages/react-select/src/Select.tsx`)
- Select control → Menu and portal: renders menu (evidence: `packages/react-select/src/Select.tsx`)
- Select control → Live announcements: renders announcements (evidence: `packages/react-select/src/Select.tsx`)
- Select control → Screen reader guidance: uses guidance (evidence: `packages/react-select/src/Select.tsx`)
- Live announcements → Screen reader guidance: uses guidance (evidence: `packages/react-select/src/components/LiveRegion.tsx`)
- Select control → Scroll management: manages scrolling (evidence: `packages/react-select/src/Select.tsx`)
- Menu and portal → Shared utilities: uses helpers (evidence: `packages/react-select/src/components/Menu.tsx`)
- Value rendering → Control indicators: uses icon (evidence: `packages/react-select/src/components/MultiValue.tsx`)
- Injectable components → Value rendering: exports (evidence: `packages/react-select/src/components/index.ts`)
- Injectable components → Control layout: exports (evidence: `packages/react-select/src/components/index.ts`)
- Injectable components → Control indicators: exports (evidence: `packages/react-select/src/components/index.ts`)
- Style API → Control layout: styles (evidence: `packages/react-select/src/styles.ts`)
- Style API → Menu and portal: styles (evidence: `packages/react-select/src/styles.ts`)
- Style API → Value rendering: styles (evidence: `packages/react-select/src/styles.ts`)
- Style API → Control indicators: styles (evidence: `packages/react-select/src/styles.ts`)
- Select control → Style API: uses styles (evidence: `packages/react-select/src/Select.tsx`)
- Select control → Theme: uses theme (evidence: `packages/react-select/src/Select.tsx`)
- Animated components → Value rendering: animates values (evidence: `packages/react-select/src/animated/transitions.tsx`)
- Shared types → Select control: types (evidence: `packages/react-select/src/types.ts`)
