# pulkitgarg04/bloguer architecture

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

- Interactive diagram: https://gitdiagram.com/pulkitgarg04/bloguer
- Repository: https://github.com/pulkitgarg04/bloguer

## Overview

##### Main Components

a) Client-Side (Frontend Layer):
- User Interface Components (Pages)
- State Management (Zustand)
- Router (React Router)
- API Client (Axios)

b) Server-Side (Backend Layer):
- API Routes (Hono Framework)
- Authentication Middleware
- Request Validation Layer

c) Database Layer:
- Prisma ORM as an intermediate layer

##### Specific Implementation Details

Frontend Section:
**┌─ React Frontend ─────────────────┐**
- Pages                         │
- Home/Blog/Profile         │
- Auth (Login/Signup)       │
- Components                    │
- Navbar/Footer             │
- Newsletter                │
- Zustand Store                │
- ┘

Backend Section:
**┌─ Cloudflare Workers ────────────┐**
- API Routes                   │
- blog.route.ts            │
- user.route.ts            │
- Auth Middleware             │
- Validation Layer            │
- ┘

##### Important Elements to Highlight

a) Security Layer:
- JWT authentication flow
- Middleware protection
- Validation checks

b) Data Flow:
- Blog post creation/editing
- User authentication
- Content delivery
- Image handling

c) State Management:
- Zustand store interactions
- Server-state synchronization

##### Technical Details to Note

Environment Integration:
- Configuration flow for environment variables
- Deployment endpoints
- Database connection handling

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and Classes
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef database fill:#f1c40f,stroke:#f39c12,color:black
    classDef security fill:#e74c3c,stroke:#c0392b,color:white
    classDef external fill:#9b59b6,stroke:#8e44ad,color:white

    %% Frontend Layer
    subgraph Frontend
        UI[UI Components]
        Pages[Pages]
        State[State Management]
        Router[React Router]
        APIClient[API Client]
        
        %% Frontend Components
        UI --> Nav[Navigation]
        UI --> News[Newsletter]
        UI --> Foot[Footer]
        
        %% Pages Components
        Pages --> Auth[Auth Pages]
        Pages --> Blog[Blog Pages]
        Pages --> Prof[Profile]
        
        %% Auth Pages
        Auth --> Login[Login Page]
        Auth --> Signup[Signup Page]
        
        %% Blog Pages
        Blog --> Write[Write Post]
        Blog --> Edit[Edit Post]
        Blog --> View[Blog View]
    end

    %% Backend Layer
    subgraph Backend
        Worker[Cloudflare Workers]
        Routes[API Routes]
        Auth_Mid[Auth Middleware]
        Valid[Validation Layer]
        
        Worker --> Routes
        Routes --> BlogRoutes[Blog Routes]
        Routes --> UserRoutes[User Routes]
        
        Auth_Mid --> Routes
        Valid --> Routes
    end

    %% Database Layer
    subgraph Database
        Prisma[Prisma ORM]
        PostgreSQL[(PostgreSQL)]
        Schema[Database Schema]
        Migrations[Database Migrations]
        
        Prisma --> PostgreSQL
        Schema --> Prisma
        Migrations --> Schema
    end

    %% Connections between layers
    APIClient <--> Routes
    Routes <--> Prisma

    %% Click Events
    click Pages "https://github.com/pulkitgarg04/bloguer/tree/main/client/src/pages"
    click UI "https://github.com/pulkitgarg04/bloguer/tree/main/client/src/components"
    click State "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/store/authStore.ts"
    click Nav "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/components/Navbar.tsx"
    click News "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/components/Newsletter.tsx"
    click Foot "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/components/Footer.tsx"
    click Routes "https://github.com/pulkitgarg04/bloguer/tree/main/server/src/routes"
    click BlogRoutes "https://github.com/pulkitgarg04/bloguer/blob/main/server/src/routes/blog.route.ts"
    click UserRoutes "https://github.com/pulkitgarg04/bloguer/blob/main/server/src/routes/user.route.ts"
    click Auth_Mid "https://github.com/pulkitgarg04/bloguer/blob/main/server/src/middlewares/authMiddleware.ts"
    click Valid "https://github.com/pulkitgarg04/bloguer/blob/main/validations/src/index.ts"
    click Schema "https://github.com/pulkitgarg04/bloguer/blob/main/server/prisma/schema.prisma"
    click Migrations "https://github.com/pulkitgarg04/bloguer/tree/main/server/prisma/migrations"
    click Worker "https://github.com/pulkitgarg04/bloguer/blob/main/server/src/index.ts"
    click UI "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/App.tsx"
    click Login "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/pages/Login.tsx"
    click Signup "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/pages/Signup.tsx"
    click Write "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/pages/WritePost.tsx"
    click Edit "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/pages/EditPost.tsx"
    click View "https://github.com/pulkitgarg04/bloguer/blob/main/client/src/pages/BlogPage.tsx"

    %% Style Applications
    class UI,Pages,State,Router,APIClient,Nav,News,Foot,Auth,Blog,Prof,Login,Signup,Write,Edit,View frontend
    class Worker,Routes,Auth_Mid,Valid,BlogRoutes,UserRoutes backend
    class Prisma,PostgreSQL,Schema,Migrations database
    class Auth_Mid security
```
