# burakorkmez/imessage architecture

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

- Interactive diagram: https://gitdiagram.com/burakorkmez/imessage
- Repository: https://github.com/burakorkmez/imessage

## Overview

This is a full-stack real-time chat app. A signed-in user enters the chat page, selects a conversation, loads its messages, and sends text or media; the backend persists messages and can deliver them over Socket.io to an online recipient. Clerk-backed authentication and profile synchronization support that workflow. The README also documents presence, media sharing, themes, wallpapers, and keyboard sounds. Some UI components and route implementations were not sampled, so their links are omitted or marked unverified rather than inferred as confirmed calls.

Main entry points: [`frontend/src/App.jsx`](https://github.com/burakorkmez/imessage/blob/master/frontend/src/App.jsx) (App routing), [`frontend/src/pages/ChatPage.jsx`](https://github.com/burakorkmez/imessage/blob/master/frontend/src/pages/ChatPage.jsx) (Chat page), [`frontend/src/store/useChatStore.js`](https://github.com/burakorkmez/imessage/blob/master/frontend/src/store/useChatStore.js) (Chat state), [`frontend/src/store/useAuthStore.js`](https://github.com/burakorkmez/imessage/blob/master/frontend/src/store/useAuthStore.js) (Auth state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_authpage["Authentication page<br/>[AuthPage.jsx]"]
  node_chatpage["Chat page<br/>[ChatPage.jsx]"]
  node_authstore["Auth state<br/>[useAuthStore.js]"]
  node_chatstore["Chat state<br/>[useChatStore.js]"]
  node_conversationview["Conversation adapter"]
  node_chatcomponents["Chat components"]
  node_authcomponents["Auth components"]
  node_axios["HTTP client<br/>[axios.js]"]
end

subgraph group_backend["Backend services"]
  node_api["Express application<br/>[index.js]"]
  node_messageroutes["Message routes<br/>[message.route.js]"]
  node_messagecontroller["Message operations"]
  node_messagestore[("Message records<br/>[message.model.js]")]
  node_database[("MongoDB connection<br/>[db.js]")]
  node_cron["Scheduled job<br/>[cron.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_authroutes["Auth routes<br/>[auth.route.js]"]
  node_authmiddleware["Route protection<br/>[auth.middleware.js]"]
  node_authcontroller["Auth check<br/>[auth.controller.js]"]
  node_webhook["Clerk webhook<br/>[clerk.webhook.js]"]
  node_userstore[("User profiles<br/>[user.model.js]")]
end

subgraph group_realtime["Realtime and media"]
  node_socket["Socket transport<br/>[socket.js]"]
  node_imagekit["Media uploads<br/>[imagekit.js]"]
  node_uploadmiddleware["Upload handling"]
end

subgraph group_appearance["Appearance and preferences"]
  node_appearanceui["Theme and wallpaper controls"]
  node_themecontext["Theme context<br/>[ThemeContext.jsx]"]
  node_wallpapercontext["Wallpaper context"]
  node_themedata["Theme presets"]
  node_wallpaperdata["Wallpaper presets<br/>[wallpapers.js]"]
  node_keyboard["Keyboard sounds"]
end

node_user(("Chat user"))

node_user -->|"uses"| node_app
node_app -->|"checks session"| node_authstore
node_app -->|"routes to"| node_authpage
node_app -->|"routes to"| node_chatpage
node_chatpage -->|"loads and updates"| node_chatstore
node_chatpage -->|"renders"| node_chatcomponents
node_chatstore -->|"sends requests"| node_axios
node_authstore -->|"checks auth"| node_axios
node_authstore -->|"connects"| node_socket
node_chatstore -->|"uses socket"| node_authstore
node_chatpage -->|"selects conversation"| node_conversationview
node_conversationview -->|"reads state"| node_chatstore
node_conversationview -->|"reads presence"| node_authstore
node_app -->|"provides theme"| node_themecontext
node_app -->|"provides wallpaper"| node_wallpapercontext
node_themecontext -->|"loads presets"| node_themedata
node_wallpapercontext -->|"loads choices"| node_wallpaperdata
node_authpage -->|"renders"| node_authcomponents
node_authpage -->|"reads wallpaper"| node_wallpapercontext
node_user -.->|"selects peer"| node_chatpage
node_chatstore -.->|"requests messages"| node_messageroutes
node_chatstore -.->|"checks session"| node_authroutes
node_api -->|"mounts routes"| node_authroutes
node_api -->|"mounts routes"| node_messageroutes
node_api -->|"mounts webhook"| node_webhook
node_authroutes -->|"protects check"| node_authmiddleware
node_authroutes -->|"runs check"| node_authcontroller
node_authmiddleware -->|"finds profile"| node_userstore
node_webhook -->|"syncs profile"| node_userstore
node_messageroutes -->|"routes requests"| node_messagecontroller
node_messageroutes -->|"protects routes"| node_authmiddleware
node_messagecontroller -->|"queries users"| node_userstore
node_messagecontroller -->|"reads and saves"| node_messagestore
node_messagecontroller -->|"uploads media"| node_imagekit
node_messagecontroller -->|"emits message"| node_socket
node_authstore -->|"receives presence"| node_socket
node_api -->|"connects on start"| node_database
node_api -->|"starts in production"| node_cron
node_chatpage -.->|"offers preferences"| node_appearanceui
node_chatcomponents -.->|"uses sound"| node_keyboard

click node_app "https://github.com/burakorkmez/imessage/blob/master/frontend/src/App.jsx"
click node_authpage "https://github.com/burakorkmez/imessage/blob/master/frontend/src/pages/AuthPage.jsx"
click node_chatpage "https://github.com/burakorkmez/imessage/blob/master/frontend/src/pages/ChatPage.jsx"
click node_authstore "https://github.com/burakorkmez/imessage/blob/master/frontend/src/store/useAuthStore.js"
click node_chatstore "https://github.com/burakorkmez/imessage/blob/master/frontend/src/store/useChatStore.js"
click node_conversationview "https://github.com/burakorkmez/imessage/blob/master/frontend/src/hooks/useSelectedConversation.js"
click node_chatcomponents "https://github.com/burakorkmez/imessage/tree/master/frontend/src/components/chat"
click node_authcomponents "https://github.com/burakorkmez/imessage/tree/master/frontend/src/components/auth"
click node_appearanceui "https://github.com/burakorkmez/imessage/tree/master/frontend/src/components"
click node_themecontext "https://github.com/burakorkmez/imessage/blob/master/frontend/src/context/ThemeContext.jsx"
click node_wallpapercontext "https://github.com/burakorkmez/imessage/blob/master/frontend/src/context/WallpaperContext.jsx"
click node_themedata "https://github.com/burakorkmez/imessage/blob/master/frontend/src/data/herouiThemePresets.js"
click node_wallpaperdata "https://github.com/burakorkmez/imessage/blob/master/frontend/src/data/wallpapers.js"
click node_keyboard "https://github.com/burakorkmez/imessage/blob/master/frontend/src/hooks/useKeyboardSound.js"
click node_api "https://github.com/burakorkmez/imessage/blob/master/backend/src/index.js"
click node_authroutes "https://github.com/burakorkmez/imessage/blob/master/backend/src/routes/auth.route.js"
click node_authmiddleware "https://github.com/burakorkmez/imessage/blob/master/backend/src/middleware/auth.middleware.js"
click node_authcontroller "https://github.com/burakorkmez/imessage/blob/master/backend/src/controllers/auth.controller.js"
click node_webhook "https://github.com/burakorkmez/imessage/blob/master/backend/src/webhooks/clerk.webhook.js"
click node_userstore "https://github.com/burakorkmez/imessage/blob/master/backend/src/models/user.model.js"
click node_messageroutes "https://github.com/burakorkmez/imessage/blob/master/backend/src/routes/message.route.js"
click node_messagecontroller "https://github.com/burakorkmez/imessage/blob/master/backend/src/controllers/message.controller.js"
click node_messagestore "https://github.com/burakorkmez/imessage/blob/master/backend/src/models/message.model.js"
click node_socket "https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/socket.js"
click node_imagekit "https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/imagekit.js"
click node_uploadmiddleware "https://github.com/burakorkmez/imessage/blob/master/backend/src/middleware/upload.middleware.js"
click node_database "https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/db.js"
click node_cron "https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/cron.js"
click node_axios "https://github.com/burakorkmez/imessage/blob/master/frontend/src/lib/axios.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_authpage,node_chatpage,node_authstore,node_chatstore,node_conversationview,node_chatcomponents,node_authcomponents,node_axios,node_user toneBlue
class node_api,node_messageroutes,node_messagecontroller,node_messagestore,node_database,node_cron toneAmber
class node_authroutes,node_authmiddleware,node_authcontroller,node_webhook,node_userstore toneMint
class node_socket,node_imagekit,node_uploadmiddleware toneRose
class node_appearanceui,node_themecontext,node_wallpapercontext,node_themedata,node_wallpaperdata,node_keyboard toneIndigo
```

## Components

### Frontend experience

- [App routing](https://github.com/burakorkmez/imessage/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Authentication page](https://github.com/burakorkmez/imessage/blob/master/frontend/src/pages/AuthPage.jsx): `frontend/src/pages/AuthPage.jsx`
- [Chat page](https://github.com/burakorkmez/imessage/blob/master/frontend/src/pages/ChatPage.jsx): `frontend/src/pages/ChatPage.jsx`
- [Auth state](https://github.com/burakorkmez/imessage/blob/master/frontend/src/store/useAuthStore.js): `frontend/src/store/useAuthStore.js`
- [Chat state](https://github.com/burakorkmez/imessage/blob/master/frontend/src/store/useChatStore.js): `frontend/src/store/useChatStore.js`
- [Conversation adapter](https://github.com/burakorkmez/imessage/blob/master/frontend/src/hooks/useSelectedConversation.js): `frontend/src/hooks/useSelectedConversation.js`
- [Chat components](https://github.com/burakorkmez/imessage/tree/master/frontend/src/components/chat): `frontend/src/components/chat`
- [Auth components](https://github.com/burakorkmez/imessage/tree/master/frontend/src/components/auth): `frontend/src/components/auth`
- [HTTP client](https://github.com/burakorkmez/imessage/blob/master/frontend/src/lib/axios.js): `frontend/src/lib/axios.js`

### Backend services

- [Express application](https://github.com/burakorkmez/imessage/blob/master/backend/src/index.js): `backend/src/index.js`
- [Message routes](https://github.com/burakorkmez/imessage/blob/master/backend/src/routes/message.route.js): `backend/src/routes/message.route.js`
- [Message operations](https://github.com/burakorkmez/imessage/blob/master/backend/src/controllers/message.controller.js): `backend/src/controllers/message.controller.js`
- [Message records](https://github.com/burakorkmez/imessage/blob/master/backend/src/models/message.model.js): `backend/src/models/message.model.js`
- [MongoDB connection](https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/db.js): `backend/src/lib/db.js`
- [Scheduled job](https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/cron.js): `backend/src/lib/cron.js`

### Identity and profiles

- [Auth routes](https://github.com/burakorkmez/imessage/blob/master/backend/src/routes/auth.route.js): `backend/src/routes/auth.route.js`
- [Route protection](https://github.com/burakorkmez/imessage/blob/master/backend/src/middleware/auth.middleware.js): `backend/src/middleware/auth.middleware.js`
- [Auth check](https://github.com/burakorkmez/imessage/blob/master/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Clerk webhook](https://github.com/burakorkmez/imessage/blob/master/backend/src/webhooks/clerk.webhook.js): `backend/src/webhooks/clerk.webhook.js`
- [User profiles](https://github.com/burakorkmez/imessage/blob/master/backend/src/models/user.model.js): `backend/src/models/user.model.js`

### Realtime and media

- [Socket transport](https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/socket.js): `backend/src/lib/socket.js`
- [Media uploads](https://github.com/burakorkmez/imessage/blob/master/backend/src/lib/imagekit.js): `backend/src/lib/imagekit.js`
- [Upload handling](https://github.com/burakorkmez/imessage/blob/master/backend/src/middleware/upload.middleware.js): `backend/src/middleware/upload.middleware.js`

### Appearance and preferences

- [Theme and wallpaper controls](https://github.com/burakorkmez/imessage/tree/master/frontend/src/components): `frontend/src/components`
- [Theme context](https://github.com/burakorkmez/imessage/blob/master/frontend/src/context/ThemeContext.jsx): `frontend/src/context/ThemeContext.jsx`
- [Wallpaper context](https://github.com/burakorkmez/imessage/blob/master/frontend/src/context/WallpaperContext.jsx): `frontend/src/context/WallpaperContext.jsx`
- [Theme presets](https://github.com/burakorkmez/imessage/blob/master/frontend/src/data/herouiThemePresets.js): `frontend/src/data/herouiThemePresets.js`
- [Wallpaper presets](https://github.com/burakorkmez/imessage/blob/master/frontend/src/data/wallpapers.js): `frontend/src/data/wallpapers.js`
- [Keyboard sounds](https://github.com/burakorkmez/imessage/blob/master/frontend/src/hooks/useKeyboardSound.js): `frontend/src/hooks/useKeyboardSound.js`

### Other components

- **Chat user**

## Connections

- Chat user → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Auth state: checks session (evidence: `frontend/src/App.jsx`)
- App routing → Authentication page: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Chat page: routes to (evidence: `frontend/src/App.jsx`)
- Chat page → Chat state: loads and updates (evidence: `frontend/src/pages/ChatPage.jsx`)
- Chat page → Chat components: renders (evidence: `frontend/src/pages/ChatPage.jsx`)
- Chat state → HTTP client: sends requests (evidence: `frontend/src/store/useChatStore.js`)
- Auth state → HTTP client: checks auth (evidence: `frontend/src/store/useAuthStore.js`)
- Auth state → Socket transport: connects (evidence: `frontend/src/store/useAuthStore.js`)
- Chat state → Auth state: uses socket (evidence: `frontend/src/store/useChatStore.js`)
- Chat page → Conversation adapter: selects conversation (evidence: `frontend/src/pages/ChatPage.jsx`)
- Conversation adapter → Chat state: reads state (evidence: `frontend/src/hooks/useSelectedConversation.js`)
- Conversation adapter → Auth state: reads presence (evidence: `frontend/src/hooks/useSelectedConversation.js`)
- App routing → Theme context: provides theme (evidence: `frontend/src/App.jsx`)
- App routing → Wallpaper context: provides wallpaper (evidence: `frontend/src/App.jsx`)
- Theme context → Theme presets: loads presets (evidence: `frontend/src/context/ThemeContext.jsx`)
- Wallpaper context → Wallpaper presets: loads choices (evidence: `frontend/src/context/WallpaperContext.jsx`)
- Authentication page → Auth components: renders (evidence: `frontend/src/pages/AuthPage.jsx`)
- Authentication page → Wallpaper context: reads wallpaper (evidence: `frontend/src/pages/AuthPage.jsx`)
- Chat user → Chat page: selects peer
- Chat state → Message routes: requests messages
- Chat state → Auth routes: checks session
- Express application → Auth routes: mounts routes (evidence: `backend/src/index.js`)
- Express application → Message routes: mounts routes (evidence: `backend/src/index.js`)
- Express application → Clerk webhook: mounts webhook (evidence: `backend/src/index.js`)
- Auth routes → Route protection: protects check (evidence: `backend/src/routes/auth.route.js`)
- Auth routes → Auth check: runs check (evidence: `backend/src/routes/auth.route.js`)
- Route protection → User profiles: finds profile (evidence: `backend/src/middleware/auth.middleware.js`)
- Clerk webhook → User profiles: syncs profile (evidence: `backend/src/webhooks/clerk.webhook.js`)
- Message routes → Message operations: routes requests (evidence: `backend/src/routes/message.route.js`)
- Message routes → Route protection: protects routes (evidence: `backend/src/routes/message.route.js`)
- Message operations → User profiles: queries users (evidence: `backend/src/controllers/message.controller.js`)
- Message operations → Message records: reads and saves (evidence: `backend/src/controllers/message.controller.js`)
- Message operations → Media uploads: uploads media (evidence: `backend/src/controllers/message.controller.js`)
- Message operations → Socket transport: emits message (evidence: `backend/src/controllers/message.controller.js`)
- Auth state → Socket transport: receives presence (evidence: `frontend/src/store/useAuthStore.js`)
- Express application → MongoDB connection: connects on start (evidence: `backend/src/index.js`)
- Express application → Scheduled job: starts in production (evidence: `backend/src/index.js`)
- Chat page → Theme and wallpaper controls: offers preferences (evidence: `frontend/src/pages/ChatPage.jsx`)
- Chat components → Keyboard sounds: uses sound
