# harshul786/chat-application architecture

> Architecture diagram of the GitHub repository harshul786/chat-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshul786/chat-application
- Repository: https://github.com/harshul786/chat-application

## Overview

##### Project type and purpose
- This is a full-stack chat application (“chat-application”) with:
- A React single-page frontend (bootstrapped with Create React App) under `src/`
- A Node.js/Express REST API server under `server/`
- A MongoDB datastore accessed via Mongoose
- Local avatar storage (`server/avatars/`)

##### File structure
- Top-level files: `package.json`, `webpack.config.js`, `tailwind.config.js` (frontend build and styling)
- `public/` – static HTML, manifest, robots.txt
- `src/` – React components, pages, context, utilities, assets
- `src/Components/` – UI building blocks (ChatView, LeftBar, Login, Signup, etc.)
- `src/Pages/` – route targets (HomePage, ChatPage)
- `src/Context/chatProvider.js` – global state (chat context)
- `server/` – Express app
- `server/index.js` – entry point, app and middleware setup
- `server/routes/` – route definitions (`userRoutes.js`, `chatRoutes.js`, `messageRoutes.js`)
- `server/controllers/` – business logic for users, chats, messages
- `server/models/` – Mongoose schemas (`users.js`, `chats.js`, `messages.js`)
- `server/middleware/auth.js` – authentication guard (likely JWT)
- `server/mongoose/index.js` – DB connection logic
- `server/avatars/` – persisted uploaded user avatar images
- Deployment config: `server/vercel.json`

##### README
- Confirms CRA setup and usual npm scripts.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend"
        direction TB
        ReactApp["React App (SPA)"]:::frontend
        UIComponents["UI Components"]:::frontend
        PageRoutes["Page Routes"]:::frontend
        ChatContext["Global Chat Context"]:::frontend
        Utils["Utility Functions"]:::frontend
        Assets["Static Assets"]:::frontend
        Images["Images"]:::frontend
        Webpack["webpack.config.js"]:::frontend
        Tailwind["tailwind.config.js"]:::frontend
        Public["public/"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend"
        direction TB
        ExpressServer["Express API Server"]:::backend
        AuthMiddleware["Auth Middleware"]:::backend
        subgraph "Routes"
            direction TB
            UserRoutes["User Routes"]:::backend
            ChatRoutes["Chat Routes"]:::backend
            MessageRoutes["Message Routes"]:::backend
        end
        subgraph "Controllers"
            direction TB
            ChatController["Chat Controller"]:::backend
            MessageController["Message Controller"]:::backend
        end
        subgraph "Models"
            direction TB
            UserModel["User Model"]:::backend
            ChatModel["Chat Model"]:::backend
            MessageModel["Message Model"]:::backend
        end
        DBConn["MongoDB Connection"]:::backend
        AvatarStore["Avatar Storage"]:::storage
        Vercel["Vercel Config"]:::external
    end

    %% External Database
    MongoDB[(MongoDB)]:::db

    %% Connections
    ReactApp -->|"HTTP calls"| ExpressServer
    UIComponents --> ReactApp
    PageRoutes --> ReactApp
    ChatContext --> ReactApp
    Utils --> ReactApp
    Assets --> ReactApp
    Images --> ReactApp
    Webpack --> ReactApp
    Tailwind --> ReactApp
    Public --> ReactApp

    ExpressServer --> AuthMiddleware
    AuthMiddleware --> UserRoutes
    AuthMiddleware --> ChatRoutes
    AuthMiddleware --> MessageRoutes

    UserRoutes --> ChatController
    ChatRoutes --> ChatController
    MessageRoutes --> MessageController

    ChatController --> ChatModel
    MessageController --> MessageModel

    ChatModel --> MongoDB
    MessageModel --> MongoDB
    UserModel --> MongoDB

    ExpressServer --> DBConn
    ExpressServer --> AvatarStore
    Vercel -.-> ExpressServer

    %% Click Events
    click ReactApp "https://github.com/harshul786/chat-application/tree/main/src/"
    click UIComponents "https://github.com/harshul786/chat-application/tree/main/src/Components/"
    click PageRoutes "https://github.com/harshul786/chat-application/tree/main/src/Pages/"
    click ChatContext "https://github.com/harshul786/chat-application/blob/main/src/Context/chatProvider.js"
    click Utils "https://github.com/harshul786/chat-application/blob/main/src/utils/utils.js"
    click Assets "https://github.com/harshul786/chat-application/tree/main/src/assets/"
    click Images "https://github.com/harshul786/chat-application/tree/main/src/images/"
    click Webpack "https://github.com/harshul786/chat-application/blob/main/webpack.config.js"
    click Tailwind "https://github.com/harshul786/chat-application/blob/main/tailwind.config.js"
    click Public "https://github.com/harshul786/chat-application/tree/main/public/"
    click ExpressServer "https://github.com/harshul786/chat-application/blob/main/server/index.js"
    click UserRoutes "https://github.com/harshul786/chat-application/blob/main/server/routes/userRoutes.js"
    click ChatRoutes "https://github.com/harshul786/chat-application/blob/main/server/routes/chatRoutes.js"
    click MessageRoutes "https://github.com/harshul786/chat-application/blob/main/server/routes/messageRoutes.js"
    click ChatController "https://github.com/harshul786/chat-application/blob/main/server/controllers/chatController.js"
    click MessageController "https://github.com/harshul786/chat-application/blob/main/server/controllers/messageController.js"
    click UserModel "https://github.com/harshul786/chat-application/blob/main/server/models/users.js"
    click ChatModel "https://github.com/harshul786/chat-application/blob/main/server/models/chats.js"
    click MessageModel "https://github.com/harshul786/chat-application/blob/main/server/models/messages.js"
    click AuthMiddleware "https://github.com/harshul786/chat-application/blob/main/server/middleware/auth.js"
    click DBConn "https://github.com/harshul786/chat-application/blob/main/server/mongoose/index.js"
    click AvatarStore "https://github.com/harshul786/chat-application/tree/main/server/avatars/"
    click Vercel "https://github.com/harshul786/chat-application/blob/main/server/vercel.json"

    %% Styles
    classDef frontend fill:#bbdefb,stroke:#1e88e5
    classDef backend fill:#c8e6c9,stroke:#2e7d32
    classDef db fill:#fff9c4,stroke:#f9a825
    classDef storage fill:#ffe0b2,stroke:#ef6c00
    classDef external fill:#e0e0e0,stroke:#757575,stroke-dasharray:5 5
```
