# andrewgolias/messenger-app architecture

> Architecture diagram of the GitHub repository andrewgolias/messenger-app, 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/andrewgolias/messenger-app
- Repository: https://github.com/andrewgolias/messenger-app

## Overview

Messenger is the primary product: users register or sign in, then create direct or group conversations, load persistent history, and exchange messages over HTTP or Socket.IO. Group membership and read receipts are additional conversation stages; profile preferences persist light/dark appearance. A retained Study Board reference app supports authenticated board browsing and live entries. The graph follows explicit source calls and mounts; client-side details and some Study Board behavior are represented only where the README or source index supports them.

Main entry points: [`src/routes/messenger.js`](https://github.com/andrewgolias/messenger-app/blob/main/src/routes/messenger.js) (Conversation API), [`src/server.js`](https://github.com/andrewgolias/messenger-app/blob/main/src/server.js) (HTTP and socket host), [`src/messenger/service.js`](https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/service.js) (Conversation services), [`src/routes/auth.js`](https://github.com/andrewgolias/messenger-app/blob/main/src/routes/auth.js) (Account routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser client"]
  node_messenger_ui["Messenger UI<br/>[MessengerApp.jsx]"]
  node_messenger_portal["Messenger entry"]
  node_login_form["Login form<br/>[LoginForm.jsx]"]
  node_study_ui["Study Board UI"]
  node_study_shell["Study app shell<br/>[App.jsx]"]
  node_study_api["Study API client<br/>[studyApi.js]"]
end

subgraph group_identity["Identity and API"]
  node_auth_routes["Account routes<br/>[auth.js]"]
  node_auth_input["Auth validation<br/>[input.js]"]
  node_token["Access tokens<br/>[token.js]"]
  node_auth_middleware["Auth middleware<br/>[requireAuth.js]"]
  node_api_server["HTTP and socket host<br/>[server.js]"]
  node_users[("Accounts<br/>[PrimerUser.js]")]
end

subgraph group_messenger["Messenger domain"]
  node_messenger_mount["Messenger mount<br/>[index.js]"]
  node_messenger_routes["Conversation API<br/>[messenger.js]"]
  node_messenger_input["Message validation<br/>[input.js]"]
  node_messenger_service["Conversation services<br/>[service.js]"]
  node_messenger_socket["Live messaging<br/>[socket.js]"]
  node_conversations[("Conversations<br/>[Conversation.js]")]
  node_messages[("Message history<br/>[Message.js]")]
  node_profiles[("User preferences")]
end

subgraph group_study["Study Board"]
  node_study_routes["Board API<br/>[study.js]"]
  node_study_socket["Live board events<br/>[studySocket.js]"]
  node_study_append["Entry creation<br/>[appendEntry.js]"]
  node_boards[("Study boards<br/>[StudyBoard.js]")]
  node_entries[("Study entries<br/>[StudyEntry.js]")]
end

node_user(("User"))
node_mongo[("MongoDB")]

node_user -->|"uses"| node_messenger_portal
node_messenger_portal -->|"opens"| node_messenger_ui
node_messenger_ui -->|"renders"| node_login_form
node_messenger_ui -->|"uses HTTP"| node_messenger_routes
node_messenger_ui -->|"uses sockets"| node_messenger_socket
node_user -->|"registers or signs in"| node_auth_routes
node_api_server -->|"mounts"| node_auth_routes
node_auth_routes -->|"validates with"| node_auth_input
node_auth_routes -->|"reads and creates"| node_users
node_auth_routes -->|"signs token"| node_token
node_api_server -->|"mounts protected routes"| node_auth_middleware
node_auth_middleware -->|"verifies token"| node_token
node_api_server -->|"attaches"| node_messenger_mount
node_messenger_mount -->|"mounts"| node_messenger_routes
node_messenger_mount -->|"attaches"| node_messenger_socket
node_messenger_routes -->|"validates with"| node_messenger_input
node_messenger_routes -->|"calls"| node_messenger_service
node_messenger_routes -->|"notifies or evicts"| node_messenger_socket
node_messenger_routes -->|"resolves accounts"| node_users
node_messenger_routes -->|"reads and writes preferences"| node_profiles
node_messenger_service -->|"normalizes messages"| node_messenger_input
node_messenger_service -->|"reads and updates"| node_conversations
node_messenger_service -->|"reads and writes"| node_messages
node_messenger_socket -->|"verifies sessions"| node_token
node_messenger_socket -->|"authorizes and sends"| node_messenger_service
node_api_server -->|"attaches"| node_study_socket
node_api_server -->|"mounts"| node_study_routes
node_user -->|"uses reference app"| node_study_shell
node_study_shell -->|"calls"| node_study_api
node_study_shell -->|"renders"| node_study_ui
node_study_ui -->|"loads board data"| node_study_api
node_study_routes -->|"uses"| node_study_append
node_study_socket -->|"appends entries"| node_study_append
node_study_append -->|"checks membership"| node_boards
node_study_append -->|"creates entry"| node_entries
node_api_server -->|"connects"| node_mongo
node_messenger_service -.->|"persists domain records"| node_mongo

click node_messenger_ui "https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/messenger/MessengerApp.jsx"
click node_messenger_portal "https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/messenger/MessengerPortal.jsx"
click node_login_form "https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/messenger/LoginForm.jsx"
click node_study_ui "https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/StudyBoardPanel.jsx"
click node_study_shell "https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/App.jsx"
click node_auth_routes "https://github.com/andrewgolias/messenger-app/blob/main/src/routes/auth.js"
click node_auth_input "https://github.com/andrewgolias/messenger-app/blob/main/src/auth/input.js"
click node_token "https://github.com/andrewgolias/messenger-app/blob/main/src/auth/token.js"
click node_auth_middleware "https://github.com/andrewgolias/messenger-app/blob/main/src/middleware/requireAuth.js"
click node_api_server "https://github.com/andrewgolias/messenger-app/blob/main/src/server.js"
click node_messenger_mount "https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/index.js"
click node_messenger_routes "https://github.com/andrewgolias/messenger-app/blob/main/src/routes/messenger.js"
click node_messenger_input "https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/input.js"
click node_messenger_service "https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/service.js"
click node_messenger_socket "https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/socket.js"
click node_conversations "https://github.com/andrewgolias/messenger-app/blob/main/src/models/Conversation.js"
click node_messages "https://github.com/andrewgolias/messenger-app/blob/main/src/models/Message.js"
click node_profiles "https://github.com/andrewgolias/messenger-app/blob/main/src/models/MessengerProfile.js"
click node_users "https://github.com/andrewgolias/messenger-app/blob/main/src/models/PrimerUser.js"
click node_study_routes "https://github.com/andrewgolias/messenger-app/blob/main/src/routes/study.js"
click node_study_socket "https://github.com/andrewgolias/messenger-app/blob/main/src/realtime/studySocket.js"
click node_study_append "https://github.com/andrewgolias/messenger-app/blob/main/src/study/appendEntry.js"
click node_boards "https://github.com/andrewgolias/messenger-app/blob/main/src/models/StudyBoard.js"
click node_entries "https://github.com/andrewgolias/messenger-app/blob/main/src/models/StudyEntry.js"
click node_study_api "https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/studyApi.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_messenger_ui,node_messenger_portal,node_login_form,node_study_ui,node_study_shell,node_study_api,node_user toneBlue
class node_auth_routes,node_auth_input,node_token,node_auth_middleware,node_api_server,node_users,node_mongo toneAmber
class node_messenger_mount,node_messenger_routes,node_messenger_input,node_messenger_service,node_messenger_socket,node_conversations,node_messages,node_profiles toneMint
class node_study_routes,node_study_socket,node_study_append,node_boards,node_entries toneRose
```

## Components

### Browser client

- [Messenger UI](https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/messenger/MessengerApp.jsx): `src/client/src/messenger/MessengerApp.jsx`
- [Messenger entry](https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/messenger/MessengerPortal.jsx): `src/client/src/messenger/MessengerPortal.jsx`
- [Login form](https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/messenger/LoginForm.jsx): `src/client/src/messenger/LoginForm.jsx`
- [Study Board UI](https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/StudyBoardPanel.jsx): `src/client/src/StudyBoardPanel.jsx`
- [Study app shell](https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/App.jsx): `src/client/src/App.jsx`
- [Study API client](https://github.com/andrewgolias/messenger-app/blob/main/src/client/src/studyApi.js): `src/client/src/studyApi.js`

### Identity and API

- [Account routes](https://github.com/andrewgolias/messenger-app/blob/main/src/routes/auth.js): `src/routes/auth.js`
- [Auth validation](https://github.com/andrewgolias/messenger-app/blob/main/src/auth/input.js): `src/auth/input.js`
- [Access tokens](https://github.com/andrewgolias/messenger-app/blob/main/src/auth/token.js): `src/auth/token.js`
- [Auth middleware](https://github.com/andrewgolias/messenger-app/blob/main/src/middleware/requireAuth.js): `src/middleware/requireAuth.js`
- [HTTP and socket host](https://github.com/andrewgolias/messenger-app/blob/main/src/server.js): `src/server.js`
- [Accounts](https://github.com/andrewgolias/messenger-app/blob/main/src/models/PrimerUser.js): `src/models/PrimerUser.js`

### Messenger domain

- [Messenger mount](https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/index.js): `src/messenger/index.js`
- [Conversation API](https://github.com/andrewgolias/messenger-app/blob/main/src/routes/messenger.js): `src/routes/messenger.js`
- [Message validation](https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/input.js): `src/messenger/input.js`
- [Conversation services](https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/service.js): `src/messenger/service.js`
- [Live messaging](https://github.com/andrewgolias/messenger-app/blob/main/src/messenger/socket.js): `src/messenger/socket.js`
- [Conversations](https://github.com/andrewgolias/messenger-app/blob/main/src/models/Conversation.js): `src/models/Conversation.js`
- [Message history](https://github.com/andrewgolias/messenger-app/blob/main/src/models/Message.js): `src/models/Message.js`
- [User preferences](https://github.com/andrewgolias/messenger-app/blob/main/src/models/MessengerProfile.js): `src/models/MessengerProfile.js`

### Study Board

- [Board API](https://github.com/andrewgolias/messenger-app/blob/main/src/routes/study.js): `src/routes/study.js`
- [Live board events](https://github.com/andrewgolias/messenger-app/blob/main/src/realtime/studySocket.js): `src/realtime/studySocket.js`
- [Entry creation](https://github.com/andrewgolias/messenger-app/blob/main/src/study/appendEntry.js): `src/study/appendEntry.js`
- [Study boards](https://github.com/andrewgolias/messenger-app/blob/main/src/models/StudyBoard.js): `src/models/StudyBoard.js`
- [Study entries](https://github.com/andrewgolias/messenger-app/blob/main/src/models/StudyEntry.js): `src/models/StudyEntry.js`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Messenger entry: uses (evidence: `README.md`)
- Messenger entry → Messenger UI: opens (evidence: `src/client/src/messenger/MessengerPortal.jsx`)
- Messenger UI → Login form: renders (evidence: `src/client/src/messenger/MessengerApp.jsx`)
- Messenger UI → Conversation API: uses HTTP (evidence: `README.md`)
- Messenger UI → Live messaging: uses sockets (evidence: `README.md`)
- User → Account routes: registers or signs in (evidence: `src/routes/auth.js`)
- HTTP and socket host → Account routes: mounts (evidence: `src/server.js`)
- Account routes → Auth validation: validates with (evidence: `src/routes/auth.js`)
- Account routes → Accounts: reads and creates (evidence: `src/routes/auth.js`)
- Account routes → Access tokens: signs token (evidence: `src/routes/auth.js`)
- HTTP and socket host → Auth middleware: mounts protected routes (evidence: `src/server.js`)
- Auth middleware → Access tokens: verifies token (evidence: `src/middleware/requireAuth.js`)
- HTTP and socket host → Messenger mount: attaches (evidence: `src/server.js`)
- Messenger mount → Conversation API: mounts (evidence: `src/messenger/index.js`)
- Messenger mount → Live messaging: attaches (evidence: `src/messenger/index.js`)
- Conversation API → Message validation: validates with (evidence: `src/routes/messenger.js`)
- Conversation API → Conversation services: calls (evidence: `src/routes/messenger.js`)
- Conversation API → Live messaging: notifies or evicts (evidence: `src/routes/messenger.js`)
- Conversation API → Accounts: resolves accounts (evidence: `src/routes/messenger.js`)
- Conversation API → User preferences: reads and writes preferences (evidence: `src/routes/messenger.js`)
- Conversation services → Message validation: normalizes messages (evidence: `src/messenger/service.js`)
- Conversation services → Conversations: reads and updates (evidence: `src/messenger/service.js`)
- Conversation services → Message history: reads and writes (evidence: `src/messenger/service.js`)
- Live messaging → Access tokens: verifies sessions (evidence: `src/messenger/socket.js`)
- Live messaging → Conversation services: authorizes and sends (evidence: `src/messenger/socket.js`)
- HTTP and socket host → Live board events: attaches (evidence: `src/server.js`)
- HTTP and socket host → Board API: mounts (evidence: `src/server.js`)
- User → Study app shell: uses reference app (evidence: `README.md`)
- Study app shell → Study API client: calls (evidence: `src/client/src/App.jsx`)
- Study app shell → Study Board UI: renders (evidence: `src/client/src/App.jsx`)
- Study Board UI → Study API client: loads board data (evidence: `src/client/src/StudyBoardPanel.jsx`)
- Board API → Entry creation: uses (evidence: `src/routes/study.js`)
- Live board events → Entry creation: appends entries (evidence: `src/realtime/studySocket.js`)
- Entry creation → Study boards: checks membership (evidence: `src/study/appendEntry.js`)
- Entry creation → Study entries: creates entry (evidence: `src/study/appendEntry.js`)
- HTTP and socket host → MongoDB: connects (evidence: `src/server.js`)
- Conversation services → MongoDB: persists domain records
