# kuroganetoyama/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/kuroganetoyama/portfolio
- Repository: https://github.com/kuroganetoyama/portfolio

## Overview

##### Project type and purpose
- This is a full-stack (actually front-end only) React-based static/SSR website built on Next.js 13 (app directory).
- Purpose: a personal portfolio site to showcase skills, experience, projects, and other content.

##### File structure
- src/app: Next.js file-based routing. Each subfolder (about, clubs, experience, projects, volunteers) is a page.
- src/components: reusable UI pieces (buttons, cards, navigation, image captions, hyperlinks).
- src/data: static data modules that feed content into pages (projects.tsx, experiences.tsx, socials.tsx, etc.).
- public: static assets (images, orientation files, resume.pdf).
- Config files: tailwind.config.ts, postcss.config.mjs, tsconfig.json, next.config.mjs.
- package.json: lists React, Next.js, Tailwind CSS and any other dependencies.

##### README
- Very brief: “Personal Portfolio… showcase my skills and experience.”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Runtime
    Browser["User Browser"]:::runtime
    Server["Next.js 13 Server / CDN"]:::runtime

    %% App Router Pages
    subgraph "App Router (src/app)"
        direction TB
        Home["Home Page"]:::code
        About["About Page"]:::code
        Clubs["Clubs Page"]:::code
        Experience["Experience Page"]:::code
        Projects["Projects Page"]:::code
        Volunteers["Volunteers Page"]:::code
        NotFound["Not Found Page"]:::code
        Layout["Global Layout & Styles"]:::code
    end

    %% Component Library
    subgraph "Component Library (src/components)"
        direction TB
        Details["Details"]:::code
        Hyperlink["Hyperlink"]:::code
        ImgCap["ImageWithCaption"]:::code
        Btn["Button"]:::code
        BtnProj["ButtonProject"]:::code
        ExpCard["ExperienceCard"]:::code
        ProjCard["ProjectCard"]:::code
        Header["Header"]:::code
        Navbar["Navbar"]:::code
        Footer["Footer"]:::code
    end

    %% Data Layer
    subgraph "Data Layer (src/data)"
        direction TB
        PagesData["pages.tsx"]:::code
        Socials["socials.tsx"]:::code
        Skills["skills.tsx"]:::code
        ProjectsData["projects.tsx"]:::code
        Experiences["experiences.tsx"]:::code
        subgraph "Clubs Articles"
            direction TB
            Codey["CodeybotArticle.tsx"]:::code
            MathDev["MathsocWebDevArticle.tsx"]:::code
            MathMgr["MathsocWebManagerArticle.tsx"]:::code
            Term["TermSyscomArticle.tsx"]:::code
        end
    end

    %% Public Assets
    Asset["Public Assets (public/)"]:::asset

    %% Build & Deployment
    subgraph "Build & Deploy Pipeline"
        direction TB
        GitHub["GitHub"]:::external
        Vercel["Vercel CI/CD"]:::pipeline
        Tailwind["Tailwind CSS"]:::pipeline
        PostCSS["PostCSS"]:::pipeline
        NextBuild["Next.js Build"]:::pipeline
        TS["TypeScript Compiler"]:::pipeline
    end

    %% Connections
    Browser -->|"GET /"| Server
    Server -->|"resolve route"| Home
    Server -->|"resolve route"| About
    Server -->|"resolve route"| Clubs
    Server -->|"resolve route"| Experience
    Server -->|"resolve route"| Projects
    Server -->|"resolve route"| Volunteers
    Server -->|"resolve route"| NotFound

    Home -->|"uses component"| Details
    Home -->|"imports data"| PagesData

    About -->|"uses component"| Hyperlink
    About -->|"imports data"| Socials

    Projects -->|"uses component"| ProjCard
    Projects -->|"imports data"| ProjectsData

    Experience -->|"uses component"| ExpCard
    Experience -->|"imports data"| Experiences

    Clubs -->|"imports data"| Codey
    Clubs -->|"imports data"| MathDev
    Clubs -->|"imports data"| MathMgr
    Clubs -->|"imports data"| Term

    Layout -->|"applies styles"| Asset

    GitHub --> Vercel
    Vercel --> Tailwind --> PostCSS --> NextBuild --> Server
    Vercel --> Asset

    Server --> Asset

    %% Click Events - Pages
    click Home "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/page.tsx"
    click About "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/about/page.tsx"
    click Clubs "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/clubs/page.tsx"
    click Experience "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/experience/page.tsx"
    click Projects "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/projects/page.tsx"
    click Volunteers "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/volunteers/page.tsx"
    click NotFound "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/not-found.tsx"
    click Layout "https://github.com/kuroganetoyama/portfolio/blob/main/src/app/layout.tsx"
    click Asset "https://github.com/kuroganetoyama/portfolio/tree/main/public"

    %% Click Events - Components
    click Details "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/Details.tsx"
    click Hyperlink "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/Hyperlink.tsx"
    click ImgCap "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/ImageWithCaption.tsx"
    click Btn "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/button/Button.tsx"
    click BtnProj "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/button/ButtonProject.tsx"
    click ExpCard "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/cards/ExperienceCard.tsx"
    click ProjCard "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/cards/ProjectCard.tsx"
    click Header "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/navigation/Header.tsx"
    click Navbar "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/navigation/Navbar.tsx"
    click Footer "https://github.com/kuroganetoyama/portfolio/blob/main/src/components/navigation/Footer.tsx"

    %% Click Events - Data
    click PagesData "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/pages.tsx"
    click Socials "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/socials.tsx"
    click Skills "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/skills.tsx"
    click ProjectsData "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/projects.tsx"
    click Experiences "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/experiences.tsx"
    click Codey "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/clubs/CodeybotArticle.tsx"
    click MathDev "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/clubs/MathsocWebDevArticle.tsx"
    click MathMgr "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/clubs/MathsocWebManagerArticle.tsx"
    click Term "https://github.com/kuroganetoyama/portfolio/blob/main/src/data/clubs/TermSyscomArticle.tsx"

    %% Click Events - Pipeline Config
    click Tailwind "https://github.com/kuroganetoyama/portfolio/blob/main/tailwind.config.ts"
    click PostCSS "https://github.com/kuroganetoyama/portfolio/blob/main/postcss.config.mjs"
    click NextBuild "https://github.com/kuroganetoyama/portfolio/blob/main/next.config.mjs"
    click TS "https://github.com/kuroganetoyama/portfolio/blob/main/tsconfig.json"
    click GitHub "https://github.com/kuroganetoyama/portfolio/blob/main/package.json"

    %% Styles
    classDef runtime fill:#D0E7FF,stroke:#0366D6
    classDef code fill:#E8F5E9,stroke:#2E7D32
    classDef asset fill:#FFF8E1,stroke:#F9A825,stroke-dasharray: 5 5
    classDef pipeline fill:#E3F2FD,stroke:#1E88E5
    classDef external fill:#F3E5F5,stroke:#8E24AA
```
