# begleee/social-media-platform architecture

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

- Interactive diagram: https://gitdiagram.com/begleee/social-media-platform
- Repository: https://github.com/begleee/social-media-platform

## Overview

This is a full-stack social platform: users register or sign in, enter protected pages, browse a feed and profiles, and create or interact with posts. The client’s router and feature components lead into query hooks and an Axios service; the Express server dispatches requests to domain routes and controllers. The sampled post, auth, and user controllers show Prisma-backed operations, while README and route/index references establish additional feed, follow, like, comment, and media capabilities. Some subsystem internals were not sampled, so their links are limited to documented or indexed wiring.

Main entry points: [`server/src/server.js`](https://github.com/begleee/social-media-platform/blob/main/server/src/server.js) (Express server), [`client/src/main.jsx`](https://github.com/begleee/social-media-platform/blob/main/client/src/main.jsx) (Client router), [`server/src/middlewares/authMiddleware.js`](https://github.com/begleee/social-media-platform/blob/main/server/src/middlewares/authMiddleware.js) (JWT authorization), [`server/src/controllers/postControllers.js`](https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/postControllers.js) (Post operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_router["Client router<br/>[main.jsx]"]
  node_protected["Protected pages<br/>[ProtectedRoute.jsx]"]
  node_feedui["Feed views<br/>[FeedContent.jsx]"]
  node_postui["Post views<br/>[PostCard.jsx]"]
  node_profileui["Profile posts<br/>[UserPosts.jsx]"]
  node_createui["Post composer<br/>[CreatePostForm.jsx]"]
  node_queryhooks["Query hooks<br/>[usePosts.js]"]
  node_api["HTTP client<br/>[api.js]"]
end

subgraph group_auth["Identity and access"]
  node_authui["Auth forms<br/>[LoginForm.jsx]"]
  node_authstate["Auth state<br/>[authStore.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth operations<br/>[authController.js]"]
  node_guard["JWT authorization<br/>[authMiddleware.js]"]
end

subgraph group_social["Social content"]
  node_socialroutes["Social routes<br/>[postRoutes.js]"]
  node_posts["Post operations<br/>[postControllers.js]"]
  node_feedroutes["Feed routes<br/>[feedRoutes.js]"]
  node_feedcontroller["Feed operations<br/>[feedController.js]"]
  node_socialroutes_extra["Social action routes<br/>[commentRoutes.js]"]
  node_commentcontroller["Comment operations"]
  node_followroutes["Follow routes<br/>[followRoutes.js]"]
  node_likeroutes["Like routes<br/>[likeRoutes.js]"]
end

subgraph group_media["Media management"]
  node_imageroutes["Image routes<br/>[imageRoutes.js]"]
  node_upload["Upload middleware"]
  node_imagecontroller["Image operations<br/>[imageController.js]"]
  node_fileutils["Upload utility<br/>[filesUtils.js]"]
end

subgraph group_platform["Server and persistence"]
  node_server["Express server<br/>[server.js]"]
  node_userops["User operations<br/>[userControllers.js]"]
  node_usersroutes["User routes<br/>[userRoutes.js]"]
end

node_visitor(("User"))
node_cloudinary[("Cloudinary")]
node_database[("PostgreSQL")]

node_visitor -->|"navigates"| node_router
node_router -->|"routes protected paths"| node_protected
node_router -->|"routes auth pages"| node_authui
node_router -->|"routes feed page"| node_feedui
node_router -->|"routes composer page"| node_createui
node_router -->|"routes post detail"| node_postui
node_router -->|"routes profile page"| node_profileui
node_protected -->|"checks session"| node_authstate
node_createui -.->|"creates posts"| node_queryhooks
node_postui -->|"loads post data"| node_queryhooks
node_queryhooks -->|"sends requests"| node_api
node_authui -.->|"updates session"| node_authstate
node_api -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_socialroutes
node_server -->|"mounts routes"| node_feedroutes
node_server -->|"mounts routes"| node_socialroutes_extra
node_server -->|"mounts routes"| node_followroutes
node_server -->|"mounts routes"| node_likeroutes
node_server -->|"mounts routes"| node_imageroutes
node_server -->|"mounts routes"| node_usersroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_socialroutes -->|"dispatches"| node_posts
node_socialroutes -->|"checks access"| node_guard
node_feedroutes -->|"dispatches"| node_feedcontroller
node_socialroutes_extra -->|"dispatches"| node_commentcontroller
node_socialroutes_extra -->|"checks access"| node_guard
node_followroutes -->|"checks access"| node_guard
node_likeroutes -->|"checks access"| node_guard
node_imageroutes -->|"processes uploads"| node_upload
node_imageroutes -->|"dispatches"| node_imagecontroller
node_imagecontroller -->|"uses upload helpers"| node_fileutils
node_usersroutes -->|"dispatches"| node_userops
node_usersroutes -->|"checks access"| node_guard
node_posts -->|"prepares uploads"| node_fileutils
node_posts -.->|"uploads media"| node_cloudinary
node_posts -->|"reads and writes"| node_database
node_authcontroller -->|"reads and writes"| node_database
node_authcontroller -.->|"returns credentials"| node_authstate
node_userops -->|"reads and writes"| node_database
node_server -->|"configures service"| node_cloudinary

click node_router "https://github.com/begleee/social-media-platform/blob/main/client/src/main.jsx"
click node_protected "https://github.com/begleee/social-media-platform/blob/main/client/src/components/ProtectedRoute.jsx"
click node_feedui "https://github.com/begleee/social-media-platform/blob/main/client/src/components/feed/FeedContent.jsx"
click node_postui "https://github.com/begleee/social-media-platform/blob/main/client/src/components/post/PostCard.jsx"
click node_profileui "https://github.com/begleee/social-media-platform/blob/main/client/src/components/profile/UserPosts.jsx"
click node_createui "https://github.com/begleee/social-media-platform/blob/main/client/src/components/create_post/CreatePostForm.jsx"
click node_queryhooks "https://github.com/begleee/social-media-platform/blob/main/client/src/hooks/usePosts.js"
click node_api "https://github.com/begleee/social-media-platform/blob/main/client/src/services/api.js"
click node_authui "https://github.com/begleee/social-media-platform/blob/main/client/src/components/auth/LoginForm.jsx"
click node_authstate "https://github.com/begleee/social-media-platform/blob/main/client/src/store/authStore.js"
click node_authroutes "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/authRoutes.js"
click node_authcontroller "https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/authController.js"
click node_guard "https://github.com/begleee/social-media-platform/blob/main/server/src/middlewares/authMiddleware.js"
click node_socialroutes "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/postRoutes.js"
click node_posts "https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/postControllers.js"
click node_feedroutes "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/feedRoutes.js"
click node_feedcontroller "https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/feedController.js"
click node_socialroutes_extra "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/commentRoutes.js"
click node_commentcontroller "https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/commentController.js"
click node_followroutes "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/followRoutes.js"
click node_likeroutes "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/likeRoutes.js"
click node_imageroutes "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/imageRoutes.js"
click node_upload "https://github.com/begleee/social-media-platform/blob/main/server/src/middlewares/uploadMiddleware.js"
click node_imagecontroller "https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/imageController.js"
click node_fileutils "https://github.com/begleee/social-media-platform/blob/main/server/src/utils/filesUtils.js"
click node_server "https://github.com/begleee/social-media-platform/blob/main/server/src/server.js"
click node_userops "https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/userControllers.js"
click node_usersroutes "https://github.com/begleee/social-media-platform/blob/main/server/src/routes/userRoutes.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_router,node_protected,node_feedui,node_postui,node_profileui,node_createui,node_queryhooks,node_api,node_visitor toneBlue
class node_authui,node_authstate,node_authroutes,node_authcontroller,node_guard,node_cloudinary,node_database toneAmber
class node_socialroutes,node_posts,node_feedroutes,node_feedcontroller,node_socialroutes_extra,node_commentcontroller,node_followroutes,node_likeroutes toneMint
class node_imageroutes,node_upload,node_imagecontroller,node_fileutils toneRose
class node_server,node_userops,node_usersroutes toneIndigo
```

## Components

### Client experience

- [Client router](https://github.com/begleee/social-media-platform/blob/main/client/src/main.jsx): `client/src/main.jsx`
- [Protected pages](https://github.com/begleee/social-media-platform/blob/main/client/src/components/ProtectedRoute.jsx): `client/src/components/ProtectedRoute.jsx`
- [Feed views](https://github.com/begleee/social-media-platform/blob/main/client/src/components/feed/FeedContent.jsx): `client/src/components/feed/FeedContent.jsx`
- [Post views](https://github.com/begleee/social-media-platform/blob/main/client/src/components/post/PostCard.jsx): `client/src/components/post/PostCard.jsx`
- [Profile posts](https://github.com/begleee/social-media-platform/blob/main/client/src/components/profile/UserPosts.jsx): `client/src/components/profile/UserPosts.jsx`
- [Post composer](https://github.com/begleee/social-media-platform/blob/main/client/src/components/create_post/CreatePostForm.jsx): `client/src/components/create_post/CreatePostForm.jsx`
- [Query hooks](https://github.com/begleee/social-media-platform/blob/main/client/src/hooks/usePosts.js): `client/src/hooks/usePosts.js`
- [HTTP client](https://github.com/begleee/social-media-platform/blob/main/client/src/services/api.js): `client/src/services/api.js`

### Identity and access

- [Auth forms](https://github.com/begleee/social-media-platform/blob/main/client/src/components/auth/LoginForm.jsx): `client/src/components/auth/LoginForm.jsx`
- [Auth state](https://github.com/begleee/social-media-platform/blob/main/client/src/store/authStore.js): `client/src/store/authStore.js`
- [Auth routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Auth operations](https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [JWT authorization](https://github.com/begleee/social-media-platform/blob/main/server/src/middlewares/authMiddleware.js): `server/src/middlewares/authMiddleware.js`

### Social content

- [Social routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/postRoutes.js): `server/src/routes/postRoutes.js`
- [Post operations](https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/postControllers.js): `server/src/controllers/postControllers.js`
- [Feed routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/feedRoutes.js): `server/src/routes/feedRoutes.js`
- [Feed operations](https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/feedController.js): `server/src/controllers/feedController.js`
- [Social action routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/commentRoutes.js): `server/src/routes/commentRoutes.js`
- [Comment operations](https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/commentController.js): `server/src/controllers/commentController.js`
- [Follow routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/followRoutes.js): `server/src/routes/followRoutes.js`
- [Like routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/likeRoutes.js): `server/src/routes/likeRoutes.js`

### Media management

- [Image routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/imageRoutes.js): `server/src/routes/imageRoutes.js`
- [Upload middleware](https://github.com/begleee/social-media-platform/blob/main/server/src/middlewares/uploadMiddleware.js): `server/src/middlewares/uploadMiddleware.js`
- [Image operations](https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/imageController.js): `server/src/controllers/imageController.js`
- [Upload utility](https://github.com/begleee/social-media-platform/blob/main/server/src/utils/filesUtils.js): `server/src/utils/filesUtils.js`

### Server and persistence

- [Express server](https://github.com/begleee/social-media-platform/blob/main/server/src/server.js): `server/src/server.js`
- [User operations](https://github.com/begleee/social-media-platform/blob/main/server/src/controllers/userControllers.js): `server/src/controllers/userControllers.js`
- [User routes](https://github.com/begleee/social-media-platform/blob/main/server/src/routes/userRoutes.js): `server/src/routes/userRoutes.js`

### Other components

- **User**
- **Cloudinary**
- **PostgreSQL**

## Connections

- User → Client router: navigates (evidence: `client/src/main.jsx`)
- Client router → Protected pages: routes protected paths (evidence: `client/src/main.jsx`)
- Client router → Auth forms: routes auth pages (evidence: `client/src/main.jsx`)
- Client router → Feed views: routes feed page (evidence: `client/src/main.jsx`)
- Client router → Post composer: routes composer page (evidence: `client/src/main.jsx`)
- Client router → Post views: routes post detail (evidence: `client/src/main.jsx`)
- Client router → Profile posts: routes profile page (evidence: `client/src/main.jsx`)
- Protected pages → Auth state: checks session (evidence: `client/src/components/ProtectedRoute.jsx`)
- Post composer → Query hooks: creates posts
- Post views → Query hooks: loads post data (evidence: `client/src/pages/PostDetailsPage.jsx`)
- Query hooks → HTTP client: sends requests (evidence: `client/src/hooks/usePosts.js`)
- Auth forms → Auth state: updates session
- HTTP client → Express server: calls API
- Express server → Auth routes: mounts routes (evidence: `server/src/server.js`)
- Express server → Social routes: mounts routes (evidence: `server/src/server.js`)
- Express server → Feed routes: mounts routes (evidence: `server/src/server.js`)
- Express server → Social action routes: mounts routes (evidence: `server/src/server.js`)
- Express server → Follow routes: mounts routes (evidence: `server/src/server.js`)
- Express server → Like routes: mounts routes (evidence: `server/src/server.js`)
- Express server → Image routes: mounts routes (evidence: `server/src/server.js`)
- Express server → User routes: mounts routes (evidence: `server/src/server.js`)
- Auth routes → Auth operations: dispatches (evidence: `server/src/routes/authRoutes.js`)
- Social routes → Post operations: dispatches (evidence: `server/src/routes/postRoutes.js`)
- Social routes → JWT authorization: checks access (evidence: `server/src/routes/postRoutes.js`)
- Feed routes → Feed operations: dispatches (evidence: `server/src/routes/feedRoutes.js`)
- Social action routes → Comment operations: dispatches (evidence: `server/src/routes/commentRoutes.js`)
- Social action routes → JWT authorization: checks access (evidence: `server/src/routes/commentRoutes.js`)
- Follow routes → JWT authorization: checks access (evidence: `server/src/routes/followRoutes.js`)
- Like routes → JWT authorization: checks access (evidence: `server/src/routes/likeRoutes.js`)
- Image routes → Upload middleware: processes uploads (evidence: `server/src/routes/imageRoutes.js`)
- Image routes → Image operations: dispatches (evidence: `server/src/routes/imageRoutes.js`)
- Image operations → Upload utility: uses upload helpers (evidence: `server/src/controllers/imageController.js`)
- User routes → User operations: dispatches (evidence: `server/src/routes/userRoutes.js`)
- User routes → JWT authorization: checks access (evidence: `server/src/routes/userRoutes.js`)
- Post operations → Upload utility: prepares uploads (evidence: `server/src/controllers/postControllers.js`)
- Post operations → Cloudinary: uploads media
- Post operations → PostgreSQL: reads and writes (evidence: `server/src/controllers/postControllers.js`)
- Auth operations → PostgreSQL: reads and writes (evidence: `server/src/controllers/authController.js`)
- Auth operations → Auth state: returns credentials
- User operations → PostgreSQL: reads and writes (evidence: `server/src/controllers/userControllers.js`)
- Express server → Cloudinary: configures service (evidence: `server/src/server.js`)
