# bezelhost/jisti-meet architecture

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

- Interactive diagram: https://gitdiagram.com/bezelhost/jisti-meet
- Repository: https://github.com/bezelhost/jisti-meet

## Overview

##### Project type and purpose
- This is a full-stack, open-source video-conferencing suite (“Jitsi Meet”) comprising:
- A web client (vanilla JS + React + Redux + CSS/HTML)
- A React Native–based mobile client (Android & iOS)
- Native SDK modules for embedding in external apps
- Server-side components (Prosody XMPP, Prosody plugins, TURN/STUN, Debian packages)
- Purpose: Secure, scalable multiparty WebRTC conferences using Jitsi Videobridge (media router) and Prosody (signaling).

##### File structure
- Top-level directories:
- android/, ios/ → Native mobile app code, Gradle/Xcode projects, React Native bridges, SDK modules
- react/ & modules/ → Client logic organized by features (Redux, middleware, React components), cross-platform code (.native.js vs .web.js)
- resources/prosody-plugins/ → XMPP extensions for conference logic, token auth, speaker stats, etc.
- debian/ → Packaging scripts for Prosody modules, TURN server, web config
- static/, config.js, interface_config.js → Static landing pages, client configuration
- doc/ → Deployment & architecture guidance
- Makefile, webpack.config.js, metro.config.js → Build toolchains for web and mobile bundling
- Architecture choices:
- Modular feature-based code (React/Redux)
- Cross-platform code sharing
- Separation of signaling (XMPP) vs media (SRTP via JVB)

##### Extract architecture insights from README
- Signaling via Prosody XMPP → Jicofo (conference focus) → JVB (media routing)
- Clients run in browser or inside native shells; no additional installs
- Supports external embedding (External API JS)
- Optional services: Etherpad (shared doc), analytics (GA, Amplitude), Dropbox, Google auth

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients Layer
    subgraph "Clients" 
        subgraph "Web Client" 
            UI1["UI Components"]:::client
            UI2["Feature Modules"]:::client
            Conn["Transport Layer<br/>(app.js, connection.js)"]:::client
            Redux["Redux Store<br/>(conference.js)"]:::client
            Static["Static Assets<br/>(static/, index.html, css/)"]:::client
        end
        subgraph "Mobile Client"
            RNApp["React Native App"]:::client
            Bridge["Native Bridge Modules"]:::client
        end
        subgraph "External SDKs"
            SDKA["Android SDK"]:::client
            SDKI["iOS SDK"]:::client
        end
    end

    %% Signaling Plane
    subgraph "Signaling Plane"
        Prosody["Prosody XMPP Server"]:::signaling
        Plugins["Prosody Plugins"]:::signaling
        Jicofo["Jicofo Focus"]:::signaling
    end

    %% Media Plane
    subgraph "Media Plane"
        JVB["Jitsi Videobridge Cluster"]:::media
        STUN["STUN/TURN Service"]:::media
    end

    %% External Services
    subgraph "External Services"
        Etherpad["Etherpad"]:::external
        Analytics["Analytics Services"]:::external
        JWT["JWT Auth Service"]:::external
        Storage["Dropbox/Google APIs"]:::external
        Jibri["Jibri Recording"]:::external
    end

    %% Config & Build
    subgraph "Config & Build"
        Config["Client Config Files"]:::server
        Build["Build Toolchains & Scripts"]:::server
        Doc["Docs & Guides"]:::server
    end

    %% Connections
    UI1 -->|uses| UI2
    UI2 -->|uses| Conn
    Conn -->|"XMPP/BOSH"| Prosody
    Redux -->|manages state| UI1
    Static -->|served to| UI1
    RNApp -.->|bridge calls| Bridge
    RNApp -->|"XMPP/BOSH"| Prosody
    SDKA -->|"XMPP/BOSH"| Prosody
    SDKI -->|"XMPP/BOSH"| Prosody

    Prosody -->|controls| Jicofo
    Jicofo -->|allocates channels| JVB
    UI1 -->|WebRTC/SRTP| JVB
    RNApp -->|WebRTC/SRTP| JVB
    SDKA -->|WebRTC/SRTP| JVB
    SDKI -->|WebRTC/SRTP| JVB

    UI1 -->|STUN/TURN| STUN
    RNApp -->|STUN/TURN| STUN
    SDKA -->|STUN/TURN| STUN
    SDKI -->|STUN/TURN| STUN

    UI1 -->|HTTP| Etherpad
    UI1 -->|HTTP| Analytics
    UI1 -->|HTTP| JWT
    UI1 -->|HTTP| Storage

    RNApp -->|HTTP| Analytics
    RNApp -->|HTTP| JWT
    RNApp -->|HTTP| Storage

    Prosody -->|XMPP| Jibri

    UI1 -->|loads| Config
    RNApp -->|loads| Config
    UI1 -->|built by| Build
    RNApp -->|built by| Build
    Build -->|references| Doc

    %% Click Events
    click UI1 "https://github.com/bezelhost/jisti-meet/tree/master/react/"
    click UI2 "https://github.com/bezelhost/jisti-meet/tree/master/modules/"
    click Conn "https://github.com/bezelhost/jisti-meet/blob/master/app.js"
    click Redux "https://github.com/bezelhost/jisti-meet/blob/master/conference.js"
    click Static "https://github.com/bezelhost/jisti-meet/tree/master/static/"
    click Plugins "https://github.com/bezelhost/jisti-meet/tree/master/resources/prosody-plugins/"
    click Build "https://github.com/bezelhost/jisti-meet/tree/master/Makefile"
    click Build "https://github.com/bezelhost/jisti-meet/blob/master/webpack.config.js"
    click Build "https://github.com/bezelhost/jisti-meet/blob/master/metro.config.js"
    click STUN "https://github.com/bezelhost/jisti-meet/blob/master/debian/jitsi-meet-turnserver.*"
    click Config "https://github.com/bezelhost/jisti-meet/blob/master/config.js"
    click Config "https://github.com/bezelhost/jisti-meet/blob/master/interface_config.js"
    click Doc "https://github.com/bezelhost/jisti-meet/tree/master/doc/"
    click Doc "https://github.com/bezelhost/jisti-meet/blob/master/README.md"
    click Doc "https://github.com/bezelhost/jisti-meet/blob/master/CONTRIBUTING.md"

    %% Styles
    classDef client fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef signaling fill:#D4F1BE,stroke:#22863A,color:#22863A
    classDef media fill:#FFE3B3,stroke:#e36209,color:#e36209
    classDef external fill:#E9D5FF,stroke:#6f42c1,color:#6f42c1
    classDef server fill:#F0F0F0,stroke:#586069,color:#586069
```
