# azzazeru/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a Next.js 13 “app directory” portfolio website (no separate backend service).
- Purpose: serve static and SSR React pages (Hero, Contact, System Architecture, Technical Metrics), styled with Tailwind CSS, and deployed via Vercel or similar.

##### File structure
- Top-level:
- `.github/workflows/nextjs.yml` – CI/CD pipeline config
- `app/` – Next.js 13 app directory (components, layout, global CSS)
- `public/` – static assets
- `next.config.ts`, `tsconfig.json`, `tailwind.config.ts`, `postcss.config.mjs`, `eslint.config.mjs` – build and lint configs
- `package.json` – dependencies (React, Next.js, Tailwind, etc.)
- No `/api` folder, so no custom serverless functions—site is pure frontend with SSR/SSG.

##### README for additional insights
- Tech stack: React, Next.js, Tailwind, TypeScript
- CI/CD interest: GitHub Actions workflow present
- Deployment target implied (Vercel or Netlify)

a. Client Browser
– Renders HTML/CSS/JS
– Hydrates React components
b. Next.js Application (Edge/Serverless)
– SSR/SSG functions at build time or per request
– App directory pages and React Components
– Tailwind CSS processed via PostCSS
c. CDN / Static Asset Hosting
– Hosts JS bundles, CSS, images under `public/`
d. GitHub Actions CI/CD
– Runs on push/PR via `.github/workflows/nextjs.yml`
– Steps: install, lint, build, deploy to Vercel
e. External Services (optional)
– Vercel (or similar) for hosting
– Analytics or badge services referenced in README

##### Relationships and interactions
- Browser → CDN: fetches static JS/CSS/images
- Browser → Next.js Edge/Serverless: SSR content requests
- Next.js build → generates static HTML / JSON for SSG
- CI Pipeline → triggers build → deploys to hosting
- GitHub → GitHub Actions workflow triggers on push

##### Architectural patterns and design principles
- JAMstack: static + serverless SSR
- Component-based UI (React)
- CSS utility-first (Tailwind)
- Infrastructure as code (GitHub Actions definitions)
- Separation of concerns:
- UI (React components in `app/components/`)
- Build config (Tailwind, PostCSS, ESLint)
- Deployment (CI/CD workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Development Layer
    subgraph "Development"
        direction TB
        Repo["GitHub Repository"]:::external
        subgraph "Codebase"
            direction TB
            NextApp["Next.js Application (app/)"]:::compute
            Page["Home Page (app/page.tsx)"]:::compute
            Layout["Layout Component (app/layout.tsx)"]:::compute
            Hero["Hero Section (app/components/HeroSection.tsx)"]:::compute
            Contact["Contact Section (app/components/ContactSection.tsx)"]:::compute
            SysArch["System Architecture Section (app/components/SystemArchitecture.tsx)"]:::compute
            TechMetrics["Technical Metrics Section (app/components/TechnicalMetrics.tsx)"]:::compute
            Globals["Global Styles (app/globals.css)"]:::config
            TailwindCfg["Tailwind Config (tailwind.config.ts)"]:::config
            PostCSS["PostCSS Config (postcss.config.mjs)"]:::config
            ESLint["ESLint Config (eslint.config.mjs)"]:::config
            NextCfg["Next.js Config (next.config.ts)"]:::config
            TSConfig["TypeScript Config (tsconfig.json)"]:::config
            Package["package.json"]:::config
            Public["Static Assets (public/)"]:::storage
        end
    end

    %% CI/CD Layer
    subgraph "CI/CD Pipeline"
        direction TB
        Actions["GitHub Actions Runner"]:::compute
        Build["Next.js Build Process"]:::compute
    end

    %% Hosting Layer
    subgraph "Hosting"
        direction TB
        Vercel["Vercel Hosting"]:::hosting
        CDN["CDN / Static Asset Hosting"]:::storage
        Edge["Next.js Edge/SSR"]:::compute
    end

    %% Client Layer
    subgraph "Client"
        direction TB
        Browser["Client Browser"]:::external
    end

    %% Connections
    Repo -->|push/pull| Actions
    Actions -->|"install, lint, build, deploy"| Build
    Build -->|deploy output| Vercel
    Vercel -->|serves static files| CDN
    Vercel -->|handles SSR requests| Edge
    Browser -->|fetch JS/CSS/images| CDN
    Browser -->|requests SSR pages| Edge

    %% Click Events
    click NextApp "https://github.com/azzazeru/portfolio/tree/main/app/"
    click Page "https://github.com/azzazeru/portfolio/blob/main/app/page.tsx"
    click Layout "https://github.com/azzazeru/portfolio/blob/main/app/layout.tsx"
    click Hero "https://github.com/azzazeru/portfolio/blob/main/app/components/HeroSection.tsx"
    click Contact "https://github.com/azzazeru/portfolio/blob/main/app/components/ContactSection.tsx"
    click SysArch "https://github.com/azzazeru/portfolio/blob/main/app/components/SystemArchitecture.tsx"
    click TechMetrics "https://github.com/azzazeru/portfolio/blob/main/app/components/TechnicalMetrics.tsx"
    click Globals "https://github.com/azzazeru/portfolio/blob/main/app/globals.css"
    click TailwindCfg "https://github.com/azzazeru/portfolio/blob/main/tailwind.config.ts"
    click PostCSS "https://github.com/azzazeru/portfolio/blob/main/postcss.config.mjs"
    click ESLint "https://github.com/azzazeru/portfolio/blob/main/eslint.config.mjs"
    click NextCfg "https://github.com/azzazeru/portfolio/blob/main/next.config.ts"
    click TSConfig "https://github.com/azzazeru/portfolio/blob/main/tsconfig.json"
    click Package "https://github.com/azzazeru/portfolio/blob/main/package.json"
    click Public "https://github.com/azzazeru/portfolio/tree/main/public/"
    click Actions "https://github.com/azzazeru/portfolio/blob/main/.github/workflows/nextjs.yml"

    %% Styles
    classDef compute fill:#cce5ff,stroke:#2b6cb0,color:#1a365d
    classDef storage fill:#d4edda,stroke:#276749,color:#22543d
    classDef config fill:#fff3cd,stroke:#744210,color:#663c00
    classDef hosting fill:#ffe5b4,stroke:#c05621,color:#822727
    classDef external fill:#e2e3e5,stroke:#4a5568,color:#2d3748
```
