# ml-in-barcelona/server-reason-react architecture

> Architecture diagram of the GitHub repository ml-in-barcelona/server-reason-react, 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/ml-in-barcelona/server-reason-react
- Repository: https://github.com/ml-in-barcelona/server-reason-react

## Overview

##### Main Components

a. Core Components:
- React Core Implementation
- ReactDOM Server Implementation
- Browser/Client-side Runtime
- Native/Server-side Runtime
- PPX System (Preprocessor Extensions)

b. Supporting Libraries:
- Belt (Standard Library)
- Promise Implementation
- Web API Bindings
- Fetch/URL/DOM Implementations

##### Special Elements

- PPX transformations
- JavaScript interop bridges
- Server-side rendering streams
- Universal component definitions

##### Implementation Details

Implementation aspects:
- React component lifecycle
- Server-side rendering pipeline
- PPX transformation flow
- Native/JS compilation targets

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Client Layer"
        Browser["Browser Runtime"]:::browser
        ClientComp["Client-side Components"]:::client
        BrowserPPX["Browser PPX"]:::ppx
        WebAPI["Web API Bindings"]:::api
        DOM["DOM Implementation"]:::api
        Fetch["Fetch Implementation"]:::api
        URL["URL Implementation"]:::api
    end

    subgraph "Universal Layer"
        ReactCore["React Core Implementation"]:::core
        Belt["Belt Standard Library"]:::lib
        Promise["Promise Implementation"]:::lib
        UnivComp["Universal Components"]:::universal
        PPX["PPX System"]:::ppx
    end

    subgraph "Server Layer"
        ServerRuntime["Server Runtime"]:::server
        ReactDOMServer["ReactDOM Server"]:::server
        ServerComp["Server-side Components"]:::server
        Runtime["Runtime System"]:::server
    end

    %% Relationships
    Browser --> ClientComp
    Browser --> WebAPI
    WebAPI --> DOM
    WebAPI --> Fetch
    WebAPI --> URL
    
    ClientComp --> ReactCore
    ServerComp --> ReactCore
    UnivComp --> ReactCore
    
    ReactCore --> Belt
    ReactCore --> Promise
    
    PPX --> BrowserPPX
    PPX --> UnivComp
    
    ServerRuntime --> ReactDOMServer
    ReactDOMServer --> Runtime
    ServerComp --> ReactDOMServer

    %% Click Events
    click Browser "https://github.com/ml-in-barcelona/server-reason-react/tree/main/arch/browser/"
    click ReactCore "https://github.com/ml-in-barcelona/server-reason-react/blob/main/packages/react/src/React.ml"
    click ReactDOMServer "https://github.com/ml-in-barcelona/server-reason-react/blob/main/packages/reactDom/src/ReactServerDOM.ml"
    click ServerRuntime "https://github.com/ml-in-barcelona/server-reason-react/tree/main/arch/server/"
    click PPX "https://github.com/ml-in-barcelona/server-reason-react/tree/main/packages/server-reason-react-ppx/"
    click Belt "https://github.com/ml-in-barcelona/server-reason-react/blob/main/packages/Belt/src/Belt.re"
    click Promise "https://github.com/ml-in-barcelona/server-reason-react/tree/main/packages/promise/"
    click WebAPI "https://github.com/ml-in-barcelona/server-reason-react/blob/main/packages/webapi/src/Webapi.re"
    click Fetch "https://github.com/ml-in-barcelona/server-reason-react/blob/main/packages/fetch/Fetch.ml"
    click URL "https://github.com/ml-in-barcelona/server-reason-react/tree/main/packages/url/"
    click DOM "https://github.com/ml-in-barcelona/server-reason-react/blob/main/packages/melange.dom/Dom.ml"
    click UnivComp "https://github.com/ml-in-barcelona/server-reason-react/tree/main/demo/universal/"
    click ClientComp "https://github.com/ml-in-barcelona/server-reason-react/tree/main/demo/client/"
    click ServerComp "https://github.com/ml-in-barcelona/server-reason-react/tree/main/demo/server/"
    click BrowserPPX "https://github.com/ml-in-barcelona/server-reason-react/tree/main/packages/browser-ppx/"
    click Runtime "https://github.com/ml-in-barcelona/server-reason-react/blob/main/packages/runtime/Runtime.ml"

    %% Styles
    classDef browser fill:#2196F3,color:white
    classDef client fill:#42A5F5,color:white
    classDef server fill:#4CAF50,color:white
    classDef core fill:#9C27B0,color:white
    classDef lib fill:#7B1FA2,color:white
    classDef ppx fill:#FF9800,color:white
    classDef api fill:#03A9F4,color:white
    classDef universal fill:#673AB7,color:white
```
