# riju-pradhanang/kurakani architecture

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

- Interactive diagram: https://gitdiagram.com/riju-pradhanang/kurakani
- Repository: https://github.com/riju-pradhanang/kurakani

## Overview

Kurakani is a real-time messaging application. Users register or log in, complete a profile, find and add friends, then exchange messages and media; they can also create group conversations and place voice or video calls. The frontend routes pages and coordinates UI, state, HTTP services, sockets, and WebRTC. The backend exposes authenticated REST routes, persists domain records in MongoDB, and relays real-time events through Socket.io. The README documents capabilities and API/events; sampled source confirms selected routes, persistence, socket dispatch, and call handling, but not every UI-to-service interaction.

Main entry points: [`frontend/src/pages/Dashboard.tsx`](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/pages/Dashboard.tsx) (Dashboard), [`frontend/src/services/socketService.ts`](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/socketService.ts) (Socket client), [`backend/models/User.js`](https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/User.js) (User records), [`frontend/src/App.tsx`](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/App.tsx) (App routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routing<br/>[App.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_login["Login and register<br/>[Login.tsx]"]
  node_profile["Profile setup<br/>[ProfileSetup.tsx]"]
  node_authstore["Auth state<br/>[useAuthStore.ts]"]
  node_chatui["Direct chat UI<br/>[ChatWindow.tsx]"]
  node_groupui["Group chat UI"]
  node_authsvc["Auth service<br/>[authService.ts]"]
  node_friendsvc["Friend service<br/>[friendService.ts]"]
  node_groupsvc["Group service<br/>[groupService.ts]"]
  node_messagesvc["Message service<br/>[messageService.ts]"]
end

subgraph group_identity["Identity and social"]
  node_authroutes["Auth routes<br/>[auth.js]"]
  node_authctrl["Auth controller<br/>[authController.js]"]
  node_friendctrl["Friend operations"]
  node_userctrl["User operations<br/>[userController.js]"]
end

subgraph group_conversation["Conversations"]
  node_messageroutes["Message routes<br/>[messages.js]"]
  node_messagectrl["Message operations"]
  node_groupctrl["Group operations<br/>[groupController.js]"]
end

subgraph group_realtime["Realtime and calls"]
  node_socketclient["Socket client<br/>[socketService.ts]"]
  node_webrtc["WebRTC service<br/>[webrtcService.ts]"]
  node_callui["Call interface<br/>[CallModal.tsx]"]
end

subgraph group_platform["API and persistence"]
  node_server["Express and Socket.IO<br/>[server.js]"]
  node_db[("MongoDB connection<br/>[db.js]")]
  node_users[("User records<br/>[User.js]")]
  node_friendrequests[("Friend requests<br/>[FriendRequest.js]")]
  node_messages[("Message records<br/>[Message.js]")]
  node_groups[("Group records<br/>[Group.js]")]
  node_calllogs[("Call logs<br/>[CallLog.js]")]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_dashboard
node_login -->|"authenticates via"| node_authsvc
node_authsvc -->|"requests auth"| node_authroutes
node_authroutes -->|"dispatches to"| node_authctrl
node_authctrl -->|"reads/writes"| node_users
node_authstore -.->|"caches profile"| node_users
node_profile -->|"updates state"| node_authstore
node_dashboard -->|"uses"| node_friendsvc
node_dashboard -->|"uses"| node_groupsvc
node_dashboard -->|"uses"| node_messagesvc
node_dashboard -->|"renders"| node_chatui
node_dashboard -->|"renders"| node_groupui
node_friendsvc -->|"requests friends"| node_friendctrl
node_friendctrl -->|"reads/writes"| node_friendrequests
node_friendctrl -->|"updates friendships"| node_users
node_groupsvc -->|"requests groups"| node_groupctrl
node_groupctrl -->|"reads/writes"| node_groups
node_groupctrl -->|"creates group messages"| node_messages
node_messagesvc -->|"requests messages"| node_messageroutes
node_messageroutes -->|"dispatches to"| node_messagectrl
node_messagectrl -->|"reads/writes"| node_messages
node_messagectrl -->|"queries users"| node_users
node_chatui -.->|"uses events"| node_socketclient
node_groupui -.->|"uses events"| node_socketclient
node_dashboard -->|"uses"| node_socketclient
node_socketclient -->|"sends events"| node_server
node_server -->|"relays events"| node_socketclient
node_server -->|"updates presence"| node_users
node_server -->|"marks read"| node_messages
node_app -->|"shows calls"| node_callui
node_callui -->|"signals calls"| node_socketclient
node_callui -->|"controls media"| node_webrtc
node_webrtc -->|"exchanges candidates"| node_socketclient
node_server -->|"connects"| node_db
node_authctrl -->|"reads/writes"| node_users

click node_app "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/App.tsx"
click node_dashboard "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/pages/Dashboard.tsx"
click node_login "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/pages/Login.tsx"
click node_profile "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/pages/ProfileSetup.tsx"
click node_authstore "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/stores/useAuthStore.ts"
click node_chatui "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/components/ChatWindow.tsx"
click node_groupui "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/components/GroupChatWindow.tsx"
click node_authsvc "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/authService.ts"
click node_friendsvc "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/friendService.ts"
click node_groupsvc "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/groupService.ts"
click node_messagesvc "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/messageService.ts"
click node_socketclient "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/socketService.ts"
click node_webrtc "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/webrtcService.ts"
click node_callui "https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/components/CallModal.tsx"
click node_authroutes "https://github.com/riju-pradhanang/kurakani/blob/main/backend/routes/auth.js"
click node_authctrl "https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/authController.js"
click node_friendctrl "https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/friendController.js"
click node_userctrl "https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/userController.js"
click node_messageroutes "https://github.com/riju-pradhanang/kurakani/blob/main/backend/routes/messages.js"
click node_messagectrl "https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/messageController.js"
click node_groupctrl "https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/groupController.js"
click node_server "https://github.com/riju-pradhanang/kurakani/blob/main/backend/server.js"
click node_db "https://github.com/riju-pradhanang/kurakani/blob/main/backend/config/db.js"
click node_users "https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/User.js"
click node_friendrequests "https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/FriendRequest.js"
click node_messages "https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/Message.js"
click node_groups "https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/Group.js"
click node_calllogs "https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/CallLog.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_dashboard,node_login,node_profile,node_authstore,node_chatui,node_groupui,node_authsvc,node_friendsvc,node_groupsvc,node_messagesvc,node_user toneBlue
class node_authroutes,node_authctrl,node_friendctrl,node_userctrl toneAmber
class node_messageroutes,node_messagectrl,node_groupctrl toneMint
class node_socketclient,node_webrtc,node_callui toneRose
class node_server,node_db,node_users,node_friendrequests,node_messages,node_groups,node_calllogs toneIndigo
```

## Components

### Web client

- [App routing](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Dashboard](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Login and register](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Profile setup](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/pages/ProfileSetup.tsx): `frontend/src/pages/ProfileSetup.tsx`
- [Auth state](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/stores/useAuthStore.ts): `frontend/src/stores/useAuthStore.ts`
- [Direct chat UI](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/components/ChatWindow.tsx): `frontend/src/components/ChatWindow.tsx`
- [Group chat UI](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/components/GroupChatWindow.tsx): `frontend/src/components/GroupChatWindow.tsx`
- [Auth service](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/authService.ts): `frontend/src/services/authService.ts`
- [Friend service](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/friendService.ts): `frontend/src/services/friendService.ts`
- [Group service](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/groupService.ts): `frontend/src/services/groupService.ts`
- [Message service](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/messageService.ts): `frontend/src/services/messageService.ts`

### Identity and social

- [Auth routes](https://github.com/riju-pradhanang/kurakani/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Auth controller](https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Friend operations](https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/friendController.js): `backend/controllers/friendController.js`
- [User operations](https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`

### Conversations

- [Message routes](https://github.com/riju-pradhanang/kurakani/blob/main/backend/routes/messages.js): `backend/routes/messages.js`
- [Message operations](https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/messageController.js): `backend/controllers/messageController.js`
- [Group operations](https://github.com/riju-pradhanang/kurakani/blob/main/backend/controllers/groupController.js): `backend/controllers/groupController.js`

### Realtime and calls

- [Socket client](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/socketService.ts): `frontend/src/services/socketService.ts`
- [WebRTC service](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/services/webrtcService.ts): `frontend/src/services/webrtcService.ts`
- [Call interface](https://github.com/riju-pradhanang/kurakani/blob/main/frontend/src/components/CallModal.tsx): `frontend/src/components/CallModal.tsx`

### API and persistence

- [Express and Socket.IO](https://github.com/riju-pradhanang/kurakani/blob/main/backend/server.js): `backend/server.js`
- [MongoDB connection](https://github.com/riju-pradhanang/kurakani/blob/main/backend/config/db.js): `backend/config/db.js`
- [User records](https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/User.js): `backend/models/User.js`
- [Friend requests](https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/FriendRequest.js): `backend/models/FriendRequest.js`
- [Message records](https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/Message.js): `backend/models/Message.js`
- [Group records](https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/Group.js): `backend/models/Group.js`
- [Call logs](https://github.com/riju-pradhanang/kurakani/blob/main/backend/models/CallLog.js): `backend/models/CallLog.js`

### Other components

- **User**

## Connections

- User → App routing: opens
- App routing → Login and register: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Profile setup: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Login and register → Auth service: authenticates via (evidence: `frontend/src/pages/Login.tsx`)
- Auth service → Auth routes: requests auth
- Auth routes → Auth controller: dispatches to (evidence: `backend/routes/auth.js`)
- Auth controller → User records: reads/writes (evidence: `backend/controllers/authController.js`)
- Auth state → User records: caches profile
- Profile setup → Auth state: updates state (evidence: `frontend/src/pages/ProfileSetup.tsx`)
- Dashboard → Friend service: uses (evidence: `frontend/src/pages/Dashboard.tsx`)
- Dashboard → Group service: uses (evidence: `frontend/src/pages/Dashboard.tsx`)
- Dashboard → Message service: uses (evidence: `frontend/src/pages/Dashboard.tsx`)
- Dashboard → Direct chat UI: renders (evidence: `frontend/src/pages/Dashboard.tsx`)
- Dashboard → Group chat UI: renders (evidence: `frontend/src/pages/Dashboard.tsx`)
- Friend service → Friend operations: requests friends
- Friend operations → Friend requests: reads/writes (evidence: `backend/controllers/friendController.js`)
- Friend operations → User records: updates friendships (evidence: `backend/controllers/friendController.js`)
- Group service → Group operations: requests groups
- Group operations → Group records: reads/writes (evidence: `backend/controllers/groupController.js`)
- Group operations → Message records: creates group messages (evidence: `backend/controllers/groupController.js`)
- Message service → Message routes: requests messages
- Message routes → Message operations: dispatches to (evidence: `backend/routes/messages.js`)
- Message operations → Message records: reads/writes (evidence: `backend/controllers/messageController.js`)
- Message operations → User records: queries users (evidence: `backend/controllers/messageController.js`)
- Direct chat UI → Socket client: uses events
- Group chat UI → Socket client: uses events
- Dashboard → Socket client: uses (evidence: `frontend/src/pages/Dashboard.tsx`)
- Socket client → Express and Socket.IO: sends events
- Express and Socket.IO → Socket client: relays events (evidence: `backend/server.js`)
- Express and Socket.IO → User records: updates presence (evidence: `backend/server.js`)
- Express and Socket.IO → Message records: marks read (evidence: `backend/server.js`)
- App routing → Call interface: shows calls (evidence: `frontend/src/App.tsx`)
- Call interface → Socket client: signals calls (evidence: `frontend/src/components/CallModal.tsx`)
- Call interface → WebRTC service: controls media (evidence: `frontend/src/components/CallModal.tsx`)
- WebRTC service → Socket client: exchanges candidates (evidence: `frontend/src/services/webrtcService.ts`)
- Express and Socket.IO → MongoDB connection: connects (evidence: `backend/server.js`)
- Auth controller → User records: reads/writes (evidence: `backend/controllers/authController.js`)
