# dxx/react-bilibili architecture

> Architecture diagram of the GitHub repository dxx/react-bilibili, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dxx/react-bilibili
- Repository: https://github.com/dxx/react-bilibili

## Overview

##### Project type and purpose
- This is a full-stack, server-side-rendered (SSR) React application that mimics the Bilibili mobile web interface.
- It consists of two Node.js/Express services:
a) bilibili-api – a custom API layer (REST + WebSocket) proxying data from official Bilibili endpoints.
b) react-bilibili SSR server – an Express server that builds and serves React pages (initial HTML + JS bundles) and proxies API calls.
- The frontend uses React (with hooks), React Router, Redux (+ thunk), React-Helmet, react-lazyload, loadable-components, cross-fetch.

##### File structure
Top-level:
- bilibili-api/ – standalone API service
- config/, plugin/, server/ – Webpack configs, custom plugins, and SSR server boot code
- public/, templates/ – static assets and HTML templates
- src/ – React application source (components, containers, Redux, router, entry points)
Key patterns:
- SSR container pattern (entry-server.tsx + renderer.js)
- Client-side hydration (entry-client.tsx)
- Code splitting via loadable-components
- Proxy middleware (server/dev-server.js) forwarding `/api` to bilibili-api
- WebSocket support in both bilibili-api (src/routers/live) and React client (ChatWS.ts)

##### README insights
- Confirms SSR template base, React-Router v4, Redux v4, loadable-components for lazy-loading, Express for backend.
- Explains that you must start bilibili-api on port 3010 and then SSR server.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client
    Browser["Browser (User Agent)"]:::client

    %% SSR Server Components
    subgraph "SSR Server"
        SSR_Main["Main Server Boot"]:::service
        Dev_Server["Dev Server & Proxy"]:::service
        Renderer["Renderer (SSR container)"]:::service
        Templates["HTML Templates"]:::asset
    end

    %% API Server Components
    subgraph "API Server"
        API_Main["Entry Point"]:::service
        Routers["Routers"]:::service
        Middleware["Middleware"]:::service
        WS_Docs["WebSocket Docs"]:::service
    end

    %% External Services
    OFF["Bilibili Official Backend"]:::external
    CDN["Static Assets / CDN"]:::asset

    %% Data Flows
    Browser -->|"HTTP GET /, /video/... (SSR Request)"| SSR_Main
    SSR_Main -->|"REST API Calls"| API_Main
    API_Main -->|"REST/WebSocket"| OFF
    SSR_Main -->|"return HTML + <script> bundles"| Browser
    Browser -->|"AJAX/fetch (redux-thunk)"| API_Main
    Browser -->|"WebSocket connect (chat/danmaku)"| API_Main
    SSR_Main -->|"serve assets"| CDN
    Templates -->|"HTML templates"| SSR_Main

    %% Click Events
    click API_Main "https://github.com/dxx/react-bilibili/blob/master/bilibili-api/src/index.js"
    click Routers "https://github.com/dxx/react-bilibili/tree/master/bilibili-api/src/routers/"
    click Middleware "https://github.com/dxx/react-bilibili/tree/master/bilibili-api/src/middleware/"
    click WS_Docs "https://github.com/dxx/react-bilibili/blob/master/bilibili-api/WebSocket.md"
    click SSR_Main "https://github.com/dxx/react-bilibili/blob/master/server/index.js"
    click Dev_Server "https://github.com/dxx/react-bilibili/blob/master/server/dev-server.js"
    click Renderer "https://github.com/dxx/react-bilibili/blob/master/server/renderer.js"
    click Templates "https://github.com/dxx/react-bilibili/blob/master/templates/index.html"

    %% Styling
    classDef client fill:#FFF2CC,stroke:#D6A800,color:#333;
    classDef service fill:#D6EFFF,stroke:#0066CC,color:#003366;
    classDef external fill:#E5FFEA,stroke:#33AA33,color:#004D00;
    classDef asset fill:#FFE5E5,stroke:#CC0000,color:#660000;
```
