# samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app architecture

> Architecture diagram of the GitHub repository samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app
- Repository: https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app

## Overview

Streamify is a language-learning social app for finding friends and communicating through chat and video calls. The main user journey is signup/login, onboarding with language and profile details, then discovering friends, managing requests, and opening chats or calls. The frontend routes users and sends API requests; the backend authenticates requests and handles account, friend, and Stream-token operations. Chat and call pages are present, but their runtime details are not sampled, so those connections are shown only where documented by routing or API code.

Main entry points: [`frontend/src/App.jsx`](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/App.jsx) (App routing), [`frontend/src/lib/api.js`](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/lib/api.js) (API client), [`backend/src/server.js`](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/server.js) (HTTP server), [`backend/src/controllers/auth.controller.js`](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/controllers/auth.controller.js) (Account operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Frontend experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_authview["Auth and onboarding<br/>[LoginPage.jsx]"]
  node_home["Discovery home<br/>[HomePage.jsx]"]
  node_friends["Friends view<br/>[App.jsx]"]
  node_notifications["Friend requests"]
  node_chatview["Chat view<br/>[ChatPage.jsx]"]
  node_callview["Call view<br/>[CallPage.jsx]"]
  node_authstate["Auth state<br/>[useAuthUser.js]"]
  node_client["API client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[auth.route.js]"]
  node_userroutes["User routes<br/>[user.route.js]"]
  node_chatroutes["Chat routes<br/>[chat.route.js]"]
end

subgraph group_domain["User and friendship domain"]
  node_authlogic["Account operations<br/>[auth.controller.js]"]
  node_userlogic["Friend operations<br/>[user.controller.js]"]
  node_userstore[("User records<br/>[User.js]")]
  node_requests[("Friend requests<br/>[FriendRequest.js]")]
end

subgraph group_realtime["Realtime integration"]
  node_chatlogic["Stream token<br/>[chat.controller.js]"]
  node_stream["Stream integration<br/>[stream.js]"]
end

node_person(("User"))

node_person -->|"uses"| node_app
node_app -->|"routes to"| node_authview
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_friends
node_app -->|"routes to"| node_notifications
node_app -->|"routes to"| node_chatview
node_app -->|"routes to"| node_callview
node_app -->|"checks auth"| node_authstate
node_authstate -->|"loads user"| node_client
node_authview -->|"submits auth"| node_client
node_home -->|"loads discovery"| node_client
node_notifications -->|"manages requests"| node_client
node_chatview -->|"requests data"| node_client
node_callview -->|"requests token"| node_client
node_client -.->|"HTTP requests"| node_server
node_server -->|"mounts at auth"| node_authroutes
node_server -->|"mounts at users"| node_userroutes
node_server -->|"mounts at chat"| node_chatroutes
node_authroutes -->|"dispatches to"| node_authlogic
node_userroutes -->|"dispatches to"| node_userlogic
node_chatroutes -->|"dispatches to"| node_chatlogic
node_authlogic -->|"reads and writes"| node_userstore
node_authlogic -->|"upserts identity"| node_stream
node_userlogic -->|"queries users"| node_userstore
node_userlogic -->|"manages requests"| node_requests
node_chatlogic -->|"generates token"| node_stream

click node_app "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/App.jsx"
click node_authview "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/LoginPage.jsx"
click node_home "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/HomePage.jsx"
click node_friends "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/App.jsx"
click node_notifications "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/NotificationsPage.jsx"
click node_chatview "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/ChatPage.jsx"
click node_callview "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/CallPage.jsx"
click node_authstate "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/hooks/useAuthUser.js"
click node_client "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/lib/api.js"
click node_server "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/server.js"
click node_authroutes "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/routes/auth.route.js"
click node_userroutes "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/routes/user.route.js"
click node_chatroutes "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/routes/chat.route.js"
click node_authlogic "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/controllers/auth.controller.js"
click node_userlogic "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/controllers/user.controller.js"
click node_userstore "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/models/User.js"
click node_requests "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/models/FriendRequest.js"
click node_chatlogic "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/controllers/chat.controller.js"
click node_stream "https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/lib/stream.js"

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_app,node_authview,node_home,node_friends,node_notifications,node_chatview,node_callview,node_authstate,node_client,node_person toneBlue
class node_server,node_authroutes,node_userroutes,node_chatroutes toneAmber
class node_authlogic,node_userlogic,node_userstore,node_requests toneMint
class node_chatlogic,node_stream toneRose
```

## Components

### Frontend experience

- [App routing](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth and onboarding](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [Discovery home](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [Friends view](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Friend requests](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/NotificationsPage.jsx): `frontend/src/pages/NotificationsPage.jsx`
- [Chat view](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/ChatPage.jsx): `frontend/src/pages/ChatPage.jsx`
- [Call view](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/pages/CallPage.jsx): `frontend/src/pages/CallPage.jsx`
- [Auth state](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/hooks/useAuthUser.js): `frontend/src/hooks/useAuthUser.js`
- [API client](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`

### Backend API

- [HTTP server](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/server.js): `backend/src/server.js`
- [Auth routes](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/routes/auth.route.js): `backend/src/routes/auth.route.js`
- [User routes](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/routes/user.route.js): `backend/src/routes/user.route.js`
- [Chat routes](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/routes/chat.route.js): `backend/src/routes/chat.route.js`

### User and friendship domain

- [Account operations](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Friend operations](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/controllers/user.controller.js): `backend/src/controllers/user.controller.js`
- [User records](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/models/User.js): `backend/src/models/User.js`
- [Friend requests](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/models/FriendRequest.js): `backend/src/models/FriendRequest.js`

### Realtime integration

- [Stream token](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/controllers/chat.controller.js): `backend/src/controllers/chat.controller.js`
- [Stream integration](https://github.com/samiiirkarki-dv/streamify-video-calling-realtime-chat-app-social-app/blob/main/backend/src/lib/stream.js): `backend/src/lib/stream.js`

### Other components

- **User**

## Connections

- User → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Auth and onboarding: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Discovery home: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Friends view: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Friend requests: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Chat view: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Call view: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Auth state: checks auth (evidence: `frontend/src/App.jsx`)
- Auth state → API client: loads user (evidence: `frontend/src/hooks/useAuthUser.js`)
- Auth and onboarding → API client: submits auth (evidence: `frontend/src/pages/LoginPage.jsx`)
- Discovery home → API client: loads discovery (evidence: `frontend/src/pages/HomePage.jsx`)
- Friend requests → API client: manages requests (evidence: `frontend/src/pages/NotificationsPage.jsx`)
- Chat view → API client: requests data (evidence: `frontend/src/pages/ChatPage.jsx`)
- Call view → API client: requests token (evidence: `frontend/src/pages/CallPage.jsx`)
- API client → HTTP server: HTTP requests
- HTTP server → Auth routes: mounts at auth (evidence: `backend/src/server.js`)
- HTTP server → User routes: mounts at users (evidence: `backend/src/server.js`)
- HTTP server → Chat routes: mounts at chat (evidence: `backend/src/server.js`)
- Auth routes → Account operations: dispatches to (evidence: `backend/src/routes/auth.route.js`)
- User routes → Friend operations: dispatches to (evidence: `backend/src/routes/user.route.js`)
- Chat routes → Stream token: dispatches to (evidence: `backend/src/routes/chat.route.js`)
- Account operations → User records: reads and writes (evidence: `backend/src/controllers/auth.controller.js`)
- Account operations → Stream integration: upserts identity (evidence: `backend/src/controllers/auth.controller.js`)
- Friend operations → User records: queries users (evidence: `backend/src/controllers/user.controller.js`)
- Friend operations → Friend requests: manages requests (evidence: `backend/src/controllers/user.controller.js`)
- Stream token → Stream integration: generates token (evidence: `backend/src/controllers/chat.controller.js`)
