# manpreetsingh-345/chat-app architecture

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

- Interactive diagram: https://gitdiagram.com/manpreetsingh-345/chat-app
- Repository: https://github.com/manpreetsingh-345/chat-app

## Overview

Chatlify is a React/Vite chat application with an Express/TypeScript backend providing registration, token-based authentication, MongoDB persistence, and a basic Socket.IO connection handler. The user-facing path spans landing, signup or login, and a dashboard whose sampled implementation contains local conversation UI and refreshes credentials through the API. Backend routes dispatch authentication and user requests to controllers and services. The README documents Socket.IO message events, but the sampled dashboard does not show a socket client; that connection is therefore shown as unverified. Some frontend routing/auth wiring is present but not fully connected in the sampled route configuration.

Main entry points: [`frontend/app/AppRoutes.tsx`](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/AppRoutes.tsx) (Page routing), [`backend/src/app.ts`](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/app.ts) (HTTP server), [`frontend/app/pages/Dashboard.tsx`](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Dashboard.tsx) (Chat dashboard), [`frontend/app/api/api.ts`](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/api/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_routes["Page routing<br/>[AppRoutes.tsx]"]
  node_home["Landing page<br/>[Home.tsx]"]
  node_layout["Shared layout<br/>[HomeLayout.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_login["Login page<br/>[Login.tsx]"]
  node_signup["Signup page<br/>[Signup.tsx]"]
  node_dashboard["Chat dashboard<br/>[Dashboard.tsx]"]
  node_mobile["Mobile dashboard"]
  node_authstate["Auth state<br/>[useAuth.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP server<br/>[app.ts]"]
  node_auth_routes["Auth routes<br/>[authRoute.ts]"]
  node_user_routes["User routes<br/>[userRoute.ts]"]
  node_auth_controller["Auth controller<br/>[authController.ts]"]
  node_user_controller["User controller<br/>[userController.ts]"]
  node_auth_middleware["Token verification<br/>[verifyAuthUser.ts]"]
end

subgraph group_identity["Identity and storage"]
  node_user_service["User service<br/>[userService.ts]"]
  node_token_service["Token service<br/>[tokenService.ts]"]
  node_user_model[("User records<br/>[User.ts]")]
  node_refresh_model[("Refresh tokens<br/>[RefreshToken.ts]")]
  node_db[("MongoDB setup<br/>[db.ts]")]
end

subgraph group_realtime["Realtime messaging"]
  node_socket_handler["Socket handler"]
end

node_person(("User"))
node_socket_clients(("Socket clients"))
node_mongo[("MongoDB")]

node_person -->|"uses pages"| node_routes
node_routes -->|"renders layout"| node_layout
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_signup
node_routes -->|"routes to"| node_dashboard
node_layout -->|"renders"| node_navbar
node_login -->|"calls API"| node_api_client
node_signup -->|"calls API"| node_api_client
node_dashboard -->|"calls API"| node_api_client
node_dashboard -->|"reads auth"| node_authstate
node_mobile -->|"renders"| node_dashboard
node_api_client -.->|"sends requests"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_user_routes
node_auth_routes -->|"dispatches to"| node_auth_controller
node_auth_routes -->|"protects route"| node_auth_middleware
node_user_routes -->|"dispatches to"| node_user_controller
node_user_routes -->|"protects route"| node_auth_middleware
node_auth_controller -->|"finds users"| node_user_service
node_auth_controller -->|"manages tokens"| node_token_service
node_user_controller -->|"persists users"| node_user_service
node_user_service -->|"reads and saves"| node_user_model
node_token_service -->|"persists tokens"| node_refresh_model
node_server -->|"initializes"| node_db
node_db -.->|"connects to"| node_mongo
node_server -->|"initializes"| node_socket_handler
node_socket_clients -.->|"emits messages"| node_socket_handler

click node_routes "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/AppRoutes.tsx"
click node_home "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Home.tsx"
click node_layout "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/components/HomeLayout.tsx"
click node_navbar "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/components/Navbar.tsx"
click node_login "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Login.tsx"
click node_signup "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Signup.tsx"
click node_dashboard "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Dashboard.tsx"
click node_mobile "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/MobileDashboard.tsx"
click node_authstate "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/hooks/useAuth.tsx"
click node_api_client "https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/api/api.ts"
click node_server "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/routes/authRoute.ts"
click node_user_routes "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/routes/userRoute.ts"
click node_auth_controller "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/controllers/authController.ts"
click node_user_controller "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/controllers/userController.ts"
click node_auth_middleware "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/middleware/verifyAuthUser.ts"
click node_user_service "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/services/userService.ts"
click node_token_service "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/services/tokenService.ts"
click node_user_model "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/models/User.ts"
click node_refresh_model "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/models/RefreshToken.ts"
click node_db "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/db/db.ts"
click node_socket_handler "https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/utils/handleSocketConnection.ts"

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_routes,node_home,node_layout,node_navbar,node_login,node_signup,node_dashboard,node_mobile,node_authstate,node_api_client,node_person,node_socket_clients toneBlue
class node_server,node_auth_routes,node_user_routes,node_auth_controller,node_user_controller,node_auth_middleware,node_mongo toneAmber
class node_user_service,node_token_service,node_user_model,node_refresh_model,node_db toneMint
class node_socket_handler toneRose
```

## Components

### Frontend experience

- [Page routing](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/AppRoutes.tsx): `frontend/app/AppRoutes.tsx`
- [Landing page](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Home.tsx): `frontend/app/pages/Home.tsx`
- [Shared layout](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/components/HomeLayout.tsx): `frontend/app/components/HomeLayout.tsx`
- [Navigation](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/components/Navbar.tsx): `frontend/app/components/Navbar.tsx`
- [Login page](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Login.tsx): `frontend/app/pages/Login.tsx`
- [Signup page](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Signup.tsx): `frontend/app/pages/Signup.tsx`
- [Chat dashboard](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/Dashboard.tsx): `frontend/app/pages/Dashboard.tsx`
- [Mobile dashboard](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/pages/MobileDashboard.tsx): `frontend/app/pages/MobileDashboard.tsx`
- [Auth state](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/hooks/useAuth.tsx): `frontend/app/hooks/useAuth.tsx`
- [API client](https://github.com/manpreetsingh-345/chat-app/blob/main/frontend/app/api/api.ts): `frontend/app/api/api.ts`

### Backend API

- [HTTP server](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Auth routes](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/routes/authRoute.ts): `backend/src/routes/authRoute.ts`
- [User routes](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/routes/userRoute.ts): `backend/src/routes/userRoute.ts`
- [Auth controller](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/controllers/authController.ts): `backend/src/controllers/authController.ts`
- [User controller](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/controllers/userController.ts): `backend/src/controllers/userController.ts`
- [Token verification](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/middleware/verifyAuthUser.ts): `backend/src/middleware/verifyAuthUser.ts`

### Identity and storage

- [User service](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/services/userService.ts): `backend/src/services/userService.ts`
- [Token service](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/services/tokenService.ts): `backend/src/services/tokenService.ts`
- [User records](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/models/User.ts): `backend/src/models/User.ts`
- [Refresh tokens](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/models/RefreshToken.ts): `backend/src/models/RefreshToken.ts`
- [MongoDB setup](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/db/db.ts): `backend/src/db/db.ts`

### Realtime messaging

- [Socket handler](https://github.com/manpreetsingh-345/chat-app/blob/main/backend/src/utils/handleSocketConnection.ts): `backend/src/utils/handleSocketConnection.ts`

### Other components

- **User**
- **Socket clients**
- **MongoDB**

## Connections

- User → Page routing: uses pages (evidence: `frontend/app/AppRoutes.tsx`)
- Page routing → Shared layout: renders layout (evidence: `frontend/app/AppRoutes.tsx`)
- Page routing → Landing page: routes to (evidence: `frontend/app/AppRoutes.tsx`)
- Page routing → Login page: routes to (evidence: `frontend/app/AppRoutes.tsx`)
- Page routing → Signup page: routes to (evidence: `frontend/app/AppRoutes.tsx`)
- Page routing → Chat dashboard: routes to (evidence: `frontend/app/AppRoutes.tsx`)
- Shared layout → Navigation: renders (evidence: `frontend/app/components/HomeLayout.tsx`)
- Login page → API client: calls API (evidence: `frontend/app/pages/Login.tsx`)
- Signup page → API client: calls API (evidence: `frontend/app/pages/Signup.tsx`)
- Chat dashboard → API client: calls API (evidence: `frontend/app/pages/Dashboard.tsx`)
- Chat dashboard → Auth state: reads auth (evidence: `frontend/app/pages/Dashboard.tsx`)
- Mobile dashboard → Chat dashboard: renders (evidence: `frontend/app/pages/MobileDashboard.tsx`)
- API client → HTTP server: sends requests (evidence: `README.md`)
- HTTP server → Auth routes: mounts routes (evidence: `backend/src/app.ts`)
- HTTP server → User routes: mounts routes (evidence: `backend/src/app.ts`)
- Auth routes → Auth controller: dispatches to (evidence: `backend/src/routes/authRoute.ts`)
- Auth routes → Token verification: protects route (evidence: `backend/src/routes/authRoute.ts`)
- User routes → User controller: dispatches to (evidence: `backend/src/routes/userRoute.ts`)
- User routes → Token verification: protects route (evidence: `backend/src/routes/userRoute.ts`)
- Auth controller → User service: finds users (evidence: `backend/src/controllers/authController.ts`)
- Auth controller → Token service: manages tokens (evidence: `backend/src/controllers/authController.ts`)
- User controller → User service: persists users (evidence: `backend/src/controllers/userController.ts`)
- User service → User records: reads and saves (evidence: `backend/src/services/userService.ts`)
- Token service → Refresh tokens: persists tokens (evidence: `backend/src/services/tokenService.ts`)
- HTTP server → MongoDB setup: initializes (evidence: `backend/server.ts`)
- MongoDB setup → MongoDB: connects to (evidence: `README.md`)
- HTTP server → Socket handler: initializes (evidence: `backend/server.ts`)
- Socket clients → Socket handler: emits messages (evidence: `README.md`)
