# bhaskarrijal/hashnode-blog architecture

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

- Interactive diagram: https://gitdiagram.com/bhaskarrijal/hashnode-blog
- Repository: https://github.com/bhaskarrijal/hashnode-blog

## Overview

##### Project Type and Purpose
- This is a monorepo containing a headless‑blog starter kit: three Next.js + Tailwind front‑end “themes” (enterprise, hashnode, personal) that consume Hashnode’s public GraphQL API. There is no bespoke backend or database in this repo; instead, the app fetches content at build‑time (SSG) or run‑time (SSR) from the external headless CMS (Hashnode).

##### File‑Structure Analysis
- Root: configuration files (.editorconfig, .gitignore, Dockerfile, pnpm‑workspace.yaml).
- packages/
- blog‑starter‑kit/themes/{enterprise, hashnode, personal}: each is a self‑contained Next.js app with:
– pages/ (SSG/SSR pages, dynamic [slug] routes, API routes for OG image generation)
– components/, lib/api (GraphQL queries/fragments/mutations), generated/ (GraphQL codegen outputs)
– public/, styles/, utils/
- eslint‑config‑custom, tsconfig, utils: shared ESLint rules, TypeScript presets, utility functions (feed generator, markdown renderer, SEO helpers).

##### README Insights
- Purpose: deployable to Vercel (or Cloudflare Worker proxy) under a subpath or root domain.
- Workflow: select one theme at import, supply env vars (GQL endpoint, publication host, base URL, mode).
- At build: Next.js codegen runs, SSG pulls from Hashnode’s GraphQL API.
- At run‐time: Next.js serverless functions handle OG‑image endpoints and dynamic requests.

a. Main Components
- Monorepo Workspace (root)
- Shared Packages (eslint‑config‑custom, tsconfig, utils)
- Selected Theme App (Next.js frontend)
- External Service: Hashnode GraphQL API
- CI/CD & Hosting Platform: Vercel (build system, static/CDN, serverless)
- Optional Proxy Layer: Cloudflare Worker (subpath routing)
- Developer & GitHub (source control trigger)

b. Relationships & Data Flows
1. Developer commits → pushes to GitHub → Vercel CI triggers.
2. Build Step on Vercel:
– pnpm install monorepo → runs GraphQL Codegen → Next.js build
– SSG: Next.js fetches content from Hashnode GraphQL endpoint via lib/api queries.
– Generates static HTML, JSON, and serverless functions for API/OG routes.
3. Deploy: static assets + serverless functions to Vercel’s Edge CDN.
4. User Requests:
– Static page: served from CDN edge.
– Dynamic page/SSR: Edge function fetches from GraphQL API at request time if not pre‑built.
– API/OG routes: serverless function generates Open Graph images.
5. (Optional) Cloudflare Worker intercepts subpath requests → proxies to Vercel deployment → others pass through to origin.

c. Architectural Patterns & Principles
– Monorepo with PNPM workspaces for sharing code/config across themes
– GraphQL Code Generation for type safety & query management
– Next.js: static site generation (SSG), incremental/deferred rendering, serverless API routes
– Headless CMS consumption: decoupling content management from presentation
– CDN + serverless functions for global low‑latency delivery

d. Key Technologies
– Next.js (React, Pages, API routes)
– TypeScript, GraphQL, codegen.yml
– Tailwind CSS, postcss
– pnpm workspaces
– Vercel (CI/CD, Edge CDN, Functions)
– Cloudflare Workers (optional proxy)

## Diagram (Mermaid)

```mermaid
graph TB
    %% Actors
    DevGit["Developer / GitHub"]:::external
    User["End User"]:::external

    %% Monorepo Root and Shared Packages
    subgraph "Monorepo Root" 
        Monorepo["/"]:::code
        pnpm["pnpm-workspace.yaml"]:::code
        eslint["eslint-config-custom"]:::code
        tsconfigpkg["tsconfig"]:::code
        utilspkg["utils"]:::code
    end

    %% Theme Applications
    subgraph "Theme Apps (Next.js Frontends)" 
        subgraph "Enterprise Theme" 
            entRoot["enterprise (Next.js)"]:::code
            entPages["Pages (SSG/SSR & API)"]:::code
            entComp["Components"]:::code
            entCodegen["codegen.yml"]:::code
            entGen["generated/graphql.ts"]:::code
            entLib["lib/api"]:::code
        end
        subgraph "Hashnode Theme" 
            hashRoot["hashnode (Next.js)"]:::code
            hashPages["Pages (SSG/SSR & API)"]:::code
            hashComp["Components"]:::code
            hashCodegen["codegen.yml"]:::code
            hashGen["generated/graphql.ts"]:::code
            hashLib["lib/api"]:::code
        end
        subgraph "Personal Theme" 
            persRoot["personal (Next.js)"]:::code
            persPages["Pages (SSG/SSR & API)"]:::code
            persComp["Components"]:::code
            persCodegen["codegen.yml"]:::code
            persGen["generated/graphql.ts"]:::code
            persLib["lib/api"]:::code
        end
    end

    %% Infrastructure & Services
    Vercel["Vercel Build & Hosting"]:::infra
    Cloudflare["Cloudflare Worker (optional proxy)"]:::infra
    HashnodeAPI["Hashnode GraphQL API"]:::external

    %% Flows
    DevGit -->|"push code"| Vercel
    Vercel -->|"install & build monorepo"| Monorepo
    Monorepo --> pnpm
    Monorepo --> eslint
    Monorepo --> tsconfigpkg
    Monorepo --> utilspkg
    Monorepo --> entRoot
    Monorepo --> hashRoot
    Monorepo --> persRoot

    Vercel -->|"GraphQL Codegen"| entCodegen
    Vercel -->|"GraphQL Codegen"| hashCodegen
    Vercel -->|"GraphQL Codegen"| persCodegen
    Vercel -->|"Next.js Build (SSG)"| entPages
    Vercel -->|"Next.js Build (SSG)"| hashPages
    Vercel -->|"Next.js Build (SSG)"| persPages
    entPages -->|"SSG fetch"| HashnodeAPI
    hashPages -->|"SSG fetch"| HashnodeAPI
    persPages -->|"SSG fetch"| HashnodeAPI

    %% Deployment
    Vercel -->|"deploy static + functions"| CDN[Vercel Edge CDN]:::infra
    User --> CDN
    User -->|"dynamic request"| CDN --> Vercel
    Vercel -->|"SSR fetch"| HashnodeAPI
    Vercel -->|"API/OG routes"| HashnodeAPI

    %% Optional Proxy
    User --> Cloudflare
    Cloudflare --> Vercel

    %% Click Events
    click Monorepo "https://github.com/bhaskarrijal/hashnode-blog/tree/main//"
    click pnpm "https://github.com/bhaskarrijal/hashnode-blog/blob/main/pnpm-workspace.yaml"
    click eslint "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/eslint-config-custom"
    click tsconfigpkg "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/tsconfig"
    click utilspkg "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/utils"
    click entRoot "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/enterprise"
    click entPages "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/enterprise/pages"
    click entComp "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/enterprise/components"
    click entCodegen "https://github.com/bhaskarrijal/hashnode-blog/blob/main/packages/blog-starter-kit/themes/enterprise/codegen.yml"
    click entGen "https://github.com/bhaskarrijal/hashnode-blog/blob/main/packages/blog-starter-kit/themes/enterprise/generated/graphql.ts"
    click entLib "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/enterprise/lib/api"
    click hashRoot "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/hashnode"
    click hashPages "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/hashnode/pages"
    click hashComp "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/hashnode/components"
    click hashCodegen "https://github.com/bhaskarrijal/hashnode-blog/blob/main/packages/blog-starter-kit/themes/hashnode/codegen.yml"
    click hashGen "https://github.com/bhaskarrijal/hashnode-blog/blob/main/packages/blog-starter-kit/themes/hashnode/generated/graphql.ts"
    click hashLib "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/hashnode/lib/api"
    click persRoot "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/personal"
    click persPages "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/personal/pages"
    click persComp "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/personal/components"
    click persCodegen "https://github.com/bhaskarrijal/hashnode-blog/blob/main/packages/blog-starter-kit/themes/personal/codegen.yml"
    click persGen "https://github.com/bhaskarrijal/hashnode-blog/blob/main/packages/blog-starter-kit/themes/personal/generated/graphql.ts"
    click persLib "https://github.com/bhaskarrijal/hashnode-blog/tree/main/packages/blog-starter-kit/themes/personal/lib/api"

    %% Styles
    classDef code fill:#E0F7FA,stroke:#006064
    classDef infra fill:#E8F5E9,stroke:#1B5E20
    classDef external fill:#FFF3E0,stroke:#E65100
```
