# weewrr/litemeet architecture

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

- Interactive diagram: https://gitdiagram.com/weewrr/litemeet
- Repository: https://github.com/weewrr/litemeet

## Overview

LiteMeet is a local-first LAN meeting product. Participants create or join a room, use LiveKit for audio/video and screen sharing, and use backend WebSockets for meeting state and controls. Recordings and meeting artifacts can be managed afterward, with transcription and AI minutes as follow-on capabilities. The backend also serves sharing, configuration, and record APIs; a local server manager coordinates the supporting services. Some frontend and service relationships are documented in the README rather than shown in sampled implementation excerpts.

Main entry points: [`backend/src/main/java/com/litemeet/backend/api/RecordController.java`](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/api/RecordController.java) (Record API), [`frontend/src/App.vue`](https://github.com/weewrr/litemeet/blob/main/frontend/src/App.vue) (Home and join), [`frontend/src/pages/room/Room.vue`](https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/room/Room.vue) (Room interface), [`frontend/src/pages/room/roomMedia.js`](https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/room/roomMedia.js) (Room media)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_meeting_ui["Meeting experience"]
  node_home["Home and join<br/>[App.vue]"]
  node_room_page["Room interface<br/>[Room.vue]"]
  node_room_media["Room media<br/>[roomMedia.js]"]
  node_settings["AI settings<br/>[Settings.vue]"]
end

subgraph group_backend["Backend services"]
  node_signaling["Meeting signaling"]
  node_livekit_api["LiveKit access API"]
  node_livekit_token["Token issuer"]
  node_ws_proxy["LiveKit WSS proxy"]
  node_sharing["LAN meeting sharing"]
  node_meeting_state[("Room state stores<br/>[MeetingStore.java]")]
  node_ended_cache[("Ended-room cache")]
end

subgraph group_artifacts["Meeting artifacts"]
  node_records_api["Record API"]
  node_record_store[("Record storage")]
  node_record_list["Recording library<br/>[Records.vue]"]
  node_record_detail["Record detail<br/>[Record.vue]"]
  node_ai_client["Transcription and minutes<br/>[AiClient.java]"]
end

subgraph group_local_services["Local services"]
  node_livekit["LiveKit SFU<br/>[livekit.yaml]"]
  node_transcriber["Transcription gateway<br/>[server.py]"]
  node_mysql_redis[("MySQL and Redis")]
end

subgraph group_management["Service management"]
  node_server_manager["Server manager UI<br/>[ui.py]"]
  node_env_manager["Environment manager<br/>[env_manager.py]"]
  node_service_processes["Local service processes<br/>[servers.py]"]
end

node_participant(("Participant"))

node_participant -->|"creates or joins"| node_home
node_home -->|"opens room"| node_room_page
node_room_page -->|"uses media"| node_room_media
node_room_page -->|"sends room events"| node_signaling
node_room_media -.->|"requests access"| node_livekit_api
node_livekit_api -->|"issues token"| node_livekit_token
node_room_media -->|"publishes media"| node_livekit
node_ws_proxy -->|"proxies WSS"| node_livekit
node_participant -->|"requests invite links"| node_sharing
node_home -->|"opens recordings"| node_record_list
node_record_list -->|"loads recordings"| node_records_api
node_record_detail -->|"manages artifacts"| node_records_api
node_records_api -->|"reads and writes"| node_record_store
node_record_store -->|"persists records"| node_mysql_redis
node_records_api -->|"requests transcription or minutes"| node_ai_client
node_ai_client -->|"sends transcription request"| node_transcriber
node_settings -->|"stores AI config locally"| node_participant
node_signaling -->|"updates room state"| node_meeting_state
node_signaling -->|"uses room cache"| node_ended_cache
node_server_manager -->|"manages environments"| node_env_manager
node_server_manager -->|"controls services"| node_service_processes
node_service_processes -->|"starts service"| node_transcriber

click node_home "https://github.com/weewrr/litemeet/blob/main/frontend/src/App.vue"
click node_room_page "https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/room/Room.vue"
click node_room_media "https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/room/roomMedia.js"
click node_settings "https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/settings/Settings.vue"
click node_signaling "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/signaling/SignalWebSocketHandler.java"
click node_livekit_api "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/livekit/LiveKitController.java"
click node_livekit_token "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/livekit/LiveKitTokenService.java"
click node_ws_proxy "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/livekit/LiveKitWsProxyHandler.java"
click node_sharing "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/api/ShareController.java"
click node_records_api "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/api/RecordController.java"
click node_record_store "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/store/JdbcRecordStore.java"
click node_record_list "https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/records/Records.vue"
click node_record_detail "https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/record/Record.vue"
click node_ai_client "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/ai/AiClient.java"
click node_livekit "https://github.com/weewrr/litemeet/blob/main/livekit/livekit.yaml"
click node_transcriber "https://github.com/weewrr/litemeet/blob/main/transcribe-server/server.py"
click node_meeting_state "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/store/MeetingStore.java"
click node_ended_cache "https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/store/EndedRoomCache.java"
click node_server_manager "https://github.com/weewrr/litemeet/blob/main/server-manager/ui.py"
click node_env_manager "https://github.com/weewrr/litemeet/blob/main/server-manager/env_manager.py"
click node_service_processes "https://github.com/weewrr/litemeet/blob/main/server-manager/servers.py"

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_home,node_room_page,node_room_media,node_settings toneBlue
class node_signaling,node_livekit_api,node_livekit_token,node_ws_proxy,node_sharing,node_meeting_state,node_ended_cache toneAmber
class node_records_api,node_record_store,node_record_list,node_record_detail,node_ai_client toneMint
class node_livekit,node_transcriber,node_mysql_redis toneRose
class node_server_manager,node_env_manager,node_service_processes,node_participant toneIndigo
```

## Components

### Meeting experience

- [Home and join](https://github.com/weewrr/litemeet/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Room interface](https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/room/Room.vue): `frontend/src/pages/room/Room.vue`
- [Room media](https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/room/roomMedia.js): `frontend/src/pages/room/roomMedia.js`
- [AI settings](https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/settings/Settings.vue): `frontend/src/pages/settings/Settings.vue`

### Backend services

- [Meeting signaling](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/signaling/SignalWebSocketHandler.java): `backend/src/main/java/com/litemeet/backend/signaling/SignalWebSocketHandler.java`
- [LiveKit access API](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/livekit/LiveKitController.java): `backend/src/main/java/com/litemeet/backend/livekit/LiveKitController.java`
- [Token issuer](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/livekit/LiveKitTokenService.java): `backend/src/main/java/com/litemeet/backend/livekit/LiveKitTokenService.java`
- [LiveKit WSS proxy](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/livekit/LiveKitWsProxyHandler.java): `backend/src/main/java/com/litemeet/backend/livekit/LiveKitWsProxyHandler.java`
- [LAN meeting sharing](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/api/ShareController.java): `backend/src/main/java/com/litemeet/backend/api/ShareController.java`
- [Room state stores](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/store/MeetingStore.java): `backend/src/main/java/com/litemeet/backend/store/MeetingStore.java`
- [Ended-room cache](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/store/EndedRoomCache.java): `backend/src/main/java/com/litemeet/backend/store/EndedRoomCache.java`

### Meeting artifacts

- [Record API](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/api/RecordController.java): `backend/src/main/java/com/litemeet/backend/api/RecordController.java`
- [Record storage](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/store/JdbcRecordStore.java): `backend/src/main/java/com/litemeet/backend/store/JdbcRecordStore.java`
- [Recording library](https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/records/Records.vue): `frontend/src/pages/records/Records.vue`
- [Record detail](https://github.com/weewrr/litemeet/blob/main/frontend/src/pages/record/Record.vue): `frontend/src/pages/record/Record.vue`
- [Transcription and minutes](https://github.com/weewrr/litemeet/blob/main/backend/src/main/java/com/litemeet/backend/ai/AiClient.java): `backend/src/main/java/com/litemeet/backend/ai/AiClient.java`

### Local services

- [LiveKit SFU](https://github.com/weewrr/litemeet/blob/main/livekit/livekit.yaml): `livekit/livekit.yaml`
- [Transcription gateway](https://github.com/weewrr/litemeet/blob/main/transcribe-server/server.py): `transcribe-server/server.py`
- **MySQL and Redis**

### Service management

- [Server manager UI](https://github.com/weewrr/litemeet/blob/main/server-manager/ui.py): `server-manager/ui.py`
- [Environment manager](https://github.com/weewrr/litemeet/blob/main/server-manager/env_manager.py): `server-manager/env_manager.py`
- [Local service processes](https://github.com/weewrr/litemeet/blob/main/server-manager/servers.py): `server-manager/servers.py`

### Other components

- **Participant**

## Connections

- Participant → Home and join: creates or joins (evidence: `README.md`)
- Home and join → Room interface: opens room (evidence: `README.md`)
- Room interface → Room media: uses media (evidence: `frontend/src/pages/room/Room.vue`)
- Room interface → Meeting signaling: sends room events (evidence: `README.md`)
- Room media → LiveKit access API: requests access
- LiveKit access API → Token issuer: issues token (evidence: `backend/src/main/java/com/litemeet/backend/livekit/LiveKitController.java`)
- Room media → LiveKit SFU: publishes media (evidence: `README.md`)
- LiveKit WSS proxy → LiveKit SFU: proxies WSS (evidence: `README.md`)
- Participant → LAN meeting sharing: requests invite links (evidence: `README.md`)
- Home and join → Recording library: opens recordings (evidence: `README.md`)
- Recording library → Record API: loads recordings (evidence: `README.md`)
- Record detail → Record API: manages artifacts (evidence: `README.md`)
- Record API → Record storage: reads and writes (evidence: `backend/src/main/java/com/litemeet/backend/api/RecordController.java`)
- Record storage → MySQL and Redis: persists records (evidence: `README.md`)
- Record API → Transcription and minutes: requests transcription or minutes (evidence: `backend/src/main/java/com/litemeet/backend/api/RecordController.java`)
- Transcription and minutes → Transcription gateway: sends transcription request (evidence: `README.md`)
- AI settings → Participant: stores AI config locally (evidence: `README.md`)
- Meeting signaling → Room state stores: updates room state (evidence: `backend/src/main/java/com/litemeet/backend/signaling/SignalWebSocketHandler.java`)
- Meeting signaling → Ended-room cache: uses room cache (evidence: `backend/src/main/java/com/litemeet/backend/signaling/SignalWebSocketHandler.java`)
- Server manager UI → Environment manager: manages environments (evidence: `server-manager/ui.py`)
- Server manager UI → Local service processes: controls services (evidence: `server-manager/ui.py`)
- Local service processes → Transcription gateway: starts service (evidence: `server-manager/servers.py`)
