# wajih1234/social-app architecture

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

- Interactive diagram: https://gitdiagram.com/wajih1234/social-app
- Repository: https://github.com/wajih1234/social-app

## Overview

This is a social networking application: users sign in, then browse and create posts, find profiles, manage account details, and exchange messages. The frontend routes authenticated experiences and sends requests through a shared API client; the Express backend mounts feature routes, authenticates requests, and persists domain data in MongoDB. Image upload and socket messaging are distinct capabilities. Backend route implementations and several frontend pages were not excerpted, so their internal behavior and some client-to-server wiring are not asserted beyond the indexed references.

Main entry points: [`frontend/src/App.jsx`](https://github.com/wajih1234/social-app/blob/main/frontend/src/App.jsx) (App routing), [`back/server.js`](https://github.com/wajih1234/social-app/blob/main/back/server.js) (HTTP and socket server), [`frontend/src/api.js`](https://github.com/wajih1234/social-app/blob/main/frontend/src/api.js) (API client), [`back/middleware/auth.js`](https://github.com/wajih1234/social-app/blob/main/back/middleware/auth.js) (JWT middleware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routing<br/>[App.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_upload_ui["Image upload client<br/>[uploadImage.js]"]
end

subgraph group_identity["Identity"]
  node_auth_ui["Auth state<br/>[AuthContext.jsx]"]
  node_login["Sign in<br/>[Login.jsx]"]
  node_signup["Sign up<br/>[Signup.jsx]"]
  node_verify["Email verification<br/>[VerifyEmail.jsx]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
end

subgraph group_social["Social features"]
  node_home["Home feed<br/>[Home.jsx]"]
  node_post_create["Post creation<br/>[CreatePost.jsx]"]
  node_post_card["Post interactions<br/>[PostCard.jsx]"]
  node_profile["Profiles<br/>[Profile.jsx]"]
  node_search["People search<br/>[Search.jsx]"]
  node_settings["Account settings<br/>[Settings.jsx]"]
  node_messages["Messaging<br/>[Messages.jsx]"]
  node_socket_ui["Socket client<br/>[SocketContext.jsx]"]
end

subgraph group_backend["Backend services"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_auth_middleware["JWT middleware<br/>[auth.js]"]
  node_post_routes["Post routes<br/>[posts.js]"]
  node_user_routes["User routes<br/>[users.js]"]
  node_message_routes["Message routes<br/>[messages.js]"]
  node_upload_routes["Upload routes<br/>[upload.js]"]
  node_email["Email sender<br/>[sendEmail.js]"]
end

subgraph group_data["Persistent data"]
  node_user_model[("User records<br/>[User.js]")]
  node_post_model[("Post records<br/>[Post.js]")]
  node_message_model[("Message records<br/>[Message.js]")]
  node_uploads[("Uploaded files")]
end

node_person(("Member"))

node_person -->|"uses"| node_app
node_app -->|"checks access"| node_auth_ui
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_verify
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_search
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_messages
node_login -->|"uses"| node_auth_ui
node_signup -->|"uses"| node_auth_ui
node_auth_ui -->|"requests identity"| node_api
node_home -->|"loads feed"| node_api
node_home -->|"renders"| node_post_create
node_home -->|"renders"| node_post_card
node_post_create -->|"creates post"| node_api
node_post_create -->|"uploads image"| node_upload_ui
node_post_card -->|"updates post"| node_api
node_search -->|"searches users"| node_api
node_profile -->|"loads profile"| node_api
node_settings -->|"updates account"| node_api
node_messages -->|"loads messages"| node_api
node_messages -->|"uses socket"| node_socket_ui
node_api -.->|"HTTP requests"| node_server
node_upload_ui -.->|"upload request"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_post_routes
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_message_routes
node_server -->|"mounts"| node_upload_routes
node_auth_routes -->|"queries"| node_user_model
node_auth_routes -->|"protects profile"| node_auth_middleware
node_post_routes -->|"queries"| node_post_model
node_post_routes -->|"uses"| node_user_model
node_post_routes -->|"authenticates"| node_auth_middleware
node_user_routes -->|"queries"| node_user_model
node_user_routes -->|"authenticates"| node_auth_middleware
node_message_routes -->|"queries"| node_message_model
node_message_routes -->|"uses"| node_user_model
node_message_routes -->|"authenticates"| node_auth_middleware
node_upload_routes -->|"authenticates"| node_auth_middleware
node_socket_ui -.->|"connects"| node_server
node_server -->|"serves files"| node_uploads

click node_app "https://github.com/wajih1234/social-app/blob/main/frontend/src/App.jsx"
click node_auth_ui "https://github.com/wajih1234/social-app/blob/main/frontend/src/context/AuthContext.jsx"
click node_login "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Login.jsx"
click node_signup "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Signup.jsx"
click node_verify "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/VerifyEmail.jsx"
click node_home "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Home.jsx"
click node_post_create "https://github.com/wajih1234/social-app/blob/main/frontend/src/components/CreatePost.jsx"
click node_post_card "https://github.com/wajih1234/social-app/blob/main/frontend/src/components/PostCard.jsx"
click node_profile "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Profile.jsx"
click node_search "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Search.jsx"
click node_settings "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Settings.jsx"
click node_messages "https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Messages.jsx"
click node_socket_ui "https://github.com/wajih1234/social-app/blob/main/frontend/src/context/SocketContext.jsx"
click node_api "https://github.com/wajih1234/social-app/blob/main/frontend/src/api.js"
click node_upload_ui "https://github.com/wajih1234/social-app/blob/main/frontend/src/uploadImage.js"
click node_server "https://github.com/wajih1234/social-app/blob/main/back/server.js"
click node_auth_routes "https://github.com/wajih1234/social-app/blob/main/back/routes/auth.js"
click node_auth_middleware "https://github.com/wajih1234/social-app/blob/main/back/middleware/auth.js"
click node_post_routes "https://github.com/wajih1234/social-app/blob/main/back/routes/posts.js"
click node_user_routes "https://github.com/wajih1234/social-app/blob/main/back/routes/users.js"
click node_message_routes "https://github.com/wajih1234/social-app/blob/main/back/routes/messages.js"
click node_upload_routes "https://github.com/wajih1234/social-app/blob/main/back/routes/upload.js"
click node_email "https://github.com/wajih1234/social-app/blob/main/back/utils/sendEmail.js"
click node_user_model "https://github.com/wajih1234/social-app/blob/main/back/models/User.js"
click node_post_model "https://github.com/wajih1234/social-app/blob/main/back/models/Post.js"
click node_message_model "https://github.com/wajih1234/social-app/blob/main/back/models/Message.js"
click node_uploads "https://github.com/wajih1234/social-app/tree/main/back/uploads"

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_api,node_upload_ui toneBlue
class node_auth_ui,node_login,node_signup,node_verify,node_auth_routes toneAmber
class node_home,node_post_create,node_post_card,node_profile,node_search,node_settings,node_messages,node_socket_ui toneMint
class node_server,node_auth_middleware,node_post_routes,node_user_routes,node_message_routes,node_upload_routes,node_email toneRose
class node_user_model,node_post_model,node_message_model,node_uploads,node_person toneIndigo
```

## Components

### Web client

- [App routing](https://github.com/wajih1234/social-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/wajih1234/social-app/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [Image upload client](https://github.com/wajih1234/social-app/blob/main/frontend/src/uploadImage.js): `frontend/src/uploadImage.js`

### Identity

- [Auth state](https://github.com/wajih1234/social-app/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Sign in](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Sign up](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Signup.jsx): `frontend/src/pages/Signup.jsx`
- [Email verification](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/VerifyEmail.jsx): `frontend/src/pages/VerifyEmail.jsx`
- [Auth routes](https://github.com/wajih1234/social-app/blob/main/back/routes/auth.js): `back/routes/auth.js`

### Social features

- [Home feed](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Post creation](https://github.com/wajih1234/social-app/blob/main/frontend/src/components/CreatePost.jsx): `frontend/src/components/CreatePost.jsx`
- [Post interactions](https://github.com/wajih1234/social-app/blob/main/frontend/src/components/PostCard.jsx): `frontend/src/components/PostCard.jsx`
- [Profiles](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [People search](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Search.jsx): `frontend/src/pages/Search.jsx`
- [Account settings](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Settings.jsx): `frontend/src/pages/Settings.jsx`
- [Messaging](https://github.com/wajih1234/social-app/blob/main/frontend/src/pages/Messages.jsx): `frontend/src/pages/Messages.jsx`
- [Socket client](https://github.com/wajih1234/social-app/blob/main/frontend/src/context/SocketContext.jsx): `frontend/src/context/SocketContext.jsx`

### Backend services

- [HTTP and socket server](https://github.com/wajih1234/social-app/blob/main/back/server.js): `back/server.js`
- [JWT middleware](https://github.com/wajih1234/social-app/blob/main/back/middleware/auth.js): `back/middleware/auth.js`
- [Post routes](https://github.com/wajih1234/social-app/blob/main/back/routes/posts.js): `back/routes/posts.js`
- [User routes](https://github.com/wajih1234/social-app/blob/main/back/routes/users.js): `back/routes/users.js`
- [Message routes](https://github.com/wajih1234/social-app/blob/main/back/routes/messages.js): `back/routes/messages.js`
- [Upload routes](https://github.com/wajih1234/social-app/blob/main/back/routes/upload.js): `back/routes/upload.js`
- [Email sender](https://github.com/wajih1234/social-app/blob/main/back/utils/sendEmail.js): `back/utils/sendEmail.js`

### Persistent data

- [User records](https://github.com/wajih1234/social-app/blob/main/back/models/User.js): `back/models/User.js`
- [Post records](https://github.com/wajih1234/social-app/blob/main/back/models/Post.js): `back/models/Post.js`
- [Message records](https://github.com/wajih1234/social-app/blob/main/back/models/Message.js): `back/models/Message.js`
- [Uploaded files](https://github.com/wajih1234/social-app/tree/main/back/uploads): `back/uploads`

### Other components

- **Member**

## Connections

- Member → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Auth state: checks access (evidence: `frontend/src/App.jsx`)
- App routing → Sign in: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Sign up: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Email verification: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Home feed: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Profiles: routes to (evidence: `frontend/src/App.jsx`)
- App routing → People search: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Account settings: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Messaging: routes to (evidence: `frontend/src/App.jsx`)
- Sign in → Auth state: uses (evidence: `frontend/src/pages/Login.jsx`)
- Sign up → Auth state: uses (evidence: `frontend/src/pages/Signup.jsx`)
- Auth state → API client: requests identity (evidence: `frontend/src/context/AuthContext.jsx`)
- Home feed → API client: loads feed (evidence: `frontend/src/pages/Home.jsx`)
- Home feed → Post creation: renders (evidence: `frontend/src/pages/Home.jsx`)
- Home feed → Post interactions: renders (evidence: `frontend/src/pages/Home.jsx`)
- Post creation → API client: creates post (evidence: `frontend/src/components/CreatePost.jsx`)
- Post creation → Image upload client: uploads image (evidence: `frontend/src/components/CreatePost.jsx`)
- Post interactions → API client: updates post (evidence: `frontend/src/components/PostCard.jsx`)
- People search → API client: searches users (evidence: `frontend/src/pages/Search.jsx`)
- Profiles → API client: loads profile (evidence: `frontend/src/pages/Profile.jsx`)
- Account settings → API client: updates account (evidence: `frontend/src/pages/Settings.jsx`)
- Messaging → API client: loads messages (evidence: `frontend/src/pages/Messages.jsx`)
- Messaging → Socket client: uses socket (evidence: `frontend/src/pages/Messages.jsx`)
- API client → HTTP and socket server: HTTP requests
- Image upload client → HTTP and socket server: upload request
- HTTP and socket server → Auth routes: mounts (evidence: `back/server.js`)
- HTTP and socket server → Post routes: mounts (evidence: `back/server.js`)
- HTTP and socket server → User routes: mounts (evidence: `back/server.js`)
- HTTP and socket server → Message routes: mounts (evidence: `back/server.js`)
- HTTP and socket server → Upload routes: mounts (evidence: `back/server.js`)
- Auth routes → User records: queries (evidence: `back/routes/auth.js`)
- Auth routes → JWT middleware: protects profile (evidence: `back/routes/auth.js`)
- Post routes → Post records: queries (evidence: `back/routes/posts.js`)
- Post routes → User records: uses (evidence: `back/routes/posts.js`)
- Post routes → JWT middleware: authenticates (evidence: `back/routes/posts.js`)
- User routes → User records: queries (evidence: `back/routes/users.js`)
- User routes → JWT middleware: authenticates (evidence: `back/routes/users.js`)
- Message routes → Message records: queries (evidence: `back/routes/messages.js`)
- Message routes → User records: uses (evidence: `back/routes/messages.js`)
- Message routes → JWT middleware: authenticates (evidence: `back/routes/messages.js`)
- Upload routes → JWT middleware: authenticates (evidence: `back/routes/upload.js`)
- Socket client → HTTP and socket server: connects
- HTTP and socket server → Uploaded files: serves files (evidence: `back/server.js`)
