# grtsinry43/grtsinry43-resume architecture

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

- Interactive diagram: https://gitdiagram.com/grtsinry43/grtsinry43-resume
- Repository: https://github.com/grtsinry43/grtsinry43-resume

## Overview

##### Project type and purpose
- This is a single-page resume web application built with Next.js 13 (App Router) and TypeScript.
- Its sole responsibility is to read resume data (in a Markdown/YAML file), parse it, and render a styled HTML/CSS/JS page.
- It is deployed as a static/SSR site (via Vercel) and has no separate backend service.

##### File structure
- Top-level config files: package.json, tsconfig.json, next.config.ts, tailwind.config.js, pnpm-lock.yaml.
- `/src/app` holds your App Router:
- layout.tsx – common layout (head, header, footer).
- page.tsx – the home/resume page entry point.
- `/src/components/ui` contains reusable UI primitives (Badge, Card).
- `/src/lib` holds utility modules:
- resume-parser.ts – reads and parses `src/resume-data.md`.
- `src/resume-data.md` – data source in Markdown with embedded YAML.
- Public/static assets under `/public`.

##### README for additional insights
- It calls out technologies: Next.js, TypeScript, Tailwind CSS, Headless UI.
- Data is loaded at build time or SSR via the custom resume-parser.
- Deployment uses Vercel, producing a fully static/SSR-optimized site.

##### Elements
- Data → Parser → Page → Browser
- Build Pipeline → Vercel → Browser
- Logic layer (e.g., green rectangle)
- Presentation layer (e.g., orange rectangle)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Layer
    subgraph "Data Layer"
        DS(("Resume Data\n(src/resume-data.md)")):::data
    end

    %% Logic Layer
    subgraph "Logic Layer"
        PM["Parser Module\n(src/lib/resume-parser.ts)"]:::logic
        UH1["Styling Helpers\n(src/lib/color-system.ts)"]:::logic
        UH2["General Helpers\n(src/lib/utils.ts)"]:::logic
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        subgraph "Next.js App Router"
            RL["Root Layout\n(src/app/layout.tsx)"]:::presentation
            HP["Home/Resume Page\n(src/app/page.tsx)"]:::presentation
            GS["Global Styles\n(src/app/globals.css)"]:::presentation
        end
        subgraph "UI Components"
            UIC1["Badge Component\n(src/components/ui/badge.tsx)"]:::presentation
            UIC2["Card Component\n(src/components/ui/card.tsx)"]:::presentation
        end
    end

    %% Styling Engine Config
    subgraph "Styling Engine Config"
        TC["Tailwind Config\n(tailwind.config.js)"]:::config
        PC["PostCSS Config\n(postcss.config.mjs)"]:::config
    end

    %% Framework & Build Config
    subgraph "Framework & Build Config"
        NC["Next.js Config\n(next.config.ts)"]:::config
        TSC["TypeScript Config\n(tsconfig.json)"]:::config
        PMG["Package Manager Config\n(package.json)"]:::config
        PL["Lockfile\n(pnpm-lock.yaml)"]:::config
    end

    %% Deployment & Runtime
    subgraph "Deployment & Runtime"
        BP["Build Pipeline\n(pnpm/Next.js build)"]:::external
        VL([Vercel CDN & SSR]):::external
        BR[Browser]:::external
        PUB["Public Assets\n(public/)"]:::external
    end

    %% Flow Connections
    DS -->|"read at build time"| PM
    PM -->|"uses"| UH1
    PM -->|"uses"| UH2
    PM -->|"generates props for"| HP
    TC -->|"generates CSS"| GS
    PC -->|"post-processes CSS"| GS
    RP(Build Pipeline):::external
    BP -->|"includes"| NC
    BP -->|"includes"| TSC
    BP -->|"includes"| PMG
    BP -->|"includes"| PL
    BP -->|"processes"| DS
    BP -->|"calls"| PM
    BP -->|"bundles"| RL
    BP -->|"bundles"| HP
    BP -->|"bundles"| GS
    BP -->|"bundles"| UIC1
    BP -->|"bundles"| UIC2
    BP -->|"deploys to"| VL
    PUB -->|"host static assets"| VL
    BR -->|"requests “/”"| VL
    VL -->|"serves HTML/CSS/JS"| BR

    %% Click Events
    click DS "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/resume-data.md"
    click PM "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/lib/resume-parser.ts"
    click UH1 "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/lib/color-system.ts"
    click UH2 "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/lib/utils.ts"
    click RL "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/app/layout.tsx"
    click HP "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/app/page.tsx"
    click GS "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/app/globals.css"
    click UIC1 "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/components/ui/badge.tsx"
    click UIC2 "https://github.com/grtsinry43/grtsinry43-resume/blob/main/src/components/ui/card.tsx"
    click TC "https://github.com/grtsinry43/grtsinry43-resume/blob/main/tailwind.config.js"
    click PC "https://github.com/grtsinry43/grtsinry43-resume/blob/main/postcss.config.mjs"
    click NC "https://github.com/grtsinry43/grtsinry43-resume/blob/main/next.config.ts"
    click TSC "https://github.com/grtsinry43/grtsinry43-resume/blob/main/tsconfig.json"
    click PMG "https://github.com/grtsinry43/grtsinry43-resume/blob/main/package.json"
    click PL "https://github.com/grtsinry43/grtsinry43-resume/blob/main/pnpm-lock.yaml"
    click PUB "https://github.com/grtsinry43/grtsinry43-resume/tree/main/public/"

    %% Styles
    classDef data fill:#cce5ff,stroke:#005cbf,color:#005cbf
    classDef logic fill:#d4edda,stroke:#155724,color:#155724
    classDef presentation fill:#fff3cd,stroke:#856404,color:#856404
    classDef config fill:#e2e3e5,stroke:#6c757d,color:#6c757d
    classDef external fill:#f8d7da,stroke:#721c24,color:#721c24
```
