# shubhampal24/arena architecture

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

- Interactive diagram: https://gitdiagram.com/shubhampal24/arena
- Repository: https://github.com/shubhampal24/arena

## Overview

ArenaX is a React and Express platform for gaming careers and community. Gamers and organizations register, build profiles, discover talent or vacancies, and participate in the application pipeline; users also publish community posts. The frontend API client connects these experiences to backend routes and domain controllers, which read and update MongoDB-backed models. The README documents media uploads through Cloudinary. Some controller and page files were not excerpted, so their internal calls are omitted where the available evidence does not establish them.

Main entry points: [`frontend/src/utils/api.js`](https://github.com/shubhampal24/arena/blob/main/frontend/src/utils/api.js) (API client), [`backend/src/index.js`](https://github.com/shubhampal24/arena/blob/main/backend/src/index.js) (Express API), [`backend/src/controllers/searchController.js`](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/searchController.js) (Search API), [`backend/src/models/Organization.js`](https://github.com/shubhampal24/arena/blob/main/backend/src/models/Organization.js) (Organization records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_app["Routes and guards<br/>[App.js]"]
  node_clientapi["API client<br/>[api.js]"]
end

subgraph group_identity["Accounts and profiles"]
  node_authstate["Auth state<br/>[AuthContext.js]"]
  node_authpages["Login and registration"]
  node_profiles["Gaming profiles<br/>[Profile.js]"]
  node_orgprofiles["Organization profiles<br/>[OrgProfile.js]"]
  node_profileedit["Profile editor<br/>[EditProfile.js]"]
  node_authcontroller["Authentication<br/>[authController.js]"]
  node_usercontroller["User profiles<br/>[userController.js]"]
  node_orgcontroller["Organization profiles<br/>[orgController.js]"]
end

subgraph group_community["Community and discovery"]
  node_feed["Community feed<br/>[Feed.js]"]
  node_discover["Talent discovery<br/>[Discover.js]"]
  node_search["Search API"]
  node_postcontroller["Feed operations<br/>[postController.js]"]
end

subgraph group_careers["Hiring workflow"]
  node_jobs["Job board<br/>[Jobs.js]"]
  node_jobdetail["Job details<br/>[JobDetail.js]"]
  node_apply["Job application<br/>[Apply.js]"]
  node_postjob["Job posting<br/>[PostJob.js]"]
  node_dashboards["Role dashboards<br/>[Dashboard.js]"]
  node_orgdashboard["Organization dashboard<br/>[OrgDashboard.js]"]
  node_jobcontroller["Job operations<br/>[jobController.js]"]
  node_applicationcontroller["Application pipeline"]
end

subgraph group_platform["API and persistence"]
  node_server["Express API<br/>[index.js]"]
  node_uploadcontroller["Media uploads"]
  node_userstore[("User records<br/>[User.js]")]
  node_orgstore[("Organization records<br/>[Organization.js]")]
  node_jobstore[("Job records<br/>[Job.js]")]
  node_poststore[("Post records<br/>[Post.js]")]
  node_applicationstore[("Application records<br/>[Application.js]")]
end

node_gamers(("Gamers and creators"))
node_organizations(("Esports organizations"))
node_mongodb[("MongoDB")]
node_cloudinary["Cloudinary"]

node_gamers -->|"use"| node_app
node_organizations -->|"use"| node_app
node_app -->|"provides auth"| node_authstate
node_authpages -->|"updates session"| node_authstate
node_authstate -->|"loads identity"| node_clientapi
node_profiles -->|"requests profile"| node_clientapi
node_orgprofiles -->|"requests profile"| node_clientapi
node_profileedit -.->|"updates profile"| node_clientapi
node_feed -->|"requests feed"| node_clientapi
node_discover -->|"searches talent"| node_clientapi
node_jobs -.->|"requests jobs"| node_clientapi
node_jobdetail -.->|"loads vacancy"| node_clientapi
node_apply -.->|"submits application"| node_clientapi
node_postjob -->|"creates vacancy"| node_clientapi
node_dashboards -.->|"loads dashboard"| node_clientapi
node_orgdashboard -->|"loads dashboard"| node_clientapi
node_clientapi -->|"calls REST"| node_server
node_server -->|"routes auth"| node_authcontroller
node_server -->|"routes users"| node_usercontroller
node_server -->|"routes organizations"| node_orgcontroller
node_server -->|"routes posts"| node_postcontroller
node_server -->|"routes jobs"| node_jobcontroller
node_server -->|"routes applications"| node_applicationcontroller
node_server -->|"routes search"| node_search
node_server -->|"routes uploads"| node_uploadcontroller
node_authcontroller -->|"reads and writes"| node_userstore
node_authcontroller -->|"reads and writes"| node_orgstore
node_usercontroller -->|"updates records"| node_userstore
node_orgcontroller -->|"updates records"| node_orgstore
node_postcontroller -->|"manages posts"| node_poststore
node_jobcontroller -->|"reads and writes"| node_jobstore
node_jobcontroller -->|"updates job counts"| node_orgstore
node_applicationcontroller -->|"manages applications"| node_applicationstore
node_applicationcontroller -->|"checks vacancies"| node_jobstore
node_search -->|"searches"| node_userstore
node_search -->|"searches"| node_orgstore
node_search -->|"searches"| node_jobstore
node_server -->|"connects"| node_mongodb
node_uploadcontroller -->|"uploads media"| node_cloudinary

click node_app "https://github.com/shubhampal24/arena/blob/main/frontend/src/App.js"
click node_authstate "https://github.com/shubhampal24/arena/blob/main/frontend/src/context/AuthContext.js"
click node_authpages "https://github.com/shubhampal24/arena/tree/main/frontend/src/pages/auth"
click node_profiles "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Profile.js"
click node_orgprofiles "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/OrgProfile.js"
click node_profileedit "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/EditProfile.js"
click node_feed "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Feed.js"
click node_discover "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Discover.js"
click node_search "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/searchController.js"
click node_jobs "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Jobs.js"
click node_jobdetail "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/JobDetail.js"
click node_apply "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Apply.js"
click node_postjob "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/PostJob.js"
click node_dashboards "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Dashboard.js"
click node_orgdashboard "https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/OrgDashboard.js"
click node_clientapi "https://github.com/shubhampal24/arena/blob/main/frontend/src/utils/api.js"
click node_server "https://github.com/shubhampal24/arena/blob/main/backend/src/index.js"
click node_authcontroller "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/authController.js"
click node_usercontroller "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/userController.js"
click node_orgcontroller "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/orgController.js"
click node_postcontroller "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/postController.js"
click node_jobcontroller "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/jobController.js"
click node_applicationcontroller "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/applicationController.js"
click node_uploadcontroller "https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/uploadController.js"
click node_userstore "https://github.com/shubhampal24/arena/blob/main/backend/src/models/User.js"
click node_orgstore "https://github.com/shubhampal24/arena/blob/main/backend/src/models/Organization.js"
click node_jobstore "https://github.com/shubhampal24/arena/blob/main/backend/src/models/Job.js"
click node_poststore "https://github.com/shubhampal24/arena/blob/main/backend/src/models/Post.js"
click node_applicationstore "https://github.com/shubhampal24/arena/blob/main/backend/src/models/Application.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_clientapi toneBlue
class node_authstate,node_authpages,node_profiles,node_orgprofiles,node_profileedit,node_authcontroller,node_usercontroller,node_orgcontroller,node_mongodb toneAmber
class node_feed,node_discover,node_search,node_postcontroller toneMint
class node_jobs,node_jobdetail,node_apply,node_postjob,node_dashboards,node_orgdashboard,node_jobcontroller,node_applicationcontroller toneRose
class node_server,node_uploadcontroller,node_userstore,node_orgstore,node_jobstore,node_poststore,node_applicationstore,node_gamers,node_organizations,node_cloudinary toneIndigo
```

## Components

### Web experience

- [Routes and guards](https://github.com/shubhampal24/arena/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [API client](https://github.com/shubhampal24/arena/blob/main/frontend/src/utils/api.js): `frontend/src/utils/api.js`

### Accounts and profiles

- [Auth state](https://github.com/shubhampal24/arena/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [Login and registration](https://github.com/shubhampal24/arena/tree/main/frontend/src/pages/auth): `frontend/src/pages/auth`
- [Gaming profiles](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Profile.js): `frontend/src/pages/Profile.js`
- [Organization profiles](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/OrgProfile.js): `frontend/src/pages/OrgProfile.js`
- [Profile editor](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/EditProfile.js): `frontend/src/pages/EditProfile.js`
- [Authentication](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [User profiles](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/userController.js): `backend/src/controllers/userController.js`
- [Organization profiles](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/orgController.js): `backend/src/controllers/orgController.js`

### Community and discovery

- [Community feed](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Feed.js): `frontend/src/pages/Feed.js`
- [Talent discovery](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Discover.js): `frontend/src/pages/Discover.js`
- [Search API](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/searchController.js): `backend/src/controllers/searchController.js`
- [Feed operations](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/postController.js): `backend/src/controllers/postController.js`

### Hiring workflow

- [Job board](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Jobs.js): `frontend/src/pages/Jobs.js`
- [Job details](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/JobDetail.js): `frontend/src/pages/JobDetail.js`
- [Job application](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Apply.js): `frontend/src/pages/Apply.js`
- [Job posting](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/PostJob.js): `frontend/src/pages/PostJob.js`
- [Role dashboards](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/Dashboard.js): `frontend/src/pages/Dashboard.js`
- [Organization dashboard](https://github.com/shubhampal24/arena/blob/main/frontend/src/pages/OrgDashboard.js): `frontend/src/pages/OrgDashboard.js`
- [Job operations](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/jobController.js): `backend/src/controllers/jobController.js`
- [Application pipeline](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/applicationController.js): `backend/src/controllers/applicationController.js`

### API and persistence

- [Express API](https://github.com/shubhampal24/arena/blob/main/backend/src/index.js): `backend/src/index.js`
- [Media uploads](https://github.com/shubhampal24/arena/blob/main/backend/src/controllers/uploadController.js): `backend/src/controllers/uploadController.js`
- [User records](https://github.com/shubhampal24/arena/blob/main/backend/src/models/User.js): `backend/src/models/User.js`
- [Organization records](https://github.com/shubhampal24/arena/blob/main/backend/src/models/Organization.js): `backend/src/models/Organization.js`
- [Job records](https://github.com/shubhampal24/arena/blob/main/backend/src/models/Job.js): `backend/src/models/Job.js`
- [Post records](https://github.com/shubhampal24/arena/blob/main/backend/src/models/Post.js): `backend/src/models/Post.js`
- [Application records](https://github.com/shubhampal24/arena/blob/main/backend/src/models/Application.js): `backend/src/models/Application.js`

### Other components

- **Gamers and creators**
- **Esports organizations**
- **MongoDB**
- **Cloudinary**

## Connections

- Gamers and creators → Routes and guards: use (evidence: `README.md`)
- Esports organizations → Routes and guards: use (evidence: `README.md`)
- Routes and guards → Auth state: provides auth (evidence: `frontend/src/App.js`)
- Login and registration → Auth state: updates session (evidence: `frontend/src/pages/auth/Login.js`)
- Auth state → API client: loads identity (evidence: `frontend/src/context/AuthContext.js`)
- Gaming profiles → API client: requests profile (evidence: `frontend/src/pages/Profile.js`)
- Organization profiles → API client: requests profile (evidence: `frontend/src/pages/OrgProfile.js`)
- Profile editor → API client: updates profile
- Community feed → API client: requests feed (evidence: `frontend/src/pages/Feed.js`)
- Talent discovery → API client: searches talent (evidence: `frontend/src/pages/Discover.js`)
- Job board → API client: requests jobs
- Job details → API client: loads vacancy
- Job application → API client: submits application
- Job posting → API client: creates vacancy (evidence: `frontend/src/pages/PostJob.js`)
- Role dashboards → API client: loads dashboard
- Organization dashboard → API client: loads dashboard (evidence: `frontend/src/pages/OrgDashboard.js`)
- API client → Express API: calls REST (evidence: `frontend/src/utils/api.js`)
- Express API → Authentication: routes auth (evidence: `backend/src/index.js`)
- Express API → User profiles: routes users (evidence: `backend/src/index.js`)
- Express API → Organization profiles: routes organizations (evidence: `backend/src/index.js`)
- Express API → Feed operations: routes posts (evidence: `backend/src/index.js`)
- Express API → Job operations: routes jobs (evidence: `backend/src/index.js`)
- Express API → Application pipeline: routes applications (evidence: `backend/src/index.js`)
- Express API → Search API: routes search (evidence: `backend/src/index.js`)
- Express API → Media uploads: routes uploads (evidence: `backend/src/index.js`)
- Authentication → User records: reads and writes (evidence: `backend/src/controllers/authController.js`)
- Authentication → Organization records: reads and writes (evidence: `backend/src/controllers/authController.js`)
- User profiles → User records: updates records (evidence: `backend/src/controllers/userController.js`)
- Organization profiles → Organization records: updates records (evidence: `backend/src/controllers/orgController.js`)
- Feed operations → Post records: manages posts (evidence: `backend/src/controllers/postController.js`)
- Job operations → Job records: reads and writes (evidence: `backend/src/controllers/jobController.js`)
- Job operations → Organization records: updates job counts (evidence: `backend/src/controllers/jobController.js`)
- Application pipeline → Application records: manages applications (evidence: `backend/src/controllers/applicationController.js`)
- Application pipeline → Job records: checks vacancies (evidence: `backend/src/controllers/applicationController.js`)
- Search API → User records: searches (evidence: `backend/src/controllers/searchController.js`)
- Search API → Organization records: searches (evidence: `backend/src/controllers/searchController.js`)
- Search API → Job records: searches (evidence: `backend/src/controllers/searchController.js`)
- Express API → MongoDB: connects (evidence: `backend/src/index.js`)
- Media uploads → Cloudinary: uploads media (evidence: `README.md`)
