# zegocloud/zego_uikit_prebuilt_web architecture

> Architecture diagram of the GitHub repository zegocloud/zego_uikit_prebuilt_web, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zegocloud/zego_uikit_prebuilt_web
- Repository: https://github.com/zegocloud/zego_uikit_prebuilt_web

## Overview

This repository implements the ZEGOCLOUD Prebuilt Web SDK: a React/TypeScript UI kit for 1:1 calls, group calls, live streaming, and video conferences. The principal workflow configures a kit instance, initializes its RTC/signaling core, selects browser or room UI, and lets participants communicate and manage media. Separate modules handle user/stream state, invitations, messaging, settings, and telemetry. The README documents the product capabilities; sampled source and the SOURCE INDEX support the shown internal links. Several desktop-room and browser-check details are unsampled, so their links are documented or omitted rather than inferred.

Main entry points: [`src/sdk/modules/index.ts`](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/index.ts) (RTC core), [`src/sdk/view/index.tsx`](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/index.tsx) (View selection), [`src/sdk/index.tsx`](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/index.tsx) (Prebuilt API), [`src/sdk/view/pages/ZegoRoomMobile/index.tsx`](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/pages/ZegoRoomMobile/index.tsx) (Mobile room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Demo and SDK entry"]
  node_demo["Demo configuration<br/>[App.tsx]"]
  node_kit["Prebuilt API<br/>[index.tsx]"]
  node_product_modes["Call and live modes<br/>[README.md]"]
end

subgraph group_runtime["RTC and signaling"]
  node_sdk_core["RTC core<br/>[index.ts]"]
  node_express["Express WebRTC"]
  node_zim_manager["Signaling manager<br/>[ZimManager.ts]"]
  node_zim_service["ZIM signaling"]
  node_invite_manager["In-room invitations"]
  node_superboard["SuperBoard"]
end

subgraph group_experience["Participant experience"]
  node_view_router["View selection<br/>[index.tsx]"]
  node_browser_check["Browser checks<br/>[index.tsx]"]
  node_desktop_room["Desktop room"]
  node_mobile_room["Mobile room<br/>[index.tsx]"]
  node_room_components["Mobile room controls"]
  node_call_ui["Call invitation UI"]
  node_settings["Device settings<br/>[index.tsx]"]
  node_media_ui["Media controls"]
end

subgraph group_support["State and diagnostics"]
  node_sdk_model["Types and config<br/>[index.ts]"]
  node_user_manager["User and streams<br/>[UserListManager.ts]"]
  node_telemetry["Tracing and logs<br/>[ZegoTracer.ts]"]
  node_logger["SDK logger<br/>[ZegoLogger.ts]"]
  node_tracer_schema["Trace events<br/>[tracer.ts]"]
end

node_participant(("SDK integrator"))

node_participant -->|"configures"| node_demo
node_demo -->|"creates"| node_kit
node_kit -->|"initializes"| node_sdk_core
node_kit -->|"renders"| node_view_router
node_kit -->|"uses types"| node_sdk_model
node_sdk_core -->|"uses types"| node_sdk_model
node_sdk_core -->|"calls"| node_express
node_sdk_core -->|"delegates"| node_zim_manager
node_zim_manager -->|"calls"| node_zim_service
node_zim_manager -->|"uses"| node_invite_manager
node_sdk_core -->|"uses"| node_user_manager
node_view_router -->|"selects"| node_browser_check
node_view_router -->|"selects"| node_desktop_room
node_view_router -->|"selects"| node_mobile_room
node_view_router -->|"passes core"| node_sdk_core
node_mobile_room -->|"renders"| node_room_components
node_mobile_room -->|"uses"| node_user_manager
node_mobile_room -.->|"uses"| node_invite_manager
node_view_router -->|"selects"| node_call_ui
node_settings -->|"reads state"| node_user_manager
node_media_ui -->|"reads state"| node_user_manager
node_sdk_core -->|"reports events"| node_telemetry
node_logger -->|"creates spans"| node_telemetry
node_logger -->|"uses events"| node_tracer_schema
node_sdk_core -.->|"integrates"| node_superboard
node_product_modes -->|"documents modes"| node_demo

click node_demo "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/App.tsx"
click node_kit "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/index.tsx"
click node_product_modes "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/README.md"
click node_sdk_model "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/model/index.ts"
click node_sdk_core "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/index.ts"
click node_zim_manager "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/ZimManager.ts"
click node_invite_manager "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/InRoomInviteManager.ts"
click node_user_manager "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/UserListManager.ts"
click node_view_router "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/index.tsx"
click node_browser_check "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/pages/ZegoBrowserCheck/index.tsx"
click node_desktop_room "https://github.com/zegocloud/zego_uikit_prebuilt_web/tree/master/src/sdk/view/pages/ZegoRoom"
click node_mobile_room "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/pages/ZegoRoomMobile/index.tsx"
click node_room_components "https://github.com/zegocloud/zego_uikit_prebuilt_web/tree/master/src/sdk/view/pages/ZegoRoomMobile/components"
click node_call_ui "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/pages/ZegoCallInvitation/callInvitationControl.tsx"
click node_settings "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/components/zegoSetting/index.tsx"
click node_media_ui "https://github.com/zegocloud/zego_uikit_prebuilt_web/tree/master/src/sdk/view/components/zegoMedia"
click node_telemetry "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/ZegoTracer.ts"
click node_logger "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/ZegoLogger.ts"
click node_tracer_schema "https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/model/tracer.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_demo,node_kit,node_product_modes toneBlue
class node_sdk_core,node_express,node_zim_manager,node_zim_service,node_invite_manager,node_superboard toneAmber
class node_view_router,node_browser_check,node_desktop_room,node_mobile_room,node_room_components,node_call_ui,node_settings,node_media_ui toneMint
class node_sdk_model,node_user_manager,node_telemetry,node_logger,node_tracer_schema toneRose
class node_participant toneIndigo
```

## Components

### Demo and SDK entry

- [Demo configuration](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/App.tsx): `src/App.tsx`
- [Prebuilt API](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/index.tsx): `src/sdk/index.tsx`
- [Call and live modes](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/README.md): `README.md`

### RTC and signaling

- [RTC core](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/index.ts): `src/sdk/modules/index.ts`
- **Express WebRTC**
- [Signaling manager](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/ZimManager.ts): `src/sdk/modules/tools/ZimManager.ts`
- **ZIM signaling**
- [In-room invitations](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/InRoomInviteManager.ts): `src/sdk/modules/tools/InRoomInviteManager.ts`
- **SuperBoard**

### Participant experience

- [View selection](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/index.tsx): `src/sdk/view/index.tsx`
- [Browser checks](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/pages/ZegoBrowserCheck/index.tsx): `src/sdk/view/pages/ZegoBrowserCheck/index.tsx`
- [Desktop room](https://github.com/zegocloud/zego_uikit_prebuilt_web/tree/master/src/sdk/view/pages/ZegoRoom): `src/sdk/view/pages/ZegoRoom`
- [Mobile room](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/pages/ZegoRoomMobile/index.tsx): `src/sdk/view/pages/ZegoRoomMobile/index.tsx`
- [Mobile room controls](https://github.com/zegocloud/zego_uikit_prebuilt_web/tree/master/src/sdk/view/pages/ZegoRoomMobile/components): `src/sdk/view/pages/ZegoRoomMobile/components`
- [Call invitation UI](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/pages/ZegoCallInvitation/callInvitationControl.tsx): `src/sdk/view/pages/ZegoCallInvitation/callInvitationControl.tsx`
- [Device settings](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/view/components/zegoSetting/index.tsx): `src/sdk/view/components/zegoSetting/index.tsx`
- [Media controls](https://github.com/zegocloud/zego_uikit_prebuilt_web/tree/master/src/sdk/view/components/zegoMedia): `src/sdk/view/components/zegoMedia`

### State and diagnostics

- [Types and config](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/model/index.ts): `src/sdk/model/index.ts`
- [User and streams](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/UserListManager.ts): `src/sdk/modules/tools/UserListManager.ts`
- [Tracing and logs](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/ZegoTracer.ts): `src/sdk/modules/tools/ZegoTracer.ts`
- [SDK logger](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/modules/tools/ZegoLogger.ts): `src/sdk/modules/tools/ZegoLogger.ts`
- [Trace events](https://github.com/zegocloud/zego_uikit_prebuilt_web/blob/master/src/sdk/model/tracer.ts): `src/sdk/model/tracer.ts`

### Other components

- **SDK integrator**

## Connections

- SDK integrator → Demo configuration: configures (evidence: `README.md`)
- Demo configuration → Prebuilt API: creates (evidence: `src/App.tsx`)
- Prebuilt API → RTC core: initializes (evidence: `src/sdk/index.tsx`)
- Prebuilt API → View selection: renders (evidence: `src/sdk/index.tsx`)
- Prebuilt API → Types and config: uses types (evidence: `src/sdk/index.tsx`)
- RTC core → Types and config: uses types (evidence: `src/sdk/modules/index.ts`)
- RTC core → Express WebRTC: calls (evidence: `src/sdk/modules/index.ts`)
- RTC core → Signaling manager: delegates (evidence: `src/sdk/modules/index.ts`)
- Signaling manager → ZIM signaling: calls (evidence: `src/sdk/modules/tools/ZimManager.ts`)
- Signaling manager → In-room invitations: uses (evidence: `src/sdk/modules/tools/ZimManager.ts`)
- RTC core → User and streams: uses (evidence: `src/sdk/modules/index.ts`)
- View selection → Browser checks: selects (evidence: `src/sdk/view/index.tsx`)
- View selection → Desktop room: selects (evidence: `src/sdk/view/index.tsx`)
- View selection → Mobile room: selects (evidence: `src/sdk/view/index.tsx`)
- View selection → RTC core: passes core (evidence: `src/sdk/view/index.tsx`)
- Mobile room → Mobile room controls: renders (evidence: `src/sdk/view/pages/ZegoRoomMobile/index.tsx`)
- Mobile room → User and streams: uses (evidence: `src/sdk/view/pages/ZegoRoomMobile/index.tsx`)
- Mobile room → In-room invitations: uses
- View selection → Call invitation UI: selects (evidence: `src/sdk/view/index.tsx`)
- Device settings → User and streams: reads state (evidence: `src/sdk/view/components/zegoSetting/index.tsx`)
- Media controls → User and streams: reads state (evidence: `src/sdk/view/components/zegoMedia/audio.tsx`)
- RTC core → Tracing and logs: reports events (evidence: `src/sdk/modules/index.ts`)
- SDK logger → Tracing and logs: creates spans (evidence: `src/sdk/modules/tools/ZegoLogger.ts`)
- SDK logger → Trace events: uses events (evidence: `src/sdk/modules/tools/ZegoLogger.ts`)
- RTC core → SuperBoard: integrates
- Call and live modes → Demo configuration: documents modes (evidence: `README.md`)
