# suyogshelke/gamer-in architecture

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

- Interactive diagram: https://gitdiagram.com/suyogshelke/gamer-in
- Repository: https://github.com/suyogshelke/gamer-in

## Overview

Gamer-IN (GameRIN) is a full-stack social platform for gamers. Users register or sign in, then discover games and communities, publish and interact with media posts, follow creators, and view profiles, notifications, and achievements. The React app routes these experiences to an Express API; backend handlers use MongoDB-backed models, with shared services for feeds, notifications, and progression. The README establishes the platform capabilities, while source excerpts and the index show selected wiring; links for unsampled features are limited to documented relationships.

Main entry points: [`backend/models`](https://github.com/suyogshelke/gamer-in/tree/main/backend/models) (Domain models), [`backend/routes`](https://github.com/suyogshelke/gamer-in/tree/main/backend/routes) (API routing), [`backend/controllers/postController.js`](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/postController.js) (Posts and comments), [`backend/services/progressionService.js`](https://github.com/suyogshelke/gamer-in/blob/main/backend/services/progressionService.js) (Progression)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Route application<br/>[App.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_screens["Product screens"]
  node_api_client["API client<br/>[endpoints.js]"]
end

subgraph group_api["API layer"]
  node_api_routes["API routing"]
  node_auth["Authentication<br/>[authController.js]"]
end

subgraph group_domain["Social capabilities"]
  node_posts["Posts and comments<br/>[postController.js]"]
  node_communities["Communities"]
  node_profiles["Profiles and follows<br/>[userController.js]"]
  node_games["Game discovery<br/>[gameController.js]"]
  node_search["Global search"]
  node_achievements["Achievements"]
  node_feed["Feed shaping<br/>[feedService.js]"]
  node_progression["Progression"]
  node_notifications["Notifications"]
end

subgraph group_data["Persistence"]
  node_models["Domain models"]
  node_mongo[("MongoDB")]
end

node_gamer(("Gamer"))

node_gamer -->|"uses"| node_app
node_app -->|"routes to"| node_screens
node_app -->|"checks session"| node_authstate
node_authstate -->|"loads identity"| node_api_client
node_screens -.->|"requests data"| node_api_client
node_api_client -.->|"sends requests"| node_api_routes
node_api_routes -->|"routes auth"| node_auth
node_api_routes -->|"routes posts"| node_posts
node_api_routes -->|"routes communities"| node_communities
node_api_routes -->|"routes profiles"| node_profiles
node_api_routes -.->|"routes games"| node_games
node_api_routes -.->|"routes search"| node_search
node_api_routes -.->|"routes achievements"| node_achievements
node_posts -->|"decorates posts"| node_feed
node_posts -->|"records activity"| node_progression
node_posts -->|"notifies actors"| node_notifications
node_communities -->|"uses feed helpers"| node_feed
node_communities -->|"records activity"| node_progression
node_profiles -->|"decorates posts"| node_feed
node_profiles -->|"records activity"| node_progression
node_progression -->|"announces unlocks"| node_notifications
node_auth -.->|"reads accounts"| node_models
node_posts -->|"reads and writes"| node_models
node_communities -.->|"reads and writes"| node_models
node_profiles -->|"reads and writes"| node_models
node_games -.->|"reads catalogue"| node_models
node_search -.->|"searches records"| node_models
node_achievements -.->|"reads unlocks"| node_models
node_feed -->|"queries relations"| node_models
node_progression -->|"updates progress"| node_models
node_notifications -->|"stores alerts"| node_models
node_models -->|"persists data"| node_mongo

click node_app "https://github.com/suyogshelke/gamer-in/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/suyogshelke/gamer-in/blob/main/frontend/src/context/AuthContext.jsx"
click node_screens "https://github.com/suyogshelke/gamer-in/tree/main/frontend/src/pages"
click node_api_client "https://github.com/suyogshelke/gamer-in/blob/main/frontend/src/services/endpoints.js"
click node_api_routes "https://github.com/suyogshelke/gamer-in/tree/main/backend/routes"
click node_auth "https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/authController.js"
click node_posts "https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/postController.js"
click node_communities "https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/communityController.js"
click node_profiles "https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/userController.js"
click node_games "https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/gameController.js"
click node_search "https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/searchController.js"
click node_achievements "https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/achievementController.js"
click node_feed "https://github.com/suyogshelke/gamer-in/blob/main/backend/services/feedService.js"
click node_progression "https://github.com/suyogshelke/gamer-in/blob/main/backend/services/progressionService.js"
click node_notifications "https://github.com/suyogshelke/gamer-in/blob/main/backend/services/notificationService.js"
click node_models "https://github.com/suyogshelke/gamer-in/tree/main/backend/models"

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_authstate,node_screens,node_api_client toneBlue
class node_api_routes,node_auth toneAmber
class node_posts,node_communities,node_profiles,node_games,node_search,node_achievements,node_feed,node_progression,node_notifications toneMint
class node_models,node_mongo toneRose
class node_gamer toneIndigo
```

## Components

### Web application

- [Route application](https://github.com/suyogshelke/gamer-in/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth state](https://github.com/suyogshelke/gamer-in/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Product screens](https://github.com/suyogshelke/gamer-in/tree/main/frontend/src/pages): `frontend/src/pages`
- [API client](https://github.com/suyogshelke/gamer-in/blob/main/frontend/src/services/endpoints.js): `frontend/src/services/endpoints.js`

### API layer

- [API routing](https://github.com/suyogshelke/gamer-in/tree/main/backend/routes): `backend/routes`
- [Authentication](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`

### Social capabilities

- [Posts and comments](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/postController.js): `backend/controllers/postController.js`
- [Communities](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/communityController.js): `backend/controllers/communityController.js`
- [Profiles and follows](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Game discovery](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/gameController.js): `backend/controllers/gameController.js`
- [Global search](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/searchController.js): `backend/controllers/searchController.js`
- [Achievements](https://github.com/suyogshelke/gamer-in/blob/main/backend/controllers/achievementController.js): `backend/controllers/achievementController.js`
- [Feed shaping](https://github.com/suyogshelke/gamer-in/blob/main/backend/services/feedService.js): `backend/services/feedService.js`
- [Progression](https://github.com/suyogshelke/gamer-in/blob/main/backend/services/progressionService.js): `backend/services/progressionService.js`
- [Notifications](https://github.com/suyogshelke/gamer-in/blob/main/backend/services/notificationService.js): `backend/services/notificationService.js`

### Persistence

- [Domain models](https://github.com/suyogshelke/gamer-in/tree/main/backend/models): `backend/models`
- **MongoDB**

### Other components

- **Gamer**

## Connections

- Gamer → Route application: uses (evidence: `README.md`)
- Route application → Product screens: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Auth state: checks session (evidence: `frontend/src/App.jsx`)
- Auth state → API client: loads identity (evidence: `frontend/src/context/AuthContext.jsx`)
- Product screens → API client: requests data (evidence: `frontend/src/pages/Search.jsx`)
- API client → API routing: sends requests
- API routing → Authentication: routes auth (evidence: `backend/routes/authRoutes.js`)
- API routing → Posts and comments: routes posts (evidence: `backend/routes/postRoutes.js`)
- API routing → Communities: routes communities (evidence: `backend/routes/communityRoutes.js`)
- API routing → Profiles and follows: routes profiles (evidence: `backend/routes/userRoutes.js`)
- API routing → Game discovery: routes games
- API routing → Global search: routes search
- API routing → Achievements: routes achievements
- Posts and comments → Feed shaping: decorates posts (evidence: `backend/controllers/postController.js`)
- Posts and comments → Progression: records activity (evidence: `backend/controllers/postController.js`)
- Posts and comments → Notifications: notifies actors (evidence: `backend/controllers/postController.js`)
- Communities → Feed shaping: uses feed helpers (evidence: `backend/controllers/communityController.js`)
- Communities → Progression: records activity (evidence: `backend/controllers/communityController.js`)
- Profiles and follows → Feed shaping: decorates posts (evidence: `backend/controllers/userController.js`)
- Profiles and follows → Progression: records activity (evidence: `backend/controllers/userController.js`)
- Progression → Notifications: announces unlocks (evidence: `backend/services/progressionService.js`)
- Authentication → Domain models: reads accounts
- Posts and comments → Domain models: reads and writes (evidence: `backend/controllers/postController.js`)
- Communities → Domain models: reads and writes (evidence: `backend/controllers/communityController.js`)
- Profiles and follows → Domain models: reads and writes (evidence: `backend/controllers/userController.js`)
- Game discovery → Domain models: reads catalogue (evidence: `backend/controllers/gameController.js`)
- Global search → Domain models: searches records
- Achievements → Domain models: reads unlocks
- Feed shaping → Domain models: queries relations (evidence: `backend/services/feedService.js`)
- Progression → Domain models: updates progress (evidence: `backend/services/progressionService.js`)
- Notifications → Domain models: stores alerts (evidence: `backend/services/notificationService.js`)
- Domain models → MongoDB: persists data (evidence: `README.md`)
