# deepakduvesh/artistic-enigma architecture

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

- Interactive diagram: https://gitdiagram.com/deepakduvesh/artistic-enigma
- Repository: https://github.com/deepakduvesh/artistic-enigma

## Overview

Artistic-Enigma is a multiplayer drawing-and-guessing game. Players sign in, create or join a public or private room, take timed drawing turns, chat and guess words, and accumulate scores toward a winner. The React client handles room entry and game presentation; the Node server coordinates Socket.IO rooms, turns, drawing events, guesses, and scores, while Express routes handle account operations. The README documents additional drawing tools and profile/history capabilities; unsampled details and some client-to-HTTP wiring are not asserted beyond those documented capabilities.

Main entry points: [`server/index.js`](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/index.js) (Realtime game server), [`client/src/Components/WhiteBoard.js`](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/WhiteBoard.js) (Drawing board), [`client/src/App.js`](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/App.js) (App routing), [`client/src/pages/PublicPlay.js`](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/PublicPlay.js) (Public play)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Game client"]
  node_app["App routing<br/>[App.js]"]
  node_home["Home and rooms<br/>[Home.jsx]"]
  node_lobby["Room lobby<br/>[Lobby.js]"]
end

subgraph group_gameplay["Live gameplay"]
  node_play["Private play<br/>[Play.js]"]
  node_publicplay["Public play<br/>[PublicPlay.js]"]
  node_whiteboard["Drawing board<br/>[WhiteBoard.js]"]
  node_tools["Drawing tools<br/>[WhiteBoardTools.js]"]
  node_icons["Tool icons<br/>[MySvgIcon.js]"]
  node_timer["Turn timer<br/>[Time.js]"]
  node_worddisplay["Word display"]
  node_chat["Game chat<br/>[Chat.js]"]
  node_leaderboard["Leaderboard<br/>[LeaderBoard.js]"]
  node_winner["Winner display<br/>[Winner.js]"]
end

subgraph group_server["Game server"]
  node_socketserver["Realtime game server<br/>[index.js]"]
end

subgraph group_identity["Accounts and profiles"]
  node_login["Login and signup<br/>[Login.jsx]"]
  node_profile["Profile page<br/>[Profile.js]"]
  node_authroutes["Auth routes<br/>[AuthRoute.js]"]
  node_authcontroller["Auth operations<br/>[AuthController.js]"]
  node_authmiddleware["Token verification<br/>[AuthMiddleware.js]"]
end

subgraph group_data["Persistence"]
  node_user[("User records<br/>[UserModel.js]")]
  node_room[("Room records<br/>[RoomModel.js]")]
  node_userroom[("User-room records<br/>[UserRoom.js]")]
end

node_player(("Player"))
node_mongo[("MongoDB")]

node_player -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_lobby
node_app -->|"routes to"| node_play
node_app -->|"routes to"| node_publicplay
node_home -->|"requests room"| node_socketserver
node_home -->|"navigates to"| node_lobby
node_home -->|"navigates to"| node_publicplay
node_lobby -->|"joins and polls"| node_socketserver
node_socketserver -->|"signals start"| node_lobby
node_play -->|"renders"| node_whiteboard
node_play -->|"renders"| node_chat
node_play -->|"renders"| node_leaderboard
node_play -->|"renders"| node_timer
node_play -->|"renders"| node_winner
node_publicplay -->|"renders"| node_whiteboard
node_publicplay -->|"renders"| node_chat
node_publicplay -->|"renders"| node_leaderboard
node_publicplay -->|"renders"| node_timer
node_publicplay -->|"renders"| node_winner
node_whiteboard -->|"sends drawing events"| node_socketserver
node_socketserver -->|"broadcasts drawing"| node_whiteboard
node_whiteboard -->|"uses"| node_tools
node_whiteboard -->|"renders"| node_timer
node_whiteboard -->|"renders"| node_worddisplay
node_whiteboard -->|"renders"| node_icons
node_chat -->|"sends messages"| node_socketserver
node_socketserver -->|"relays messages"| node_chat
node_login -.->|"authenticates"| node_authroutes
node_profile -.->|"requests profile"| node_authroutes
node_authroutes -->|"routes requests"| node_authcontroller
node_authroutes -->|"verifies token"| node_authmiddleware
node_authcontroller -->|"reads and creates"| node_user
node_authmiddleware -->|"looks up user"| node_user
node_user -->|"persists in"| node_mongo
node_socketserver -->|"imports room model"| node_room
node_socketserver -->|"imports user-room model"| node_userroom
node_room -.->|"stores room data"| node_mongo
node_userroom -.->|"stores membership"| node_mongo

click node_app "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/App.js"
click node_home "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Home.jsx"
click node_lobby "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Lobby.js"
click node_login "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Login.jsx"
click node_profile "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Profile.js"
click node_play "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Play.js"
click node_publicplay "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/PublicPlay.js"
click node_whiteboard "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/WhiteBoard.js"
click node_tools "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/WhiteBoardTools.js"
click node_icons "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/MySvgIcon.js"
click node_timer "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/Time.js"
click node_worddisplay "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/UnderscoreDisplay.js"
click node_chat "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/Chat.js"
click node_leaderboard "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/LeaderBoard.js"
click node_winner "https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/Winner.js"
click node_socketserver "https://github.com/deepakduvesh/artistic-enigma/blob/main/server/index.js"
click node_authroutes "https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Routes/AuthRoute.js"
click node_authcontroller "https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Controllers/AuthController.js"
click node_authmiddleware "https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Middlewares/AuthMiddleware.js"
click node_user "https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Models/UserModel.js"
click node_room "https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Models/RoomModel.js"
click node_userroom "https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Models/UserRoom.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_home,node_lobby toneBlue
class node_play,node_publicplay,node_whiteboard,node_tools,node_icons,node_timer,node_worddisplay,node_chat,node_leaderboard,node_winner,node_mongo toneAmber
class node_socketserver toneMint
class node_login,node_profile,node_authroutes,node_authcontroller,node_authmiddleware toneRose
class node_user,node_room,node_userroom,node_player toneIndigo
```

## Components

### Game client

- [App routing](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/App.js): `client/src/App.js`
- [Home and rooms](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Room lobby](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Lobby.js): `client/src/pages/Lobby.js`

### Live gameplay

- [Private play](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Play.js): `client/src/pages/Play.js`
- [Public play](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/PublicPlay.js): `client/src/pages/PublicPlay.js`
- [Drawing board](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/WhiteBoard.js): `client/src/Components/WhiteBoard.js`
- [Drawing tools](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/WhiteBoardTools.js): `client/src/Components/WhiteBoardTools.js`
- [Tool icons](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/MySvgIcon.js): `client/src/Components/MySvgIcon.js`
- [Turn timer](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/Time.js): `client/src/Components/Time.js`
- [Word display](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/UnderscoreDisplay.js): `client/src/Components/UnderscoreDisplay.js`
- [Game chat](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/Chat.js): `client/src/Components/Chat.js`
- [Leaderboard](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/LeaderBoard.js): `client/src/Components/LeaderBoard.js`
- [Winner display](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/Components/Winner.js): `client/src/Components/Winner.js`

### Game server

- [Realtime game server](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/index.js): `server/index.js`

### Accounts and profiles

- [Login and signup](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Profile page](https://github.com/deepakduvesh/artistic-enigma/blob/main/client/src/pages/Profile.js): `client/src/pages/Profile.js`
- [Auth routes](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Routes/AuthRoute.js): `server/Routes/AuthRoute.js`
- [Auth operations](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Controllers/AuthController.js): `server/Controllers/AuthController.js`
- [Token verification](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Middlewares/AuthMiddleware.js): `server/Middlewares/AuthMiddleware.js`

### Persistence

- [User records](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Models/UserModel.js): `server/Models/UserModel.js`
- [Room records](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Models/RoomModel.js): `server/Models/RoomModel.js`
- [User-room records](https://github.com/deepakduvesh/artistic-enigma/blob/main/server/Models/UserRoom.js): `server/Models/UserRoom.js`

### Other components

- **Player**
- **MongoDB**

## Connections

- Player → App routing: uses (evidence: `README.md`)
- App routing → Home and rooms: routes to (evidence: `client/src/App.js`)
- App routing → Login and signup: routes to (evidence: `client/src/App.js`)
- App routing → Profile page: routes to (evidence: `client/src/App.js`)
- App routing → Room lobby: routes to (evidence: `client/src/App.js`)
- App routing → Private play: routes to (evidence: `client/src/App.js`)
- App routing → Public play: routes to (evidence: `client/src/App.js`)
- Home and rooms → Realtime game server: requests room (evidence: `client/src/pages/Home.jsx`)
- Home and rooms → Room lobby: navigates to (evidence: `client/src/pages/Home.jsx`)
- Home and rooms → Public play: navigates to (evidence: `client/src/pages/Home.jsx`)
- Room lobby → Realtime game server: joins and polls (evidence: `client/src/pages/Lobby.js`)
- Realtime game server → Room lobby: signals start (evidence: `client/src/pages/Lobby.js`)
- Private play → Drawing board: renders (evidence: `client/src/pages/Play.js`)
- Private play → Game chat: renders (evidence: `client/src/pages/Play.js`)
- Private play → Leaderboard: renders (evidence: `client/src/pages/Play.js`)
- Private play → Turn timer: renders (evidence: `client/src/pages/Play.js`)
- Private play → Winner display: renders (evidence: `client/src/pages/Play.js`)
- Public play → Drawing board: renders (evidence: `client/src/pages/PublicPlay.js`)
- Public play → Game chat: renders (evidence: `client/src/pages/PublicPlay.js`)
- Public play → Leaderboard: renders (evidence: `client/src/pages/PublicPlay.js`)
- Public play → Turn timer: renders (evidence: `client/src/pages/PublicPlay.js`)
- Public play → Winner display: renders (evidence: `client/src/pages/PublicPlay.js`)
- Drawing board → Realtime game server: sends drawing events (evidence: `client/src/Components/WhiteBoard.js`)
- Realtime game server → Drawing board: broadcasts drawing (evidence: `server/index.js`)
- Drawing board → Drawing tools: uses (evidence: `client/src/Components/WhiteBoard.js`)
- Drawing board → Turn timer: renders (evidence: `client/src/Components/WhiteBoard.js`)
- Drawing board → Word display: renders (evidence: `client/src/Components/WhiteBoard.js`)
- Drawing board → Tool icons: renders (evidence: `client/src/Components/WhiteBoard.js`)
- Game chat → Realtime game server: sends messages (evidence: `client/src/Components/Chat.js`)
- Realtime game server → Game chat: relays messages (evidence: `server/index.js`)
- Login and signup → Auth routes: authenticates (evidence: `README.md`)
- Profile page → Auth routes: requests profile (evidence: `README.md`)
- Auth routes → Auth operations: routes requests (evidence: `server/Routes/AuthRoute.js`)
- Auth routes → Token verification: verifies token (evidence: `server/Routes/AuthRoute.js`)
- Auth operations → User records: reads and creates (evidence: `server/Controllers/AuthController.js`)
- Token verification → User records: looks up user (evidence: `server/Middlewares/AuthMiddleware.js`)
- User records → MongoDB: persists in (evidence: `server/Models/UserModel.js`)
- Realtime game server → Room records: imports room model (evidence: `server/index.js`)
- Realtime game server → User-room records: imports user-room model (evidence: `server/index.js`)
- Room records → MongoDB: stores room data
- User-room records → MongoDB: stores membership
