# krishnaraipuria/video-platform-backend architecture

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

- Interactive diagram: https://gitdiagram.com/krishnaraipuria/video-platform-backend
- Repository: https://github.com/krishnaraipuria/video-platform-backend

## Overview

VideoTube is a video-sharing platform with a React client and an Express/MongoDB API. The user-facing workflow covers browsing and watching videos, managing an account, and using creator and community features; the API handles requests, authentication, domain operations, and persistence or media integrations. The graph preserves major README capabilities, but several feature implementations and frontend API call sites were not sampled, so some links are documented or left unverified rather than inferred from names.

Main entry points: [`frontend/src/App.jsx`](https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/App.jsx) (Client routes), [`src/routes/user.routes.js`](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/routes/user.routes.js) (Account routes), [`src/controllers/user.controllers.js`](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/user.controllers.js) (Account operations), [`src/models`](https://github.com/krishnaraipuria/video-platform-backend/tree/main/src/models) (MongoDB models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app_ui["Client routes<br/>[App.jsx]"]
  node_auth_ui["Account screens<br/>[Auth.jsx]"]
  node_watch_ui["Watch experience<br/>[Watch.jsx]"]
  node_other_pages["Channel and library"]
  node_creator_pages["Creator screens"]
  node_auth_state["Client auth state<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_api_server["Express API<br/>[app.js]"]
  node_user_routes["Account routes<br/>[user.routes.js]"]
  node_domain_routes["Feature routes"]
  node_auth_guard["JWT access guard<br/>[auth.middleware.js]"]
  node_rate_limits["Rate limiting"]
  node_accounts["Account operations"]
  node_email_ops["Email verification"]
  node_request_helpers["Response and errors<br/>[ApiResponse.js]"]
end

subgraph group_media["Video and creator"]
  node_video_ops["Video operations"]
  node_dashboard_ops["Creator dashboard"]
end

subgraph group_community["Community features"]
  node_community_ops["Social operations"]
end

subgraph group_platform["Data and integrations"]
  node_mongo[("MongoDB models")]
  node_redis[("Redis<br/>[redis.js]")]
  node_cloudinary["Cloudinary media<br/>[cloudinary.js]"]
end

node_viewer(("Viewer / creator"))
node_email_provider["Resend email"]

node_viewer -.->|"uses"| node_app_ui
node_app_ui -->|"routes to"| node_auth_ui
node_app_ui -->|"routes to"| node_watch_ui
node_app_ui -->|"routes to"| node_other_pages
node_app_ui -->|"routes to"| node_creator_pages
node_auth_state -->|"calls"| node_api_client
node_auth_ui -->|"calls"| node_api_client
node_api_server -->|"mounts"| node_user_routes
node_api_server -->|"mounts"| node_domain_routes
node_api_server -->|"applies"| node_rate_limits
node_user_routes -->|"dispatches"| node_accounts
node_user_routes -->|"applies"| node_auth_guard
node_user_routes -->|"applies"| node_rate_limits
node_domain_routes -.->|"uses"| node_auth_guard
node_domain_routes -.->|"dispatches"| node_video_ops
node_accounts -->|"reads and writes"| node_mongo
node_accounts -->|"uploads media"| node_cloudinary
node_video_ops -->|"reads and writes"| node_mongo
node_video_ops -->|"manages media"| node_cloudinary
node_community_ops -.->|"reads and writes"| node_mongo
node_dashboard_ops -.->|"aggregates data"| node_mongo
node_email_ops -.->|"stores codes"| node_redis
node_email_ops -.->|"sends codes"| node_email_provider
node_rate_limits -->|"uses"| node_redis
node_accounts -->|"returns responses"| node_request_helpers

click node_app_ui "https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/App.jsx"
click node_auth_ui "https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/pages/Auth.jsx"
click node_watch_ui "https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/pages/Watch.jsx"
click node_other_pages "https://github.com/krishnaraipuria/video-platform-backend/tree/main/frontend/src/pages"
click node_creator_pages "https://github.com/krishnaraipuria/video-platform-backend/tree/main/frontend/src/pages"
click node_auth_state "https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/lib/api.js"
click node_api_server "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/app.js"
click node_user_routes "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/routes/user.routes.js"
click node_domain_routes "https://github.com/krishnaraipuria/video-platform-backend/tree/main/src/routes"
click node_auth_guard "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/middlewares/auth.middleware.js"
click node_rate_limits "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/middlewares/ratelimiter.middleware.js"
click node_accounts "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/user.controllers.js"
click node_video_ops "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/video.controllers.js"
click node_dashboard_ops "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/dashboard.controllers.js"
click node_community_ops "https://github.com/krishnaraipuria/video-platform-backend/tree/main/src/controllers"
click node_email_ops "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/emailVerification.controllers.js"
click node_mongo "https://github.com/krishnaraipuria/video-platform-backend/tree/main/src/models"
click node_redis "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/config/redis.js"
click node_cloudinary "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/utils/cloudinary.js"
click node_request_helpers "https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/utils/ApiResponse.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_ui,node_auth_ui,node_watch_ui,node_other_pages,node_creator_pages,node_auth_state,node_api_client,node_viewer toneBlue
class node_api_server,node_user_routes,node_domain_routes,node_auth_guard,node_rate_limits,node_accounts,node_email_ops,node_request_helpers toneAmber
class node_video_ops,node_dashboard_ops toneMint
class node_community_ops toneRose
class node_mongo,node_redis,node_cloudinary,node_email_provider toneIndigo
```

## Components

### Web client

- [Client routes](https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Account screens](https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/pages/Auth.jsx): `frontend/src/pages/Auth.jsx`
- [Watch experience](https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/pages/Watch.jsx): `frontend/src/pages/Watch.jsx`
- [Channel and library](https://github.com/krishnaraipuria/video-platform-backend/tree/main/frontend/src/pages): `frontend/src/pages`
- [Creator screens](https://github.com/krishnaraipuria/video-platform-backend/tree/main/frontend/src/pages): `frontend/src/pages`
- [Client auth state](https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/krishnaraipuria/video-platform-backend/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`

### API and access

- [Express API](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/app.js): `src/app.js`
- [Account routes](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/routes/user.routes.js): `src/routes/user.routes.js`
- [Feature routes](https://github.com/krishnaraipuria/video-platform-backend/tree/main/src/routes): `src/routes`
- [JWT access guard](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/middlewares/auth.middleware.js): `src/middlewares/auth.middleware.js`
- [Rate limiting](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/middlewares/ratelimiter.middleware.js): `src/middlewares/ratelimiter.middleware.js`
- [Account operations](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/user.controllers.js): `src/controllers/user.controllers.js`
- [Email verification](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/emailVerification.controllers.js): `src/controllers/emailVerification.controllers.js`
- [Response and errors](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/utils/ApiResponse.js): `src/utils/ApiResponse.js`

### Video and creator

- [Video operations](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/video.controllers.js): `src/controllers/video.controllers.js`
- [Creator dashboard](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/controllers/dashboard.controllers.js): `src/controllers/dashboard.controllers.js`

### Community features

- [Social operations](https://github.com/krishnaraipuria/video-platform-backend/tree/main/src/controllers): `src/controllers`

### Data and integrations

- [MongoDB models](https://github.com/krishnaraipuria/video-platform-backend/tree/main/src/models): `src/models`
- [Redis](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/config/redis.js): `src/config/redis.js`
- [Cloudinary media](https://github.com/krishnaraipuria/video-platform-backend/blob/main/src/utils/cloudinary.js): `src/utils/cloudinary.js`

### Other components

- **Viewer / creator**
- **Resend email**

## Connections

- Viewer / creator → Client routes: uses
- Client routes → Account screens: routes to (evidence: `frontend/src/App.jsx`)
- Client routes → Watch experience: routes to (evidence: `frontend/src/App.jsx`)
- Client routes → Channel and library: routes to (evidence: `frontend/src/App.jsx`)
- Client routes → Creator screens: routes to (evidence: `frontend/src/App.jsx`)
- Client auth state → API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Account screens → API client: calls (evidence: `frontend/src/pages/Auth.jsx`)
- Express API → Account routes: mounts (evidence: `src/app.js`)
- Express API → Feature routes: mounts (evidence: `src/app.js`)
- Express API → Rate limiting: applies (evidence: `src/app.js`)
- Account routes → Account operations: dispatches (evidence: `src/routes/user.routes.js`)
- Account routes → JWT access guard: applies (evidence: `src/routes/user.routes.js`)
- Account routes → Rate limiting: applies (evidence: `src/routes/user.routes.js`)
- Feature routes → JWT access guard: uses (evidence: `src/routes/user.routes.js`)
- Feature routes → Video operations: dispatches (evidence: `src/routes/video.routes.js`)
- Account operations → MongoDB models: reads and writes (evidence: `src/controllers/user.controllers.js`)
- Account operations → Cloudinary media: uploads media (evidence: `src/controllers/user.controllers.js`)
- Video operations → MongoDB models: reads and writes (evidence: `src/controllers/video.controllers.js`)
- Video operations → Cloudinary media: manages media (evidence: `src/controllers/video.controllers.js`)
- Social operations → MongoDB models: reads and writes (evidence: `src/controllers/user.controllers.js`)
- Creator dashboard → MongoDB models: aggregates data
- Email verification → Redis: stores codes
- Email verification → Resend email: sends codes
- Rate limiting → Redis: uses (evidence: `src/middlewares/ratelimiter.middleware.js`)
- Account operations → Response and errors: returns responses (evidence: `src/controllers/user.controllers.js`)
