# tanmay-panday/blogs-website architecture

> Architecture diagram of the GitHub repository tanmay-panday/blogs-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tanmay-panday/blogs-website
- Repository: https://github.com/tanmay-panday/blogs-website

## Overview

##### Project type and purpose
- This is a full-stack MERN (MongoDB, Express, React, Node.js) blog platform (“Blogs World”) with two user roles (Users and Admins). Users can perform CRUD on their own blogs; Admins manage all content and view analytics.

##### File structure
- Two top-level directories:
- frontend/ – React + Vite UI, organized into assets, components, pages, context, utils
- backend/ – Node.js + Express API, organized into config, controllers, middleware, models, routes
- Config files: package.json in each, ESLint, Tailwind, Vercel config in backend

##### Extract key architecture insights from the README
- Frontend communicates via Axios to REST API at /api/**
- Auth: JWT tokens, bcrypt; role-based middleware for protected routes
- File uploads: Multer → Cloudinary
- Data store: MongoDB via Mongoose
- Deployment: Vercel for both frontend and backend

##### Main components
a. Frontend (React App)
- UI components & pages (e.g., SignIn, BlogsPage, AdminDashboard)
- State & routing (React Router, BlogContext, ProtectedRoutes)
- REST client (Axios)
b. Backend (Express Server)
- Entry point (server.js)
- Routes layer (userRoutes, blogRoutes)
- Controllers (userController, blogController)
- Middleware (authUser, authAdmin, multer)
- Config (MongoDB connector, Cloudinary connector)
c. Database
- MongoDB (User and BlogPost collections via Mongoose ODM)
d. External service
- Cloudinary for image hosting
e. Deployment & environment
- Vercel (CI/CD)
- .env for secrets (JWT_SECRET, MONGODB_URI, Cloudinary creds)

##### Relationships and data flows
1. Browser → React App
2. React App sends HTTP requests (GET/POST/DELETE) to Express API
3. Express middleware verifies JWT, handles file uploads, passes to controllers
4. Controllers execute business logic, call Mongoose models
5. Models interact with MongoDB
6. File uploads: Multer → Cloudinary API → store image URL in MongoDB
7. API responses back to React UI
8. Role-based routes: ProtectedRoutes wrapper on the frontend; authUser/authAdmin on backend

##### Architectural patterns & principles
- MVC-like layering in the backend (Routes → Controllers → Models)
- Single-Page App on the frontend, with Context API for global state
- Separation of concerns: UI vs. API vs. data vs. external services
- Stateless API with JWT for authentication
- Service isolation: Cloudinary as dedicated file storage service

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    User["User"]:::external
    Admin["Admin"]:::external

    %% Frontend Tier
    subgraph "Frontend (React App)" 
        direction TB
        AppEntry["App (App.jsx)"]:::frontend
        Main["Entry (main.jsx)"]:::frontend
        subgraph "Pages" 
            direction TB
            Pages["Pages"]:::frontend
        end
        subgraph "UI Components"
            direction TB
            Components["Components"]:::frontend
        end
        subgraph "Context & State"
            direction TB
            BlogContext["BlogContext"]:::frontend
        end
        subgraph "Routing & Utils"
            direction TB
            ProtectedRoutes["ProtectedRoutes"]:::frontend
        end
        AxiosClient["Axios Client"]:::frontend
    end

    %% Backend Tier
    subgraph "Backend (Express API)"
        direction TB
        server["Server (server.js)"]:::backend
        subgraph "Config"
            direction TB
            mongoConfig["MongoDB Config"]:::backend
            cloudConfig["Cloudinary Config"]:::backend
        end
        subgraph "Middleware"
            direction TB
            authUser["authUser"]:::backend
            authAdmin["authAdmin"]:::backend
            multer["Multer Upload"]:::backend
        end
        subgraph "Routes"
            direction TB
            userRoutes["User Routes"]:::backend
            blogRoutes["Blog Routes"]:::backend
        end
        subgraph "Controllers"
            direction TB
            userController["UserController"]:::backend
            blogController["BlogController"]:::backend
        end
        subgraph "Models"
            direction TB
            userModel["UserModel"]:::backend
            blogPostModel["BlogPostModel"]:::backend
        end
    end

    %% Data Stores and External Services
    MongoDB[(MongoDB)]:::database
    Cloudinary((Cloudinary)):::externalService

    %% Deployment
    Vercel((Vercel)):::deployment

    %% Connections
    User -->|uses UI| AppEntry
    Admin -->|uses UI| AppEntry
    AppEntry -->|"renders Pages/Components"| Pages
    AppEntry -->|"renders Pages/Components"| Components
    Pages --> BlogContext
    Components --> BlogContext
    BlogContext --> ProtectedRoutes
    ProtectedRoutes --> AppEntry
    AppEntry --> AxiosClient
    AxiosClient -->|HTTP /api| server

    server --> mongoConfig
    server --> cloudConfig
    server --> authUser
    server --> authAdmin
    server --> multer
    authUser --> userRoutes
    authAdmin --> userRoutes
    multer --> blogRoutes
    userRoutes --> userController
    blogRoutes --> blogController
    userController --> userModel
    blogController --> blogPostModel
    userModel --> MongoDB
    blogPostModel --> MongoDB
    multer -->|uploads| Cloudinary
    Cloudinary -->|returns URL| blogController

    Vercel --- AppEntry
    Vercel --- server

    %% Click Events
    click Pages "https://github.com/tanmay-panday/blogs-website/tree/main/frontend/src/pages"
    click Components "https://github.com/tanmay-panday/blogs-website/tree/main/frontend/src/components"
    click BlogContext "https://github.com/tanmay-panday/blogs-website/blob/main/frontend/src/context/BlogContext.jsx"
    click ProtectedRoutes "https://github.com/tanmay-panday/blogs-website/blob/main/frontend/src/utils/ProtectedRoutes.jsx"
    click Main "https://github.com/tanmay-panday/blogs-website/blob/main/frontend/src/main.jsx"
    click AppEntry "https://github.com/tanmay-panday/blogs-website/blob/main/frontend/src/App.jsx"
    click server "https://github.com/tanmay-panday/blogs-website/blob/main/backend/server.js"
    click mongoConfig "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/config/mongoDB.js"
    click cloudConfig "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/config/cloudinary.js"
    click authUser "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/middleware/authUser.js"
    click authAdmin "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/middleware/authAdmin.js"
    click multer "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/middleware/multer.js"
    click userRoutes "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/routes/userRoutes.js"
    click blogRoutes "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/routes/blogRoutes.js"
    click userController "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/controllers/userController.js"
    click blogController "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/controllers/blogController.js"
    click userModel "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/models/userModel.js"
    click blogPostModel "https://github.com/tanmay-panday/blogs-website/blob/main/backend/src/models/blogPostModel.js"
    click Vercel "https://github.com/tanmay-panday/blogs-website/blob/main/backend/vercel.json"
    click Main "https://github.com/tanmay-panday/blogs-website/blob/main/frontend/vite.config.js"
    click ArchDiagrams "https://github.com/tanmay-panday/blogs-website/blob/main/Architechture Diagrams/Backend.drawio"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085
    classDef backend fill:#d4edda,stroke:#155724,color:#155724
    classDef database fill:#fff3cd,stroke:#856404,color:#856404
    classDef externalService fill:#e2e3e5,stroke:#6c757d,color:#6c757d
    classDef external fill:#f8d7da,stroke:#721c24,color:#721c24
    classDef deployment fill:#d1ecf1,stroke:#0c5460,color:#0c5460
```
