# karanx64/scenely architecture

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

## Overview

Scenely is a cinephile/otaku social platform for sharing media screenshots, discovering posts and users, following profiles, and messaging without comments. The main journey runs from account access through the protected app to browsing or uploading a post; profile and messaging are separate product branches. The server mounts the API route families, which operate on MongoDB models and use Cloudinary for image storage. Frontend-to-API links are dashed because the sampled evidence does not establish those calls; several capabilities are documented or indexed but their implementation was not sampled.

Main entry points: [`frontend/src/App.jsx`](https://github.com/karanx64/scenely/blob/main/frontend/src/App.jsx) (Routes and layout), [`backend/server.js`](https://github.com/karanx64/scenely/blob/main/backend/server.js) (Express server), [`backend/routes/user.js`](https://github.com/karanx64/scenely/blob/main/backend/routes/user.js) (User API), [`backend/routes/posts.js`](https://github.com/karanx64/scenely/blob/main/backend/routes/posts.js) (Posts API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_app["Routes and layout<br/>[App.jsx]"]
  node_authpages["Sign in / register<br/>[Login.jsx]"]
end

subgraph group_social["Social features"]
  node_feed["Home feed<br/>[Home.jsx]"]
  node_explore["Explore<br/>[Explore.jsx]"]
  node_upload["Post upload<br/>[UploadForm.jsx]"]
  node_profiles["Profiles and follows<br/>[Profile.jsx]"]
  node_messages["Direct messages<br/>[Messages.jsx]"]
  node_postlist["Post presentation<br/>[PostList.jsx]"]
end

subgraph group_api["API services"]
  node_authroutes["Authentication API<br/>[auth.js]"]
  node_postroutes["Posts API<br/>[posts.js]"]
  node_uploadroutes["Upload API<br/>[upload.js]"]
  node_userroutes["User API<br/>[user.js]"]
  node_messageroutes["Messages API<br/>[message.js]"]
  node_authmw["Token verification<br/>[auth.js]"]
  node_server["Express server<br/>[server.js]"]
end

subgraph group_data["Persistence and media"]
  node_user["User records<br/>[User.js]"]
  node_post["Post records<br/>[Post.js]"]
  node_message["Message records<br/>[Message.js]"]
  node_cloudinary["Image storage adapter<br/>[cloudinary.js]"]
end

node_visitor(("Scenely user"))
node_mongodb[("MongoDB")]
node_cloudservice["Cloudinary"]

node_visitor -->|"opens app"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_feed
node_app -->|"routes to"| node_explore
node_app -->|"routes to"| node_upload
node_app -->|"routes to"| node_profiles
node_app -->|"routes to"| node_messages
node_feed -->|"renders"| node_postlist
node_explore -->|"renders"| node_postlist
node_profiles -->|"renders"| node_postlist
node_profiles -.->|"requests data"| node_userroutes
node_feed -.->|"requests posts"| node_postroutes
node_explore -.->|"requests posts"| node_postroutes
node_upload -.->|"submits media"| node_uploadroutes
node_messages -.->|"requests messages"| node_messageroutes
node_authpages -.->|"submits credentials"| node_authroutes
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_postroutes
node_server -->|"mounts"| node_uploadroutes
node_server -->|"mounts"| node_userroutes
node_server -->|"mounts"| node_messageroutes
node_server -->|"connects"| node_mongodb
node_authroutes -->|"reads / writes"| node_user
node_postroutes -->|"uses posts"| node_post
node_userroutes -->|"reads / writes"| node_user
node_userroutes -->|"manages posts"| node_post
node_messageroutes -->|"uses messages"| node_message
node_authroutes -->|"verifies token"| node_authmw
node_userroutes -->|"verifies token"| node_authmw
node_postroutes -->|"verifies token"| node_authmw
node_uploadroutes -->|"verifies token"| node_authmw
node_messageroutes -->|"verifies token"| node_authmw
node_uploadroutes -->|"uses storage"| node_cloudinary
node_postroutes -->|"uses media service"| node_cloudinary
node_userroutes -->|"deletes media"| node_cloudinary
node_cloudinary -->|"uploads / deletes"| node_cloudservice

click node_app "https://github.com/karanx64/scenely/blob/main/frontend/src/App.jsx"
click node_authpages "https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Login.jsx"
click node_feed "https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Home.jsx"
click node_explore "https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Explore.jsx"
click node_upload "https://github.com/karanx64/scenely/blob/main/frontend/src/components/UploadForm.jsx"
click node_profiles "https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Profile.jsx"
click node_messages "https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Messages.jsx"
click node_postlist "https://github.com/karanx64/scenely/blob/main/frontend/src/components/PostList.jsx"
click node_authroutes "https://github.com/karanx64/scenely/blob/main/backend/routes/auth.js"
click node_postroutes "https://github.com/karanx64/scenely/blob/main/backend/routes/posts.js"
click node_uploadroutes "https://github.com/karanx64/scenely/blob/main/backend/routes/upload.js"
click node_userroutes "https://github.com/karanx64/scenely/blob/main/backend/routes/user.js"
click node_messageroutes "https://github.com/karanx64/scenely/blob/main/backend/routes/message.js"
click node_authmw "https://github.com/karanx64/scenely/blob/main/backend/middleware/auth.js"
click node_server "https://github.com/karanx64/scenely/blob/main/backend/server.js"
click node_user "https://github.com/karanx64/scenely/blob/main/backend/models/User.js"
click node_post "https://github.com/karanx64/scenely/blob/main/backend/models/Post.js"
click node_message "https://github.com/karanx64/scenely/blob/main/backend/models/Message.js"
click node_cloudinary "https://github.com/karanx64/scenely/blob/main/backend/utils/cloudinary.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_authpages,node_visitor toneBlue
class node_feed,node_explore,node_upload,node_profiles,node_messages,node_postlist,node_mongodb toneAmber
class node_authroutes,node_postroutes,node_uploadroutes,node_userroutes,node_messageroutes,node_authmw,node_server toneMint
class node_user,node_post,node_message,node_cloudinary toneRose
class node_cloudservice toneIndigo
```

## Components

### Web experience

- [Routes and layout](https://github.com/karanx64/scenely/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign in / register](https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`

### Social features

- [Home feed](https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Explore](https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Explore.jsx): `frontend/src/pages/Explore.jsx`
- [Post upload](https://github.com/karanx64/scenely/blob/main/frontend/src/components/UploadForm.jsx): `frontend/src/components/UploadForm.jsx`
- [Profiles and follows](https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [Direct messages](https://github.com/karanx64/scenely/blob/main/frontend/src/pages/Messages.jsx): `frontend/src/pages/Messages.jsx`
- [Post presentation](https://github.com/karanx64/scenely/blob/main/frontend/src/components/PostList.jsx): `frontend/src/components/PostList.jsx`

### API services

- [Authentication API](https://github.com/karanx64/scenely/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Posts API](https://github.com/karanx64/scenely/blob/main/backend/routes/posts.js): `backend/routes/posts.js`
- [Upload API](https://github.com/karanx64/scenely/blob/main/backend/routes/upload.js): `backend/routes/upload.js`
- [User API](https://github.com/karanx64/scenely/blob/main/backend/routes/user.js): `backend/routes/user.js`
- [Messages API](https://github.com/karanx64/scenely/blob/main/backend/routes/message.js): `backend/routes/message.js`
- [Token verification](https://github.com/karanx64/scenely/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Express server](https://github.com/karanx64/scenely/blob/main/backend/server.js): `backend/server.js`

### Persistence and media

- [User records](https://github.com/karanx64/scenely/blob/main/backend/models/User.js): `backend/models/User.js`
- [Post records](https://github.com/karanx64/scenely/blob/main/backend/models/Post.js): `backend/models/Post.js`
- [Message records](https://github.com/karanx64/scenely/blob/main/backend/models/Message.js): `backend/models/Message.js`
- [Image storage adapter](https://github.com/karanx64/scenely/blob/main/backend/utils/cloudinary.js): `backend/utils/cloudinary.js`

### Other components

- **Scenely user**
- **MongoDB**
- **Cloudinary**

## Connections

- Scenely user → Routes and layout: opens app (evidence: `README.md`)
- Routes and layout → Sign in / register: routes to (evidence: `frontend/src/App.jsx`)
- Routes and layout → Home feed: routes to (evidence: `frontend/src/App.jsx`)
- Routes and layout → Explore: routes to (evidence: `frontend/src/App.jsx`)
- Routes and layout → Post upload: routes to (evidence: `frontend/src/App.jsx`)
- Routes and layout → Profiles and follows: routes to (evidence: `frontend/src/App.jsx`)
- Routes and layout → Direct messages: routes to (evidence: `frontend/src/App.jsx`)
- Home feed → Post presentation: renders (evidence: `frontend/src/pages/Home.jsx`)
- Explore → Post presentation: renders (evidence: `frontend/src/pages/Explore.jsx`)
- Profiles and follows → Post presentation: renders (evidence: `frontend/src/pages/Profile.jsx`)
- Profiles and follows → User API: requests data
- Home feed → Posts API: requests posts
- Explore → Posts API: requests posts
- Post upload → Upload API: submits media
- Direct messages → Messages API: requests messages
- Sign in / register → Authentication API: submits credentials
- Express server → Authentication API: mounts (evidence: `backend/server.js`)
- Express server → Posts API: mounts (evidence: `backend/server.js`)
- Express server → Upload API: mounts (evidence: `backend/server.js`)
- Express server → User API: mounts (evidence: `backend/server.js`)
- Express server → Messages API: mounts (evidence: `backend/server.js`)
- Express server → MongoDB: connects (evidence: `backend/server.js`)
- Authentication API → User records: reads / writes (evidence: `backend/routes/auth.js`)
- Posts API → Post records: uses posts (evidence: `backend/routes/posts.js`)
- User API → User records: reads / writes (evidence: `backend/routes/user.js`)
- User API → Post records: manages posts (evidence: `backend/routes/user.js`)
- Messages API → Message records: uses messages (evidence: `backend/routes/message.js`)
- Authentication API → Token verification: verifies token (evidence: `backend/routes/auth.js`)
- User API → Token verification: verifies token (evidence: `backend/routes/user.js`)
- Posts API → Token verification: verifies token (evidence: `backend/routes/posts.js`)
- Upload API → Token verification: verifies token (evidence: `backend/routes/upload.js`)
- Messages API → Token verification: verifies token (evidence: `backend/routes/message.js`)
- Upload API → Image storage adapter: uses storage (evidence: `backend/routes/upload.js`)
- Posts API → Image storage adapter: uses media service (evidence: `backend/routes/posts.js`)
- User API → Image storage adapter: deletes media (evidence: `backend/routes/user.js`)
- Image storage adapter → Cloudinary: uploads / deletes
