# jeongminsang/next-blog architecture

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

- Interactive diagram: https://gitdiagram.com/jeongminsang/next-blog
- Repository: https://github.com/jeongminsang/next-blog

## Overview

##### Project Type Analysis
This is a full-stack blog application built with Next.js 13+ (evidenced by the app directory structure), utilizing the App Router pattern. It's a modern web application that serves blog posts written in MDX format.

##### Main Components

A. Client-Side Layer:
- Pages (Home, Blog, Projects)
- Components (Header, Footer, Carousel, etc.)
- Styling (Styled-Components)

B. Server-Side Layer:
- Next.js App Router
- MDX Processing
- API Handlers

C. Content Management:
- MDX Files Storage
- Static Assets (Images)

**[Client Layer]**
- ↑↓
**[Next.js App Router]**
- ↑↓
**[Server Components]**
- ↑↓
**[Content Layer]**

##### Specific Elements

a) Client Layer (Top):
- Shared components (Header.tsx, Footer.tsx)
- Client-side features (ReadingProgressBar, Modal)

b) Routing Layer:
- Next.js App Router structure
- Dynamic routes ([postId])
- To API handlers

c) Server Components Layer:
- MDX processing pipeline (markdownToHtml.ts)
- API utilities (api.ts)
- Data fetching operations

d) Content Management Layer (Bottom):
- MDX files storage (/content/blog)
- Static assets (/public/projectimg)

##### Important Connections to Highlight
- MDX content flow to blog posts
- Component composition hierarchy
- Data fetching paths
- Static asset delivery

##### Technical Stack Indicators
- TypeScript
- React/Next.js
- Styled-Components
- MDX Processing

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        Home["Home Page"]
        Blog["Blog Page"]
        Projects["Projects Page"]
        DynamicPost["Dynamic Blog Post"]
        
        subgraph SharedComponents
            Header["Header"]
            Footer["Footer"]
            Modal["Modal System"]
            TOC["Table of Contents"]
            Progress["Reading Progress"]
            ProjectCard["Project Card"]
            Comments["Giscus Comments"]
        end
    end

    subgraph Router
        AppRouter["App Router Layout"]
        Registry["Styled Components Registry"]
    end

    subgraph Server
        MDXProcessor["MDX Processor"]
        APIUtils["API Utilities"]
        ImgHandler["Project Images Handler"]
    end

    subgraph Content
        BlogPosts["Blog Posts Storage"]
        StaticImg["Static Project Images"]
        Styles["Global Styles"]
    end

    %% Relationships
    AppRouter --> Home
    AppRouter --> Blog
    AppRouter --> Projects
    AppRouter --> DynamicPost

    Home & Blog & Projects & DynamicPost --> SharedComponents
    
    MDXProcessor --> DynamicPost
    APIUtils --> DynamicPost
    ImgHandler --> ProjectCard
    
    BlogPosts --> MDXProcessor
    StaticImg --> ImgHandler
    
    Registry --> SharedComponents
    Styles --> SharedComponents

    %% Click Events
    click Home "https://github.com/jeongminsang/next-blog/blob/main/app/page.tsx"
    click Blog "https://github.com/jeongminsang/next-blog/blob/main/app/blog/page.tsx"
    click Projects "https://github.com/jeongminsang/next-blog/blob/main/app/projects/page.tsx"
    click DynamicPost "https://github.com/jeongminsang/next-blog/blob/main/app/blog/[postId]/page.tsx"
    click Header "https://github.com/jeongminsang/next-blog/blob/main/app/components/Header.tsx"
    click Footer "https://github.com/jeongminsang/next-blog/blob/main/app/components/Footer.tsx"
    click Modal "https://github.com/jeongminsang/next-blog/blob/main/app/components/Modal.tsx"
    click TOC "https://github.com/jeongminsang/next-blog/blob/main/app/components/TOC.tsx"
    click Progress "https://github.com/jeongminsang/next-blog/blob/main/app/components/ReadingProgressBar.tsx"
    click ProjectCard "https://github.com/jeongminsang/next-blog/blob/main/app/components/ProjectCard.tsx"
    click Comments "https://github.com/jeongminsang/next-blog/blob/main/app/components/Giscus.tsx"
    click AppRouter "https://github.com/jeongminsang/next-blog/blob/main/app/layout.tsx"
    click Registry "https://github.com/jeongminsang/next-blog/blob/main/app/registry.tsx"
    click MDXProcessor "https://github.com/jeongminsang/next-blog/blob/main/app/libs/markdownToHtml.ts"
    click APIUtils "https://github.com/jeongminsang/next-blog/blob/main/app/libs/api.ts"
    click ImgHandler "https://github.com/jeongminsang/next-blog/blob/main/app/libs/ProjectImgs.ts"
    click BlogPosts "https://github.com/jeongminsang/next-blog/tree/main/app/content/blog"
    click StaticImg "https://github.com/jeongminsang/next-blog/tree/main/public/projectimg"
    click Styles "https://github.com/jeongminsang/next-blog/blob/main/app/styles/globals.css"

    %% Styling
    classDef client fill:#a8d1ff,stroke:#333
    classDef server fill:#90EE90,stroke:#333
    classDef router fill:#FFE5B4,stroke:#333
    classDef content fill:#DDA0DD,stroke:#333
    
    class Home,Blog,Projects,DynamicPost,SharedComponents client
    class AppRouter,Registry router
    class MDXProcessor,APIUtils,ImgHandler server
    class BlogPosts,StaticImg,Styles content
```
