# facebook/react-native architecture

> Architecture diagram of the GitHub repository facebook/react-native, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/facebook/react-native
- Repository: https://github.com/facebook/react-native

## Overview

##### Core Components & Architecture

a. Main Building Blocks:
- React Core (JavaScript)
- Native Modules Bridge
- Platform-specific Native Code (iOS/Android)
- JavaScript Engine (Hermes)

b. Key Components to Highlight:
- ReactInstanceManager
- UIManager
- Native Modules
- JavaScript Runtime
- Event System
- Renderer

##### Data Flow & Communication

- JavaScript to Native Bridge communication
- Event propagation
- State management
- UI updates

##### Major Subsystems

And represent the following subsystems:

a. JavaScript Core:
- React Components
- Virtual DOM
- Component Lifecycle
- State Management

b. Bridge Layer:
- Native Module Registry
- Method Invocation
- Event Emitter
- Serialization/Deserialization

c. Native Platforms:
- iOS Components (UIKit)
- Android Components (Android SDK)
- Native Modules
- Platform APIs

d. Development Tools:
- Metro Bundler
- Developer Menu
- Hot Reloading
- Debugging Infrastructure

##### Key Interactions

Following flows:
- Component Rendering Pipeline
- Event Handling
- Native Module Calls
- Bridge Communication
- State Updates

##### Supporting Infrastructure

Include:
- Build System
- Package Management
- Development Server
- Testing Infrastructure

Visual Representation Guidelines:

- JavaScript layer (e.g., blue)
- Native layer (e.g., green)
- Bridge components (e.g., orange)
- Development tools (e.g., purple)

##### Connection Types
- Double lines for data flow

##### Layer Organization
- Application Layer (top)
- Framework Layer (middle)
- Platform Layer (bottom)

Additional Considerations:

##### Performance Critical Paths
- Render cycle
- Event propagation
- Bridge communication

##### Development Workflow
- How code changes flow
- Hot reload paths
- Debug information flow

##### Error Handling
- Error boundaries
- Native error propagation
- JavaScript error handling

##### Security Boundaries
- JavaScript sandbox
- Native code permissions
- Bridge security

##### Scalability Aspects
- Component reuse
- Code splitting
- Resource management

##### Top Layer
- Application code
- React components
- JavaScript business logic

##### Middle Layer
- React Native framework
- Bridge
- Core modules

##### Bottom Layer
- Native platform code
- Platform-specific implementations
- Device APIs

Remember to:

##### Extension points

This structure will provide a comprehensive view of the React Native architecture while maintaining clarity and usefulness for a principal software engineer.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and classes
    classDef jsLayer fill:#a8d1f0,stroke:#333
    classDef nativeLayer fill:#90EE90,stroke:#333
    classDef bridge fill:#FFB347,stroke:#333
    classDef devTools fill:#DDA0DD,stroke:#333

    %% Legend
    subgraph Legend
        JS[JavaScript Layer]:::jsLayer
        NTV[Native Layer]:::nativeLayer
        BRG[Bridge Layer]:::bridge
        DEV[Development Tools]:::devTools
    end

    %% Application Layer
    subgraph ApplicationLayer
        ReactCore["React Core (JavaScript)"]:::jsLayer
        VirtualDOM["Virtual DOM"]:::jsLayer
        Components["React Components"]:::jsLayer
        StateManagement["State Management"]:::jsLayer
    end

    %% Framework Layer
    subgraph FrameworkLayer
        %% Bridge Components
        Bridge["Native Module Bridge"]:::bridge
        EventSystem["Event System"]:::bridge
        ModuleRegistry["Native Module Registry"]:::bridge
        
        %% Core Components
        ReactInstance["React Instance Manager"]:::jsLayer
        UIManager["UI Manager"]:::jsLayer
        Renderer["Renderer"]:::jsLayer
        
        %% JavaScript Engine
        Hermes["Hermes JS Engine"]:::jsLayer
    end

    %% Platform Layer
    subgraph PlatformLayer
        %% iOS
        subgraph iOSPlatform
            iOSComponents["iOS Components (UIKit)"]:::nativeLayer
            iOSModules["iOS Native Modules"]:::nativeLayer
        end
        
        %% Android
        subgraph AndroidPlatform
            AndroidComponents["Android Components (SDK)"]:::nativeLayer
            AndroidModules["Android Native Modules"]:::nativeLayer
        end
    end

    %% Development Tools
    subgraph DevTools
        MetroBundler["Metro Bundler"]:::devTools
        DevMenu["Developer Menu"]:::devTools
        HotReload["Hot Reloading"]:::devTools
        DebugInfra["Debug Infrastructure"]:::devTools
    end

    %% Relationships
    ReactCore --> VirtualDOM
    VirtualDOM --> Components
    Components --> StateManagement
    Components --> Bridge
    Bridge --> ModuleRegistry
    ModuleRegistry --> iOSModules
    ModuleRegistry --> AndroidModules
    Bridge --> EventSystem
    EventSystem --> ReactInstance
    ReactInstance --> UIManager
    UIManager --> Renderer
    Renderer --> iOSComponents
    Renderer --> AndroidComponents
    Bridge --> Hermes

    %% Development Tool Connections
    MetroBundler -.-> ReactCore
    DevMenu -.-> ReactInstance
    HotReload -.-> Components
    DebugInfra -.-> Bridge

    %% Click Events
    click Bridge "https://github.com/facebook/react-native/tree/main/packages/react-native/ReactCommon/react/bridge/"
    click Hermes "https://github.com/facebook/react-native/blob/main/packages/react-native/ReactCommon/hermes/executor/HermesExecutorFactory.cpp"
    click UIManager "https://github.com/facebook/react-native/blob/main/packages/react-native/ReactCommon/react/renderer/uimanager/UIManager.h"
    click EventSystem "https://github.com/facebook/react-native/blob/main/packages/react-native/ReactCommon/react/renderer/events/EventEmitter.h"
    click ReactInstance "https://github.com/facebook/react-native/blob/main/packages/react-native/ReactAndroid/src/main/java/com/facebook/react/ReactInstanceManager.java"
    click iOSComponents "https://github.com/facebook/react-native/tree/main/packages/react-native/React/Base/"
    click AndroidComponents "https://github.com/facebook/react-native/tree/main/packages/react-native/ReactAndroid/src/main/java/com/facebook/react/"
    click Renderer "https://github.com/facebook/react-native/tree/main/packages/react-native/ReactCommon/react/renderer/core/"
    click DebugInfra "https://github.com/facebook/react-native/tree/main/packages/react-native/ReactCommon/react/debug/"
    click Components "https://github.com/facebook/react-native/tree/main/packages/react-native/Libraries/Components/"
```
