# vivek9patel/basic-personal-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/vivek9patel/basic-personal-portfolio
- Repository: https://github.com/vivek9patel/basic-personal-portfolio

## Overview

##### Project type and purpose
- This is a full-stack, content-driven portfolio built with Next.js (React framework) and styled with Tailwind CSS.
- It serves static content (blogs via MDX, projects via JSON), dynamic pages (SSR/SSG), client-side interactivity (React components, context), and lightweight backend API routes for likes, stars, session deletion, contact form, plus optional video conferencing integration.

##### File structure
- Top-level “pages” folder: defines routes for the website (index, blogs, projects, resume, tars).
- pages/api contains the serverless functions (auth via NextAuth, fetchLikes, incrementLikes, email form, deleteTarsSession).
- MDX files under “blogs” directory for blog content.
- “components” folder: presentational React components (Header, Footer, BlogPost, ProjectCard, LikeCounter, etc.).
- “context”: React Context provider for global state (e.g., likes, theme).
- “data”: static JSON for listing projects.
- “helpers”: shared utility functions.
- “public” and “fonts”: static assets (images, fonts, meta files).
- Configuration files: next.config.js, tailwind.config.js, postcss.config.js, tsconfig.json.

##### README for additional insights
- Uses NextAuth for authentication.
- Uses EmailJS service for contact form (via environment variables).
- Offers an alternate “video-call” branch integrating 100ms.live (external video-conferencing API).

## Diagram (Mermaid)

```mermaid
graph TB
    %% Client
    Browser["Client Browser"]:::external

    %% Frontend
    subgraph "Frontend (Next.js Pages & React UI)"
        direction TB
        Home["Home Page<br>(index.tsx)"]:::frontend
        BlogList["Blog List<br>(blogs/index.tsx)"]:::frontend
        BlogPost["Blog Post<br>(blogs/[slug].tsx)"]:::frontend
        Projects["Projects Page<br>(projects/index.tsx)"]:::frontend
        Resume["Resume Page<br>(resume/index.tsx)"]:::frontend
        TarsPage["TARS Chat Page<br>(tars/index.tsx)"]:::frontend

        subgraph "Components"
            direction TB
            Header["Header"]:::frontend
            Footer["Footer"]:::frontend
            BlogPostComp["BlogPost"]:::frontend
            MarkdownData["MarkdownData"]:::frontend
            CustomHtml["CustomHtml"]:::frontend
            ProjectCard["ProjectCard"]:::frontend
            LikeCounter["LikeCounter"]:::frontend
            EmailBox["EmailBox"]:::frontend
            AskTarsButton["AskTarsButton"]:::frontend
            Avatar["Avatar"]:::frontend
            Cursor["Cursor"]:::frontend
            MetaTags["MetaTags"]:::frontend
        end

        Context["React Context<br>(context/index.tsx)"]:::frontend
    end

    %% Serverless API
    subgraph "Serverless API (Next.js)" 
        direction TB
        Auth["NextAuth<br>(...[...nextauth].ts)"]:::serverless
        FetchLikes["/api/fetchLikes"]:::serverless
        IncrementLikes["/api/incrementLikes"]:::serverless
        FetchStars["/api/fetchStars"]:::serverless
        DeleteSession["/api/deleteTarsSession"]:::serverless
        SendEmail["/api/sendEmail"]:::serverless
    end

    %% Static Content Store
    subgraph "Static Content Store"
        direction TB
        Blogs["Blog MDX Files"]:::static
        ProjectsJSON["projects.json"]:::static
        PublicAssets["public/"]:::static
        Fonts["fonts/"]:::static
    end

    %% External Services
    subgraph "External Services"
        direction TB
        EmailJS["EmailJS Service"]:::external
        VideoSvc["100ms.live"]:::external
        Identity["Identity Providers"]:::external
    end

    %% Interactions
    Browser -->|requests HTML| Home
    Browser -->|requests HTML| BlogList
    Browser -->|requests HTML| BlogPost
    Browser -->|requests HTML| Projects
    Browser -->|requests HTML| Resume
    Browser -->|requests HTML| TarsPage

    Home -->|"SSR/SSG"| Blogs
    BlogList -->|"SSG uses MDX index"| Blogs
    BlogPost -->|"SSG uses MDX"| Blogs
    Projects -->|"SSG uses JSON"| ProjectsJSON

    Home --> Header
    Home --> Footer
    BlogList --> Header
    BlogList --> Footer
    BlogPostComp --> MarkdownData
    BlogPostComp --> CustomHtml

    LikeCounter --> FetchLikes
    LikeCounter --> IncrementLikes

    EmailBox --> SendEmail
    SendEmail --> EmailJS

    AskTarsButton --> DeleteSession
    TarsPage --> AskTarsButton
    TarsPage --> DeleteSession
    TarsPage --> VideoSvc

    Auth --> Identity

    %% Flows to API from Frontend
    LikeCounter --> FetchLikes
    LikeCounter --> IncrementLikes
    EmailBox --> SendEmail
    Auth -->|"client SDK"| Browser

    %% Click Events
    click Home "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/index.tsx"
    click BlogList "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/blogs/index.tsx"
    click BlogPost "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/blogs/[slug].tsx"
    click Projects "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/projects/index.tsx"
    click Resume "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/resume/index.tsx"
    click TarsPage "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/tars/index.tsx"
    click Auth "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/api/auth/[...nextauth].ts"
    click FetchLikes "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/api/fetchLikes.ts"
    click IncrementLikes "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/api/incrementLikes.ts"
    click FetchStars "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/api/fetchStars.ts"
    click DeleteSession "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/pages/api/deleteTarsSession.ts"
    click Blogs "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/blogs/sample.mdx"
    click ProjectsJSON "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/data/projects.json"
    click PublicAssets "https://github.com/vivek9patel/basic-personal-portfolio/tree/main/public/"
    click Fonts "https://github.com/vivek9patel/basic-personal-portfolio/tree/main/fonts/"
    click Context "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/context/index.tsx"
    click Header "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/Header.tsx"
    click Footer "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/Footer.tsx"
    click BlogPostComp "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/BlogPost.tsx"
    click MarkdownData "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/MarkdownData.tsx"
    click CustomHtml "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/CustomHtml.tsx"
    click ProjectCard "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/ProjectCard.tsx"
    click LikeCounter "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/LikeCounter.tsx"
    click EmailBox "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/EmailBox.tsx"
    click AskTarsButton "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/AskTarsButton.tsx"
    click Avatar "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/Avatar.tsx"
    click Cursor "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/Cursor.tsx"
    click MetaTags "https://github.com/vivek9patel/basic-personal-portfolio/blob/main/components/meta/MetaTags.tsx"

    %% Styles
    classDef frontend fill:#cfe2ff,stroke:#1f4e78,stroke-width:1px,color:#1f4e78
    classDef serverless fill:#fff2cc,stroke:#7a6000,stroke-width:1px,color:#7a6000
    classDef static fill:#d9ead3,stroke:#38761d,stroke-width:1px,color:#38761d
    classDef external fill:#e0e0e0,stroke:#666666,stroke-width:1px,color:#666666
```
