# ymumberson/tailwind-portfolio architecture

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

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

## Overview

##### Project Type and Purpose
- This is a full-stack (front-end-centric) static/dynamic site built with Next.js, styled with Tailwind CSS, and deployed on Vercel.
- It serves as a personal portfolio and sandbox for small web projects (e.g., digit classifier, tic-tac-toe, weather app).

##### File Structure
- src/app – App Router layout, global CSS, shared React components, and page definitions.
– components: reusable UI pieces (Card, Navbar, Project)
– sections: page sections (HeroSection, CommitGraph, Experience, Overview)
– projects: individual interactive demos under their own directories
- public – static assets (images, TensorFlow.js model files for digit classification)
- Configuration – next.config.ts, tailwind.config.ts, postcss.config.mjs, tsconfig.json
- Deployment – no custom backend; Next.js handles SSR/SSG and client-side hydration; Vercel hosts.

##### README
- Confirms Next.js + Vercel, plus small interactive demos.
- No external internal database; any data (e.g., weather) is fetched at runtime from public APIs.

##### Main Components
a. Next.js Server/Build Pipeline
– SSR/SSG process, routing via src/app
– Build step (PostCSS, Tailwind)
b. Client (Browser)
– Renders React components, executes interactive logic (TensorFlow.js, tic-tac-toe state, weather API fetch)
c. Public CDN (Vercel Hosting)
– Serves built pages & static assets (SVGs, model.json, .bin files)
d. External Services
– Weather API (if used)
e. Static Asset Store
– Public folder for static ML models and images

##### Relationships and Interactions
- Build → Vercel CI/CD → Static & SSR pages → CDN
- Client HTTP GETs page → Next.js SSR/SSG → Browser
- Browser loads TensorFlow.js model from /public → runs inference
- Browser fetches weather data from external API

##### Architectural Patterns & Design Principles
- App Router (file-based routing)
- Component-based UI
- Static-first deployment with selective dynamic hydration
- Separation of concerns: “components” vs “sections” vs “projects”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Build & Deployment Layer
    subgraph "Build & Deployment"
        direction TB
        CI["CI/CD Pipeline"]:::build
        Build["Next.js & Tailwind Build"]:::build
        Configs["Configuration Files"]:::build
        CI -->|triggers| Build
        Build -->|outputs| Vercel["Vercel Deployment"]:::build
    end

    %% Configuration Files
    Configs --> nextConfig
    Configs --> tsConfig
    Configs --> tailwindConfig
    Configs --> postcssConfig
    Configs --> pkgJson
    Configs --> lockFile
    Configs --> gitignore
    Configs --> readme

    %% Back End / SSR Layer
    subgraph "Server Side (SSR/SSG)"
        direction TB
        AppRouter["Next.js App Router"]:::ssr
        Layout["Root Layout Component"]:::ssr
        HomePage["Home Page (page.tsx)"]:::ssr
        ProjectsIndex["Projects Index Page"]:::ssr
    end

    Vercel -->|deploys| AppRouter
    AppRouter --> Layout
    Layout --> HomePage
    Layout --> ProjectsIndex

    %% Front End / Client Layer
    subgraph "Front End (Browser)"
        direction TB
        Browser["Browser"]:::frontend
        subgraph "UI Components"
            direction TB
            Card["Card Component"]:::frontend
            Navbar["Navbar Component"]:::frontend
            ProjectTile["Project Tile Component"]:::frontend
        end
        subgraph "Page Sections"
            direction TB
            Hero["Hero Section"]:::frontend
            CommitGraph["CommitGraph Section"]:::frontend
            Experience["Experience Section"]:::frontend
            Overview["Overview Section"]:::frontend
            HeatmapCSS["Heatmap CSS"]:::frontend
        end
        subgraph "Project Demos"
            direction TB
            DigitDemo["Digit Classification Demo"]:::frontend
            TicTacToe["Tic-Tac-Toe Demo"]:::frontend
            WeatherDemo["Weather App Demo"]:::frontend
        end
    end

    %% External Services & Assets
    subgraph "External Services & Assets"
        direction TB
        PublicCDN["Public Asset Store (public/)"]:::ext
        WeatherAPI["Weather API"]:::ext
    end

    %% Data Flows
    Browser -->|requests page| Vercel
    Vercel -->|serves| Layout
    Browser -->|renders| Card
    Browser -->|renders| Navbar
    Browser -->|renders| ProjectTile
    Browser -->|renders| Hero
    Browser -->|renders| CommitGraph
    Browser -->|renders| Experience
    Browser -->|renders| Overview
    Browser -->|loads CSS| HeatmapCSS
    Browser -->|runs demo| DigitDemo
    Browser -->|runs demo| TicTacToe
    Browser -->|runs demo| WeatherDemo
    Browser -->|fetches model| PublicCDN
    Browser -->|fetches data| WeatherAPI

    %% Click Events
    click AppRouter "https://github.com/ymumberson/tailwind-portfolio/tree/main/src/app"
    click Layout "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/layout.tsx"
    click HomePage "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/page.tsx"
    click Card "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/components/Card.tsx"
    click Navbar "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/components/Navbar.tsx"
    click ProjectTile "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/components/Project.tsx"
    click Hero "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/sections/HeroSection.tsx"
    click CommitGraph "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/sections/CommitGraph.tsx"
    click Experience "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/sections/Experience.tsx"
    click Overview "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/sections/Overview.tsx"
    click HeatmapCSS "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/sections/react-calendar-heatmap.css"
    click DigitDemo "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/projects/digit-classification/page.tsx"
    click TicTacToe "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/projects/tic-tac-toe/page.tsx"
    click WeatherDemo "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/projects/weather/page.tsx"
    click ProjectsIndex "https://github.com/ymumberson/tailwind-portfolio/blob/main/src/app/projects/page.tsx"
    click nextConfig "https://github.com/ymumberson/tailwind-portfolio/blob/main/next.config.ts"
    click tsConfig "https://github.com/ymumberson/tailwind-portfolio/blob/main/tsconfig.json"
    click tailwindConfig "https://github.com/ymumberson/tailwind-portfolio/blob/main/tailwind.config.ts"
    click postcssConfig "https://github.com/ymumberson/tailwind-portfolio/blob/main/postcss.config.mjs"
    click pkgJson "https://github.com/ymumberson/tailwind-portfolio/blob/main/package.json"
    click lockFile "https://github.com/ymumberson/tailwind-portfolio/blob/main/package-lock.json"
    click gitignore "https://github.com/ymumberson/tailwind-portfolio/blob/main/.gitignore"
    click readme "https://github.com/ymumberson/tailwind-portfolio/blob/main/README.md"

    %% Styles
    classDef build fill:#cce5ff,stroke:#004080,color:#004080
    classDef ssr fill:#ffe5cc,stroke:#804000,color:#804000
    classDef frontend fill:#e5ffcc,stroke:#408000,color:#408000
    classDef ext fill:#f0f0f0,stroke:#666666,color:#666666
```
