# vijaykumar-devcode/nexo-blog architecture

> Architecture diagram of the GitHub repository vijaykumar-devcode/nexo-blog, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vijaykumar-devcode/nexo-blog
- Repository: https://github.com/vijaykumar-devcode/nexo-blog

## Overview

Nexo India is a full-stack blogging platform for readers, writers, and administrators. Users browse articles and engage with them; writers create drafts and submit articles for review; administrators manage users and publication. The React app provides role-aware routes and shared auth/blog state, while an Express API handles domain operations and MongoDB-backed records. Separate capabilities include Gemini-powered assistance, live notifications, email, SEO, and Cloudinary uploads. Several frontend pages and backend modules are unsampled, so their connections are included only where documented or explicitly visible in the source index.

Main entry points: [`front/src/App.jsx`](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/App.jsx) (React application), [`server/controllers/notificationController.js`](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/notificationController.js) (Notifications), [`server/index.js`](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/index.js) (Express API), [`server/controllers/authController.js`](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/authController.js) (Auth controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["React application<br/>[App.jsx]"]
  node_readerpages["Browse articles<br/>[Blogs.jsx]"]
  node_detailpage["Article detail<br/>[BlogDetail.jsx]"]
end

subgraph group_identity["Identity and roles"]
  node_authui["Auth context<br/>[AuthContext.jsx]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authlogic["Auth controller<br/>[authController.js]"]
  node_authguard["Auth middleware<br/>[authMiddleware.js]"]
end

subgraph group_content["Publishing and content"]
  node_blogui["Blog context<br/>[BlogContext.jsx]"]
  node_writerdesk["Writer dashboard"]
  node_editor["Article editor<br/>[CreateEditPost.jsx]"]
  node_admindesk["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_blogroutes["Blog routes<br/>[blogRoutes.js]"]
  node_bloglogic["Blog controller<br/>[blogController.js]"]
end

subgraph group_engagement["Engagement services"]
  node_assistantui["Chatbot widget<br/>[ChatbotWidget.jsx]"]
  node_chatroute["Chatbot routes<br/>[chatbot.routes.js]"]
  node_chatlogic["Chatbot service<br/>[chatbot.service.js]"]
  node_notifications["Notifications"]
  node_socket["Live delivery<br/>[socket.js]"]
  node_email["Email delivery<br/>[sendEmail.js]"]
end

subgraph group_platform["API and persistence"]
  node_api["Express API<br/>[index.js]"]
  node_blogstore[("Blog records<br/>[Blog.js]")]
  node_userstore[("User records<br/>[User.js]")]
  node_notificationstore[("Notification records<br/>[Notification.js]")]
  node_cloudinary["Cloudinary storage<br/>[cloudinary.js]"]
end

node_readers(("Readers"))
node_writers(("Writers"))
node_admins(("Administrators"))
node_gemini["Google Gemini"]
node_mongodb[("MongoDB")]

node_readers -->|"browse"| node_webapp
node_writers -->|"manage articles"| node_webapp
node_admins -->|"manage platform"| node_webapp
node_webapp -->|"provides auth"| node_authui
node_webapp -->|"provides blog state"| node_blogui
node_webapp -->|"routes to"| node_readerpages
node_webapp -->|"routes to"| node_detailpage
node_webapp -->|"routes to"| node_writerdesk
node_webapp -->|"routes to"| node_editor
node_webapp -->|"routes to"| node_admindesk
node_webapp -->|"mounts launcher"| node_assistantui
node_authui -->|"calls auth API"| node_authroutes
node_blogui -->|"uses auth state"| node_authui
node_api -->|"registers"| node_authroutes
node_api -->|"registers"| node_blogroutes
node_api -->|"registers"| node_chatroute
node_api -->|"initializes live service"| node_notifications
node_authroutes -->|"routes requests"| node_authlogic
node_authroutes -->|"protects routes"| node_authguard
node_authlogic -->|"reads and updates"| node_userstore
node_authlogic -->|"sends account email"| node_email
node_blogroutes -->|"routes requests"| node_bloglogic
node_bloglogic -->|"reads and writes"| node_blogstore
node_bloglogic -->|"creates alerts"| node_notifications
node_bloglogic -->|"sends publication email"| node_email
node_chatroute -->|"routes requests"| node_chatlogic
node_chatlogic -->|"queries AI"| node_gemini
node_chatlogic -->|"uses article context"| node_blogstore
node_notifications -->|"creates and reads"| node_notificationstore
node_notifications -->|"pushes events"| node_socket
node_notifications -->|"optionally emails"| node_email
node_authlogic -->|"authenticates users"| node_userstore
node_blogstore -->|"persists through Mongoose"| node_mongodb
node_userstore -->|"persists through Mongoose"| node_mongodb
node_notificationstore -->|"persists through Mongoose"| node_mongodb
node_editor -.->|"uploads media"| node_cloudinary

click node_webapp "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/App.jsx"
click node_authui "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/context/AuthContext.jsx"
click node_blogui "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/context/BlogContext.jsx"
click node_readerpages "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/Blogs.jsx"
click node_detailpage "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/BlogDetail.jsx"
click node_writerdesk "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/WriterDashboard.jsx"
click node_editor "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/CreateEditPost.jsx"
click node_admindesk "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/AdminDashboard.jsx"
click node_assistantui "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/components/ChatbotWidget.jsx"
click node_api "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/index.js"
click node_authroutes "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/routes/authRoutes.js"
click node_authlogic "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/authController.js"
click node_authguard "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/middleware/authMiddleware.js"
click node_blogroutes "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/routes/blogRoutes.js"
click node_bloglogic "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/blogController.js"
click node_blogstore "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/models/Blog.js"
click node_userstore "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/models/User.js"
click node_chatroute "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/modules/chatbot/chatbot.routes.js"
click node_chatlogic "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/modules/chatbot/chatbot.service.js"
click node_notifications "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/notificationController.js"
click node_notificationstore "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/models/Notification.js"
click node_socket "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/utils/socket.js"
click node_email "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/utils/sendEmail.js"
click node_cloudinary "https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/utils/cloudinary.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_webapp,node_readerpages,node_detailpage toneBlue
class node_authui,node_authroutes,node_authlogic,node_authguard,node_mongodb toneAmber
class node_blogui,node_writerdesk,node_editor,node_admindesk,node_blogroutes,node_bloglogic toneMint
class node_assistantui,node_chatroute,node_chatlogic,node_notifications,node_socket,node_email toneRose
class node_api,node_blogstore,node_userstore,node_notificationstore,node_cloudinary,node_readers,node_writers,node_admins,node_gemini toneIndigo
```

## Components

### Web experience

- [React application](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/App.jsx): `front/src/App.jsx`
- [Browse articles](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/Blogs.jsx): `front/src/pages/Blogs.jsx`
- [Article detail](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/BlogDetail.jsx): `front/src/pages/BlogDetail.jsx`

### Identity and roles

- [Auth context](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/context/AuthContext.jsx): `front/src/context/AuthContext.jsx`
- [Auth routes](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Auth controller](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Auth middleware](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`

### Publishing and content

- [Blog context](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/context/BlogContext.jsx): `front/src/context/BlogContext.jsx`
- [Writer dashboard](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/WriterDashboard.jsx): `front/src/pages/WriterDashboard.jsx`
- [Article editor](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/CreateEditPost.jsx): `front/src/pages/CreateEditPost.jsx`
- [Admin dashboard](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/pages/AdminDashboard.jsx): `front/src/pages/AdminDashboard.jsx`
- [Blog routes](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/routes/blogRoutes.js): `server/routes/blogRoutes.js`
- [Blog controller](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/blogController.js): `server/controllers/blogController.js`

### Engagement services

- [Chatbot widget](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/front/src/components/ChatbotWidget.jsx): `front/src/components/ChatbotWidget.jsx`
- [Chatbot routes](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/modules/chatbot/chatbot.routes.js): `server/modules/chatbot/chatbot.routes.js`
- [Chatbot service](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/modules/chatbot/chatbot.service.js): `server/modules/chatbot/chatbot.service.js`
- [Notifications](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/controllers/notificationController.js): `server/controllers/notificationController.js`
- [Live delivery](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/utils/socket.js): `server/utils/socket.js`
- [Email delivery](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/utils/sendEmail.js): `server/utils/sendEmail.js`

### API and persistence

- [Express API](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/index.js): `server/index.js`
- [Blog records](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/models/Blog.js): `server/models/Blog.js`
- [User records](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/models/User.js): `server/models/User.js`
- [Notification records](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/models/Notification.js): `server/models/Notification.js`
- [Cloudinary storage](https://github.com/vijaykumar-devcode/nexo-blog/blob/main/server/utils/cloudinary.js): `server/utils/cloudinary.js`

### Other components

- **Readers**
- **Writers**
- **Administrators**
- **Google Gemini**
- **MongoDB**

## Connections

- Readers → React application: browse (evidence: `README.md`)
- Writers → React application: manage articles (evidence: `README.md`)
- Administrators → React application: manage platform (evidence: `README.md`)
- React application → Auth context: provides auth (evidence: `front/src/App.jsx`)
- React application → Blog context: provides blog state (evidence: `front/src/App.jsx`)
- React application → Browse articles: routes to (evidence: `front/src/App.jsx`)
- React application → Article detail: routes to (evidence: `front/src/App.jsx`)
- React application → Writer dashboard: routes to (evidence: `front/src/App.jsx`)
- React application → Article editor: routes to (evidence: `front/src/App.jsx`)
- React application → Admin dashboard: routes to (evidence: `front/src/App.jsx`)
- React application → Chatbot widget: mounts launcher (evidence: `front/src/App.jsx`)
- Auth context → Auth routes: calls auth API (evidence: `front/src/context/AuthContext.jsx`)
- Blog context → Auth context: uses auth state (evidence: `front/src/context/BlogContext.jsx`)
- Express API → Auth routes: registers (evidence: `server/index.js`)
- Express API → Blog routes: registers (evidence: `server/index.js`)
- Express API → Chatbot routes: registers (evidence: `server/index.js`)
- Express API → Notifications: initializes live service (evidence: `server/index.js`)
- Auth routes → Auth controller: routes requests (evidence: `server/routes/authRoutes.js`)
- Auth routes → Auth middleware: protects routes (evidence: `server/routes/authRoutes.js`)
- Auth controller → User records: reads and updates (evidence: `server/controllers/authController.js`)
- Auth controller → Email delivery: sends account email (evidence: `server/controllers/authController.js`)
- Blog routes → Blog controller: routes requests (evidence: `server/routes/blogRoutes.js`)
- Blog controller → Blog records: reads and writes (evidence: `server/controllers/blogController.js`)
- Blog controller → Notifications: creates alerts (evidence: `server/controllers/blogController.js`)
- Blog controller → Email delivery: sends publication email (evidence: `server/controllers/blogController.js`)
- Chatbot routes → Chatbot service: routes requests (evidence: `server/modules/chatbot/chatbot.routes.js`)
- Chatbot service → Google Gemini: queries AI (evidence: `README.md`)
- Chatbot service → Blog records: uses article context (evidence: `server/modules/chatbot/chatbot.controller.js`)
- Notifications → Notification records: creates and reads (evidence: `server/controllers/notificationController.js`)
- Notifications → Live delivery: pushes events (evidence: `server/controllers/notificationController.js`)
- Notifications → Email delivery: optionally emails (evidence: `server/controllers/notificationController.js`)
- Auth controller → User records: authenticates users (evidence: `server/controllers/authController.js`)
- Blog records → MongoDB: persists through Mongoose (evidence: `README.md`)
- User records → MongoDB: persists through Mongoose (evidence: `README.md`)
- Notification records → MongoDB: persists through Mongoose (evidence: `README.md`)
- Article editor → Cloudinary storage: uploads media
