# mohamedbrzan/video_chat_app architecture

> Architecture diagram of the GitHub repository mohamedbrzan/video_chat_app, 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/mohamedbrzan/video_chat_app
- Repository: https://github.com/mohamedbrzan/video_chat_app

## Overview

This is a Zoom-style video-conferencing app. A signed-in user can start or schedule a call, join via a link, configure devices, and enter a live meeting; they can also browse upcoming, past, and recorded calls or open a personal room. The graph distinguishes the meeting lifecycle, call discovery, and the live-call experience. README documents controls and capabilities beyond the sampled implementation; those are represented at the feature level. Evidence for unsampled UI and integrations is limited to the README and SOURCE INDEX references.

Main entry points: [`components/CallList.tsx`](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/CallList.tsx) (Call list), [`components/MeetingTypeList.tsx`](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingTypeList.tsx) (Meeting actions), [`app/(root)/meeting/[id]/page.tsx`](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/meeting/%5Bid%5D/page.tsx) (Meeting route), [`components/MeetingRoom.tsx`](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingRoom.tsx) (Live call controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and shell"]
  node_clerk["Clerk identity"]
  node_signin["Sign-in<br/>[page.tsx]"]
  node_signup["Sign-up<br/>[page.tsx]"]
end

subgraph group_meeting["Meeting lifecycle"]
  node_home["Home dashboard<br/>[page.tsx]"]
  node_meetingactions["Meeting actions"]
  node_meetingmodal["Meeting dialog<br/>[MeetingModal.tsx]"]
  node_personal["Personal room<br/>[page.tsx]"]
  node_streamclient["Stream client setup"]
  node_token["Stream token action<br/>[stream.actions.ts]"]
end

subgraph group_calls["Call discovery"]
  node_upcomingpage["Upcoming page<br/>[page.tsx]"]
  node_previouspage["Past calls page<br/>[page.tsx]"]
  node_recordingspage["Recordings page<br/>[page.tsx]"]
  node_calllist["Call list<br/>[CallList.tsx]"]
  node_callquery["Call query hook<br/>[useGetCalls.ts]"]
  node_meetingcard["Call summary card<br/>[MeetingCard.tsx]"]
end

subgraph group_live["Live meeting"]
  node_meetingroute["Meeting route<br/>[page.tsx]"]
  node_calllookup["Call lookup<br/>[useGetCallById.ts]"]
  node_setup["Device setup<br/>[MeetingSetup.tsx]"]
  node_room["Live call controls<br/>[MeetingRoom.tsx]"]
  node_endcall["End call<br/>[EndCallButton.tsx]"]
end

node_user(("User"))
node_stream[("Stream video service")]

node_user -->|"signs in"| node_signin
node_user -->|"creates account"| node_signup
node_signin -.->|"authenticates"| node_clerk
node_signup -.->|"authenticates"| node_clerk
node_user -->|"opens dashboard"| node_home
node_home -->|"renders"| node_meetingactions
node_meetingactions -->|"creates call"| node_stream
node_meetingactions -->|"opens dialog"| node_meetingmodal
node_meetingactions -->|"routes to call"| node_meetingroute
node_user -->|"opens room"| node_personal
node_personal -->|"loads room call"| node_calllookup
node_calllookup -->|"queries call"| node_stream
node_streamclient -->|"uses token provider"| node_token
node_streamclient -->|"initializes client"| node_stream
node_meetingroute -->|"loads call"| node_calllookup
node_meetingroute -->|"renders setup"| node_setup
node_meetingroute -->|"renders room"| node_room
node_room -->|"renders control"| node_endcall
node_user -->|"views schedule"| node_upcomingpage
node_user -->|"views past calls"| node_previouspage
node_user -->|"views recordings"| node_recordingspage
node_upcomingpage -->|"renders list"| node_calllist
node_previouspage -->|"renders list"| node_calllist
node_recordingspage -->|"renders list"| node_calllist
node_calllist -->|"loads calls"| node_callquery
node_callquery -->|"queries calls"| node_stream
node_calllist -->|"fetches recordings"| node_stream
node_calllist -->|"renders summaries"| node_meetingcard
node_room -.->|"controls live call"| node_stream

click node_signin "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx"
click node_signup "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(auth)/sign-up/%5B%5B...sign-up%5D%5D/page.tsx"
click node_home "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/page.tsx"
click node_meetingactions "https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingTypeList.tsx"
click node_meetingmodal "https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingModal.tsx"
click node_personal "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/personal-room/page.tsx"
click node_streamclient "https://github.com/mohamedbrzan/video_chat_app/blob/master/providers/StreamClientProvider.tsx"
click node_token "https://github.com/mohamedbrzan/video_chat_app/blob/master/actions/stream.actions.ts"
click node_meetingroute "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/meeting/%5Bid%5D/page.tsx"
click node_calllookup "https://github.com/mohamedbrzan/video_chat_app/blob/master/hooks/useGetCallById.ts"
click node_setup "https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingSetup.tsx"
click node_room "https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingRoom.tsx"
click node_endcall "https://github.com/mohamedbrzan/video_chat_app/blob/master/components/EndCallButton.tsx"
click node_upcomingpage "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/upcoming/page.tsx"
click node_previouspage "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/previous/page.tsx"
click node_recordingspage "https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/recordings/page.tsx"
click node_calllist "https://github.com/mohamedbrzan/video_chat_app/blob/master/components/CallList.tsx"
click node_callquery "https://github.com/mohamedbrzan/video_chat_app/blob/master/hooks/useGetCalls.ts"
click node_meetingcard "https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingCard.tsx"

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_clerk,node_signin,node_signup,node_user toneBlue
class node_home,node_meetingactions,node_meetingmodal,node_personal,node_streamclient,node_token,node_stream toneAmber
class node_upcomingpage,node_previouspage,node_recordingspage,node_calllist,node_callquery,node_meetingcard toneMint
class node_meetingroute,node_calllookup,node_setup,node_room,node_endcall toneRose
```

## Components

### Identity and shell

- **Clerk identity**
- [Sign-in](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx): `app/(auth)/sign-in/[[...sign-in]]/page.tsx`
- [Sign-up](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(auth)/sign-up/%5B%5B...sign-up%5D%5D/page.tsx): `app/(auth)/sign-up/[[...sign-up]]/page.tsx`

### Meeting lifecycle

- [Home dashboard](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/page.tsx): `app/(root)/(home)/page.tsx`
- [Meeting actions](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingTypeList.tsx): `components/MeetingTypeList.tsx`
- [Meeting dialog](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingModal.tsx): `components/MeetingModal.tsx`
- [Personal room](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/personal-room/page.tsx): `app/(root)/(home)/personal-room/page.tsx`
- [Stream client setup](https://github.com/mohamedbrzan/video_chat_app/blob/master/providers/StreamClientProvider.tsx): `providers/StreamClientProvider.tsx`
- [Stream token action](https://github.com/mohamedbrzan/video_chat_app/blob/master/actions/stream.actions.ts): `actions/stream.actions.ts`

### Call discovery

- [Upcoming page](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/upcoming/page.tsx): `app/(root)/(home)/upcoming/page.tsx`
- [Past calls page](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/previous/page.tsx): `app/(root)/(home)/previous/page.tsx`
- [Recordings page](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/(home)/recordings/page.tsx): `app/(root)/(home)/recordings/page.tsx`
- [Call list](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/CallList.tsx): `components/CallList.tsx`
- [Call query hook](https://github.com/mohamedbrzan/video_chat_app/blob/master/hooks/useGetCalls.ts): `hooks/useGetCalls.ts`
- [Call summary card](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingCard.tsx): `components/MeetingCard.tsx`

### Live meeting

- [Meeting route](https://github.com/mohamedbrzan/video_chat_app/blob/master/app/(root)/meeting/%5Bid%5D/page.tsx): `app/(root)/meeting/[id]/page.tsx`
- [Call lookup](https://github.com/mohamedbrzan/video_chat_app/blob/master/hooks/useGetCallById.ts): `hooks/useGetCallById.ts`
- [Device setup](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingSetup.tsx): `components/MeetingSetup.tsx`
- [Live call controls](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/MeetingRoom.tsx): `components/MeetingRoom.tsx`
- [End call](https://github.com/mohamedbrzan/video_chat_app/blob/master/components/EndCallButton.tsx): `components/EndCallButton.tsx`

### Other components

- **User**
- **Stream video service**

## Connections

- User → Sign-in: signs in
- User → Sign-up: creates account
- Sign-in → Clerk identity: authenticates
- Sign-up → Clerk identity: authenticates
- User → Home dashboard: opens dashboard
- Home dashboard → Meeting actions: renders (evidence: `app/(root)/(home)/page.tsx`)
- Meeting actions → Stream video service: creates call (evidence: `components/MeetingTypeList.tsx`)
- Meeting actions → Meeting dialog: opens dialog (evidence: `components/MeetingTypeList.tsx`)
- Meeting actions → Meeting route: routes to call (evidence: `components/MeetingTypeList.tsx`)
- User → Personal room: opens room
- Personal room → Call lookup: loads room call (evidence: `app/(root)/(home)/personal-room/page.tsx`)
- Call lookup → Stream video service: queries call (evidence: `hooks/useGetCallById.ts`)
- Stream client setup → Stream token action: uses token provider (evidence: `providers/StreamClientProvider.tsx`)
- Stream client setup → Stream video service: initializes client (evidence: `providers/StreamClientProvider.tsx`)
- Meeting route → Call lookup: loads call (evidence: `app/(root)/meeting/[id]/page.tsx`)
- Meeting route → Device setup: renders setup (evidence: `app/(root)/meeting/[id]/page.tsx`)
- Meeting route → Live call controls: renders room (evidence: `app/(root)/meeting/[id]/page.tsx`)
- Live call controls → End call: renders control (evidence: `components/MeetingRoom.tsx`)
- User → Upcoming page: views schedule
- User → Past calls page: views past calls
- User → Recordings page: views recordings
- Upcoming page → Call list: renders list (evidence: `app/(root)/(home)/upcoming/page.tsx`)
- Past calls page → Call list: renders list (evidence: `app/(root)/(home)/previous/page.tsx`)
- Recordings page → Call list: renders list (evidence: `app/(root)/(home)/recordings/page.tsx`)
- Call list → Call query hook: loads calls (evidence: `components/CallList.tsx`)
- Call query hook → Stream video service: queries calls (evidence: `hooks/useGetCalls.ts`)
- Call list → Stream video service: fetches recordings (evidence: `components/CallList.tsx`)
- Call list → Call summary card: renders summaries (evidence: `components/CallList.tsx`)
- Live call controls → Stream video service: controls live call
