# nicomelendez/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a static, content-driven portfolio website built with the Astro framework.
- It uses TypeScript, Tailwind CSS for styling, and is configured for deployment on Vercel.
- There is no backend or database—content is assembled at build time into static HTML, CSS, and JS.

##### File structure
Top-level:
- astro.config.mjs, tsconfig.json, tailwind.config.mjs, vercel.json → build & deployment settings
- package.json, pnpm-lock.yaml → dependencies, scripts, and package management
- public → static assets (images, favicon, etc.)
- src/
– pages/ → route definitions (.astro files)
– layouts/ → page wrappers (Layout.astro)
– lib/ → shared utilities and types
– env.d.ts → environment typing

##### Elements
- Clear labels for each component (e.g., “Astro Build”, “Tailwind Processor”, “Vercel CDN”)
– Rectangles for code & config
– Hexagons for processes (build, deploy)
– Clouds for external services (Vercel, CDN)

- Top layer: Developer workspace → GitHub repo
- Mid layer: Source breakdown
- src/pages (routes)
- src/layouts (page shell)
- src/components (UI atoms & molecules)
- src/lib (helpers & types)
- Output layer: dist/ (static site)
- Delivery layer: Vercel CDN → End user

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer & Repo
    subgraph "Developer & Repository"
        Developer["Developer"]:::dev
        GitHub["GitHub Repo"]:::repo
    end

    Developer -->|"push code"| GitHub

    %% CI/CD
    subgraph "CI/CD Pipeline"
        CI["Vercel Build & Deploy"]:::process
    end

    GitHub -->|"trigger build"| CI

    %% Build Pipeline
    subgraph "Build Pipeline"
        Astro["Astro Build Process"]:::process
        Tailwind["Tailwind CSS Processor"]:::process
        Public["Static Assets"]:::storage
    end

    CI -->|"run Astro"| Astro
    CI -->|"run Tailwind"| Tailwind
    CI -->|"include assets"| Public

    %% Source Code
    subgraph "Source Code"
        Configs["Deployment & Build Settings"]:::config
        AstroConfig["astro.config.mjs"]:::config
        TailwindConfig["tailwind.config.mjs"]:::config
        VercelConfig["vercel.json"]:::config
        Pkg["package.json\npnpm-lock.yaml"]:::config
        TSConfig["tsconfig.json"]:::config

        subgraph "Pages & Layouts"
            Pages["src/pages/"]:::code
            Layouts["src/layouts/Layout.astro"]:::code
        end

        subgraph "UI Components"
            Components["src/components/"]:::code
            Btn["Button Widgets\n(src/components/btn/)"]:::code
            Card["Card Components\n(src/components/card/)"]:::code
            Icons["Icon Components\n(src/components/icons/)"]:::code
            Info["Information Sections\n(src/components/info/)"]:::code
            LayoutHelpers["Layout Helpers\n(src/components/layout/)"]:::code
            Sections["Section Blocks\n(src/components/sections/)"]:::code
            UtilsCmp["Utility Components\n(src/components/utils/)"]:::code
            Wave["Wave Decorations\n(src/components/wave/)"]:::code
        end

        Lib["Shared Utilities & Types\n(src/lib/)"]:::code
        Env["Environment Typings\n(src/env.d.ts)"]:::code
    end

    Astro -->|"consume"| AstroConfig
    Tailwind -->|"consume"| TailwindConfig
    CI -->|"consume"| VercelConfig
    CI -->|"install deps"| Pkg
    Astro -->|"use TS settings"| TSConfig
    Astro -->|"compile"| Pages
    Astro -->|"wrap pages"| Layouts
    Astro -->|"assemble UI"| Components
    Components --> Btn
    Components --> Card
    Components --> Icons
    Components --> Info
    Components --> LayoutHelpers
    Components --> Sections
    Components --> UtilsCmp
    Components --> Wave
    Astro -->|"import utils"| Lib
    Astro -->|"use types"| Env

    Public -->|"copied to"| Dist
    Astro -->|"output to"| Dist
    Tailwind -->|"output CSS to"| Dist

    %% Output & Delivery
    subgraph "Output & Delivery"
        Dist["dist/\n(Static Site)"]:::storage
        CDN["Vercel CDN"]:::cloud
        Browser["End User Browser"]:::browser
    end

    Dist -->|"deploy"| CDN
    CDN -->|"serve static assets"| Browser

    %% Click Events
    click AstroConfig "https://github.com/nicomelendez/portfolio/blob/master/astro.config.mjs"
    click TailwindConfig "https://github.com/nicomelendez/portfolio/blob/master/tailwind.config.mjs"
    click VercelConfig "https://github.com/nicomelendez/portfolio/blob/master/vercel.json"
    click Public "https://github.com/nicomelendez/portfolio/tree/master/public/"
    click Pages "https://github.com/nicomelendez/portfolio/tree/master/src/pages/"
    click Layouts "https://github.com/nicomelendez/portfolio/blob/master/src/layouts/Layout.astro"
    click Components "https://github.com/nicomelendez/portfolio/tree/master/src/components/"
    click Btn "https://github.com/nicomelendez/portfolio/tree/master/src/components/btn/"
    click Card "https://github.com/nicomelendez/portfolio/tree/master/src/components/card/"
    click Icons "https://github.com/nicomelendez/portfolio/tree/master/src/components/icons/"
    click Info "https://github.com/nicomelendez/portfolio/tree/master/src/components/info/"
    click LayoutHelpers "https://github.com/nicomelendez/portfolio/tree/master/src/components/layout/"
    click Sections "https://github.com/nicomelendez/portfolio/tree/master/src/components/sections/"
    click UtilsCmp "https://github.com/nicomelendez/portfolio/tree/master/src/components/utils/"
    click Wave "https://github.com/nicomelendez/portfolio/tree/master/src/components/wave/"
    click Lib "https://github.com/nicomelendez/portfolio/tree/master/src/lib/"
    click Env "https://github.com/nicomelendez/portfolio/blob/master/src/env.d.ts"
    click Pkg "https://github.com/nicomelendez/portfolio/blob/master/package.json"
    click TSConfig "https://github.com/nicomelendez/portfolio/blob/master/tsconfig.json"

    %% Styles
    classDef dev fill:#E3F2FD,stroke:#90CAF9,stroke-width:2px
    classDef repo fill:#FFF3E0,stroke:#FFB74D,stroke-width:2px
    classDef process fill:#E8F5E9,stroke:#66BB6A,stroke-width:2px,stroke-dasharray: 5 5
    classDef storage fill:#F3E5F5,stroke:#AB47BC,stroke-width:2px
    classDef config fill:#FFEBEE,stroke:#E57373,stroke-width:2px
    classDef code fill:#E0F7FA,stroke:#4DD0E1,stroke-width:2px
    classDef cloud fill:#E1F5FE,stroke:#29B6F6,stroke-width:2px,stroke-dasharray: 2 2
    classDef browser fill:#FFFDE7,stroke:#FDD835,stroke-width:2px
```
