# haltazar/portfolio architecture

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

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

## Overview

##### Main System Components

a. Client-Side Layer
- Next.js App Router (app directory structure)
- Component Architecture
- Static Assets

b. Build/Development Layer
- Next.js Build System
- TypeScript Compilation
- TailwindCSS Processing

c. Deployment Layer
- Vercel Platform Integration

##### Component Organization

a. Core Layout Components
- Root Layout (app/layout.tsx)
- Page Component (app/page.tsx)

b. Feature Components (app/_components)
- Header
- Hero
- Skills
- Contact
- Footer
- Status

c. Reusable UI Components
- Cards (ProjectCard, WorkCard, ContactCard)
- UI Components (from components/ui)

##### Specific Implementation Details

a. Next.js App Router Architecture:
**app/**
- layout.tsx (Root Layout)
- page.tsx (Home Page)
- _components/ (Component Organization)

b. Component Hierarchy:
**Layout**
- Page
- Header
- Hero
- Skills
- Contact
- Footer

c. Build Pipeline:
**Source Files → TypeScript → Next.js Build → Optimized Bundle**

##### Integration Points

Connections between:
- UI components and their styling (TailwindCSS)
- Build configuration files (.eslintrc.json, next.config.mjs, etc.)

##### Notes for Implementation

- Clear separation between app router components and shared UI components
- Build and optimization pipeline
- Development tooling integration

- The Next.js app router architecture
- Component organization and hierarchy
- Build and deployment pipeline
- Static asset management
- Styling system integration

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        AppRouter["Next.js App Router"]
        RootLayout["Root Layout"]:::component
        MainPage["Main Page"]:::component
        
        subgraph Components
            direction TB
            Header["Header"]:::component
            Hero["Hero"]:::component
            Skills["Skills"]:::component
            Contact["Contact"]:::component
            Footer["Footer"]:::component
            Status["Status"]:::component
        end
        
        subgraph Cards
            ProjectCard["Project Card"]:::component
            WorkCard["Work Card"]:::component
            ContactCard["Contact Card"]:::component
        end
        
        subgraph UI
            Badge["Badge"]:::ui
            Button["Button"]:::ui
            Card["Card"]:::ui
        end
    end
    
    subgraph Assets
        Fonts[("Fonts")]:::asset
        Images[("Images")]:::asset
        Icons[("Icons")]:::asset
    end
    
    subgraph Build
        TailwindConfig["TailwindCSS Config"]:::config
        TypeScriptConfig["TypeScript Config"]:::config
        NextConfig["Next.js Config"]:::config
        PostCSSConfig["PostCSS Config"]:::config
        GlobalStyles["Global Styles"]:::styles
        Utils["Utility Functions"]:::util
    end
    
    subgraph Deployment
        Vercel["Vercel Platform"]:::deploy
    end
    
    AppRouter --> RootLayout
    RootLayout --> MainPage
    MainPage --> |Renders|Components
    Components --> Cards
    Cards --> UI
    
    Build --> Client
    Assets --> Client
    Client --> Deployment
    
    %% Click Events
    click RootLayout "https://github.com/Haltazar/portfolio/blob/main/app/layout.tsx"
    click MainPage "https://github.com/Haltazar/portfolio/blob/main/app/page.tsx"
    click Header "https://github.com/Haltazar/portfolio/blob/main/app/_components/Header.tsx"
    click Hero "https://github.com/Haltazar/portfolio/blob/main/app/_components/Hero.tsx"
    click Skills "https://github.com/Haltazar/portfolio/blob/main/app/_components/Skills.tsx"
    click Contact "https://github.com/Haltazar/portfolio/blob/main/app/_components/Contact.tsx"
    click Footer "https://github.com/Haltazar/portfolio/blob/main/app/_components/Footer.tsx"
    click Status "https://github.com/Haltazar/portfolio/blob/main/app/_components/Status.tsx"
    click ProjectCard "https://github.com/Haltazar/portfolio/blob/main/app/_components/cards/ProjectCard.tsx"
    click WorkCard "https://github.com/Haltazar/portfolio/blob/main/app/_components/cards/WorkCard.tsx"
    click ContactCard "https://github.com/Haltazar/portfolio/blob/main/app/_components/cards/ContactCard.tsx"
    click Badge "https://github.com/Haltazar/portfolio/blob/main/components/ui/badge.tsx"
    click Button "https://github.com/Haltazar/portfolio/blob/main/components/ui/button.tsx"
    click Card "https://github.com/Haltazar/portfolio/blob/main/components/ui/card.tsx"
    click GlobalStyles "https://github.com/Haltazar/portfolio/blob/main/app/globals.css"
    click TailwindConfig "https://github.com/Haltazar/portfolio/blob/main/tailwind.config.ts"
    click PostCSSConfig "https://github.com/Haltazar/portfolio/blob/main/postcss.config.mjs"
    click TypeScriptConfig "https://github.com/Haltazar/portfolio/blob/main/tsconfig.json"
    click NextConfig "https://github.com/Haltazar/portfolio/blob/main/next.config.mjs"
    click Fonts "https://github.com/Haltazar/portfolio/tree/main/app/fonts"
    click Images "https://github.com/Haltazar/portfolio/tree/main/app/_components/imgs"
    click Icons "https://github.com/Haltazar/portfolio/tree/main/app/_components/icons"
    click Utils "https://github.com/Haltazar/portfolio/blob/main/lib/utils.ts"
    
    %% Styling
    classDef component fill:#3498db,stroke:#2980b9,color:white
    classDef ui fill:#9b59b6,stroke:#8e44ad,color:white
    classDef asset fill:#e67e22,stroke:#d35400,color:white
    classDef config fill:#2ecc71,stroke:#27ae60,color:white
    classDef styles fill:#f1c40f,stroke:#f39c12,color:white
    classDef util fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef deploy fill:#e74c3c,stroke:#c0392b,color:white
    
    %% Legend
    subgraph Legend
        L1["Component"]:::component
        L2["UI Element"]:::ui
        L3[("Asset")]:::asset
        L4["Config"]:::config
        L5["Styles"]:::styles
        L6["Utility"]:::util
        L7["Deployment"]:::deploy
    end
```
