# tamil-webdev/event-bridge architecture

> Architecture diagram of the GitHub repository tamil-webdev/event-bridge, 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/tamil-webdev/event-bridge
- Repository: https://github.com/tamil-webdev/event-bridge

## Overview

Event Bridge is a campus club and event platform. Students register or sign in, discover clubs and events, follow clubs, register for activities, and receive notifications; club admins create clubs and publish events. The React app routes users through these activities and calls an Express API backed by MongoDB. The README documents dashboard statistics, location-aware discovery, and image uploads. Some frontend API modules and backend controllers were not sampled, so those feature links rely on README documentation rather than inspected implementation.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/App.jsx) (Route app), [`Backend/server.js`](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/server.js) (Express server), [`Backend/controllers/event.controller.js`](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/event.controller.js) (Event operations), [`Backend/models/user.model.js`](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/user.model.js) (User records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Campus experience"]
  node_app["Route app<br/>[App.jsx]"]
  node_layout["App layout<br/>[Layout.jsx]"]
  node_auth_pages["Account pages<br/>[LoginPage.jsx]"]
  node_home["Event dashboard<br/>[HomePage.jsx]"]
  node_club_pages["Club discovery<br/>[ClubsPage.jsx]"]
  node_club_detail["Club detail<br/>[Club.jsx]"]
  node_club_create["Club creation<br/>[CreateClub.jsx]"]
  node_event_create["Event publishing<br/>[CreateEvent.jsx]"]
  node_event_edit["Event editing<br/>[EditEvent.jsx]"]
  node_notifications_ui["Notifications view<br/>[Notifications.jsx]"]
end

subgraph group_frontend_api["Frontend API"]
  node_api_client["HTTP client<br/>[api.js]"]
  node_auth_api["Account API<br/>[auth.js]"]
  node_club_api["Club API<br/>[clubs.js]"]
  node_event_api["Event API<br/>[event.js]"]
  node_college_api["College API<br/>[college.js]"]
  node_notification_api["Notification API<br/>[notifications.js]"]
end

subgraph group_backend["Backend services"]
  node_server["Express server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_club_routes["Club routes<br/>[club.routes.js]"]
  node_event_routes["Event routes<br/>[event.routes.js]"]
  node_college_routes["College routes<br/>[college.routes.js]"]
  node_notification_routes["Notification routes"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_club_controller["Club management<br/>[club.controller.js]"]
  node_event_controller["Event operations"]
  node_college_controller["College lookup"]
  node_notification_controller["Notification operations"]
  node_auth_middleware["JWT verification<br/>[auth.middleware.js]"]
  node_upload_middleware["Image uploads"]
end

subgraph group_data["Domain data"]
  node_user_model["User records<br/>[user.model.js]"]
  node_club_model["Club records<br/>[club.model.js]"]
  node_event_model["Event records<br/>[event.model.js]"]
  node_college_model["College records<br/>[college.model.js]"]
end

node_student(("Student or admin"))

node_student -->|"uses"| node_app
node_app -->|"routes to"| node_auth_pages
node_app -->|"wraps"| node_layout
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_club_pages
node_app -->|"routes to"| node_club_detail
node_app -->|"routes to"| node_club_create
node_app -->|"routes to"| node_event_create
node_app -->|"routes to"| node_event_edit
node_app -->|"routes to"| node_notifications_ui
node_auth_pages -->|"calls"| node_auth_api
node_home -->|"calls"| node_event_api
node_club_pages -->|"calls"| node_club_api
node_club_detail -->|"calls"| node_club_api
node_club_detail -->|"calls"| node_event_api
node_club_create -->|"calls"| node_club_api
node_club_create -->|"calls"| node_college_api
node_event_create -->|"calls"| node_event_api
node_event_edit -->|"calls"| node_event_api
node_notifications_ui -->|"calls"| node_notification_api
node_layout -->|"reads session"| node_auth_api
node_layout -->|"calls"| node_notification_api
node_auth_api -->|"uses"| node_api_client
node_api_client -.->|"sends requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_club_routes
node_server -->|"mounts"| node_event_routes
node_server -->|"mounts"| node_college_routes
node_server -->|"mounts"| node_notification_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_club_routes -->|"dispatches"| node_club_controller
node_event_routes -->|"dispatches"| node_event_controller
node_college_routes -->|"dispatches"| node_college_controller
node_notification_routes -->|"dispatches"| node_notification_controller
node_club_routes -->|"checks token"| node_auth_middleware
node_event_routes -->|"checks token"| node_auth_middleware
node_notification_routes -->|"checks token"| node_auth_middleware
node_club_routes -->|"accepts images"| node_upload_middleware
node_auth_controller -->|"reads and writes"| node_user_model
node_club_controller -->|"reads and writes"| node_club_model
node_club_controller -->|"updates membership"| node_user_model
node_club_controller -->|"checks college"| node_college_model
node_event_controller -->|"reads and writes"| node_event_model
node_event_controller -->|"checks club"| node_club_model
node_event_controller -->|"updates registrations"| node_user_model
node_college_controller -->|"reads"| node_college_model
node_notification_controller -->|"reads and updates"| node_user_model
node_event_controller -->|"notifies followers"| node_user_model

click node_app "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/App.jsx"
click node_layout "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/componants/Layout.jsx"
click node_auth_pages "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/LoginPage.jsx"
click node_home "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/HomePage.jsx"
click node_club_pages "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/ClubsPage.jsx"
click node_club_detail "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/Club.jsx"
click node_club_create "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/CreateClub.jsx"
click node_event_create "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/CreateEvent.jsx"
click node_event_edit "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/EditEvent.jsx"
click node_notifications_ui "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/Notifications.jsx"
click node_api_client "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/api.js"
click node_auth_api "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/auth.js"
click node_club_api "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/clubs.js"
click node_event_api "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/event.js"
click node_college_api "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/college.js"
click node_notification_api "https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/notifications.js"
click node_server "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/server.js"
click node_auth_routes "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/auth.routes.js"
click node_club_routes "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/club.routes.js"
click node_event_routes "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/event.routes.js"
click node_college_routes "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/college.routes.js"
click node_notification_routes "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/notification.routes.js"
click node_auth_controller "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/auth.controller.js"
click node_club_controller "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/club.controller.js"
click node_event_controller "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/event.controller.js"
click node_college_controller "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/college.controller.js"
click node_notification_controller "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/notification.controller.js"
click node_auth_middleware "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/middlewares/auth.middleware.js"
click node_upload_middleware "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/middlewares/upload.middleware.js"
click node_user_model "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/user.model.js"
click node_club_model "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/club.model.js"
click node_event_model "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/event.model.js"
click node_college_model "https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/college.model.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_layout,node_auth_pages,node_home,node_club_pages,node_club_detail,node_club_create,node_event_create,node_event_edit,node_notifications_ui toneBlue
class node_api_client,node_auth_api,node_club_api,node_event_api,node_college_api,node_notification_api toneAmber
class node_server,node_auth_routes,node_club_routes,node_event_routes,node_college_routes,node_notification_routes,node_auth_controller,node_club_controller,node_event_controller,node_college_controller,node_notification_controller,node_auth_middleware,node_upload_middleware toneMint
class node_user_model,node_club_model,node_event_model,node_college_model toneRose
class node_student toneIndigo
```

## Components

### Campus experience

- [Route app](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [App layout](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/componants/Layout.jsx): `Frontend/src/componants/Layout.jsx`
- [Account pages](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/LoginPage.jsx): `Frontend/src/Pages/LoginPage.jsx`
- [Event dashboard](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/HomePage.jsx): `Frontend/src/Pages/HomePage.jsx`
- [Club discovery](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/ClubsPage.jsx): `Frontend/src/Pages/ClubsPage.jsx`
- [Club detail](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/Club.jsx): `Frontend/src/Pages/Club.jsx`
- [Club creation](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/CreateClub.jsx): `Frontend/src/Pages/CreateClub.jsx`
- [Event publishing](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/CreateEvent.jsx): `Frontend/src/Pages/CreateEvent.jsx`
- [Event editing](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/EditEvent.jsx): `Frontend/src/Pages/EditEvent.jsx`
- [Notifications view](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/Pages/Notifications.jsx): `Frontend/src/Pages/Notifications.jsx`

### Frontend API

- [HTTP client](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/api.js): `Frontend/src/api/api.js`
- [Account API](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/auth.js): `Frontend/src/api/auth.js`
- [Club API](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/clubs.js): `Frontend/src/api/clubs.js`
- [Event API](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/event.js): `Frontend/src/api/event.js`
- [College API](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/college.js): `Frontend/src/api/college.js`
- [Notification API](https://github.com/tamil-webdev/event-bridge/blob/main/Frontend/src/api/notifications.js): `Frontend/src/api/notifications.js`

### Backend services

- [Express server](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/server.js): `Backend/server.js`
- [Auth routes](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/auth.routes.js): `Backend/routes/auth.routes.js`
- [Club routes](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/club.routes.js): `Backend/routes/club.routes.js`
- [Event routes](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/event.routes.js): `Backend/routes/event.routes.js`
- [College routes](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/college.routes.js): `Backend/routes/college.routes.js`
- [Notification routes](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/routes/notification.routes.js): `Backend/routes/notification.routes.js`
- [Authentication](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/auth.controller.js): `Backend/controllers/auth.controller.js`
- [Club management](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/club.controller.js): `Backend/controllers/club.controller.js`
- [Event operations](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/event.controller.js): `Backend/controllers/event.controller.js`
- [College lookup](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/college.controller.js): `Backend/controllers/college.controller.js`
- [Notification operations](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/controllers/notification.controller.js): `Backend/controllers/notification.controller.js`
- [JWT verification](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/middlewares/auth.middleware.js): `Backend/middlewares/auth.middleware.js`
- [Image uploads](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/middlewares/upload.middleware.js): `Backend/middlewares/upload.middleware.js`

### Domain data

- [User records](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/user.model.js): `Backend/models/user.model.js`
- [Club records](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/club.model.js): `Backend/models/club.model.js`
- [Event records](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/event.model.js): `Backend/models/event.model.js`
- [College records](https://github.com/tamil-webdev/event-bridge/blob/main/Backend/models/college.model.js): `Backend/models/college.model.js`

### Other components

- **Student or admin**

## Connections

- Student or admin → Route app: uses (evidence: `README.md`)
- Route app → Account pages: routes to (evidence: `Frontend/src/App.jsx`)
- Route app → App layout: wraps (evidence: `Frontend/src/App.jsx`)
- Route app → Event dashboard: routes to (evidence: `Frontend/src/App.jsx`)
- Route app → Club discovery: routes to (evidence: `Frontend/src/App.jsx`)
- Route app → Club detail: routes to (evidence: `Frontend/src/App.jsx`)
- Route app → Club creation: routes to (evidence: `Frontend/src/App.jsx`)
- Route app → Event publishing: routes to (evidence: `Frontend/src/App.jsx`)
- Route app → Event editing: routes to (evidence: `Frontend/src/App.jsx`)
- Route app → Notifications view: routes to (evidence: `Frontend/src/App.jsx`)
- Account pages → Account API: calls (evidence: `Frontend/src/Pages/LoginPage.jsx`)
- Event dashboard → Event API: calls (evidence: `Frontend/src/Pages/HomePage.jsx`)
- Club discovery → Club API: calls (evidence: `Frontend/src/Pages/ClubsPage.jsx`)
- Club detail → Club API: calls (evidence: `Frontend/src/Pages/Club.jsx`)
- Club detail → Event API: calls (evidence: `Frontend/src/Pages/Club.jsx`)
- Club creation → Club API: calls (evidence: `Frontend/src/Pages/CreateClub.jsx`)
- Club creation → College API: calls (evidence: `Frontend/src/Pages/CreateClub.jsx`)
- Event publishing → Event API: calls (evidence: `Frontend/src/Pages/CreateEvent.jsx`)
- Event editing → Event API: calls (evidence: `Frontend/src/Pages/EditEvent.jsx`)
- Notifications view → Notification API: calls (evidence: `Frontend/src/Pages/Notifications.jsx`)
- App layout → Account API: reads session (evidence: `Frontend/src/componants/Layout.jsx`)
- App layout → Notification API: calls (evidence: `Frontend/src/componants/Layout.jsx`)
- Account API → HTTP client: uses (evidence: `Frontend/src/api/auth.js`)
- HTTP client → Express server: sends requests (evidence: `README.md`)
- Express server → Auth routes: mounts (evidence: `Backend/server.js`)
- Express server → Club routes: mounts (evidence: `Backend/server.js`)
- Express server → Event routes: mounts (evidence: `Backend/server.js`)
- Express server → College routes: mounts (evidence: `Backend/server.js`)
- Express server → Notification routes: mounts (evidence: `Backend/server.js`)
- Auth routes → Authentication: dispatches (evidence: `Backend/routes/auth.routes.js`)
- Club routes → Club management: dispatches (evidence: `Backend/routes/club.routes.js`)
- Event routes → Event operations: dispatches (evidence: `Backend/routes/event.routes.js`)
- College routes → College lookup: dispatches (evidence: `Backend/routes/college.routes.js`)
- Notification routes → Notification operations: dispatches (evidence: `Backend/routes/notification.routes.js`)
- Club routes → JWT verification: checks token (evidence: `Backend/routes/club.routes.js`)
- Event routes → JWT verification: checks token (evidence: `Backend/routes/event.routes.js`)
- Notification routes → JWT verification: checks token (evidence: `Backend/routes/notification.routes.js`)
- Club routes → Image uploads: accepts images (evidence: `Backend/routes/club.routes.js`)
- Authentication → User records: reads and writes (evidence: `Backend/controllers/auth.controller.js`)
- Club management → Club records: reads and writes (evidence: `Backend/controllers/club.controller.js`)
- Club management → User records: updates membership (evidence: `Backend/controllers/club.controller.js`)
- Club management → College records: checks college (evidence: `Backend/controllers/club.controller.js`)
- Event operations → Event records: reads and writes (evidence: `Backend/controllers/event.controller.js`)
- Event operations → Club records: checks club (evidence: `Backend/controllers/event.controller.js`)
- Event operations → User records: updates registrations (evidence: `Backend/controllers/event.controller.js`)
- College lookup → College records: reads (evidence: `Backend/controllers/college.controller.js`)
- Notification operations → User records: reads and updates (evidence: `Backend/controllers/notification.controller.js`)
- Event operations → User records: notifies followers (evidence: `Backend/controllers/event.controller.js`)
