# iuricode/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a static, single-page portfolio website built with HTML, Sass (SCSS) and vanilla JavaScript.
- Its purpose is to showcase personal information, experiences, projects and skills in six sections: Home, About, Experience, Projects, Services and Skills.

##### File structure
- Top-level files:
- index.html – the single entry point.
- README.md – documentation.
- assets/ directory holds all static assets:
- css/ – compiled CSS and source maps.
- scss/ – source styles broken out by section and variables.
- js/ – vanilla JavaScript modules for UI behavior (menus, scroll reveals, type-writer effect, etc.).

##### README for additional insights
- No backend or API calls are documented; everything runs client-side.
- No build or deployment scripts are included (likely manual or via a simple Sass compiler).
- No external services beyond a static site host (e.g., GitHub Pages, Netlify).

##### Detailed capture of essential architectural elements
- SCSS files → Sass compiler → assets/css/style.css
- assets/js/*.js modules
- That “index.html” is the single point of entry.
- If desired, annotate optional lines for local development (e.g., live server or local file system).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Workstation
    subgraph "Developer Workstation" 
        direction TB
        Dev[/"Developer Workstation"/]:::dev
        HTML["index.html"]:::asset
        Doc["README.md"]:::asset
        SCSS_SOURCES["SCSS Source Files"]:::asset
        JS_SOURCES["JavaScript Modules"]:::asset
    end

    %% Build Pipeline
    subgraph "Build/Compile Pipeline" 
        direction TB
        SassCompiler["Sass Compiler (node-sass/Dart Sass)"]:::build
        CSS_OUT["assets/css/style.css"]:::asset
        CSS_MAP["assets/css/style.css.map"]:::asset
    end

    %% Hosting
    subgraph "Static File Server / CDN" 
        direction TB
        Server[/"Server / CDN"/]:::server
    end

    %% Client Browser
    subgraph "Client Browser" 
        direction TB
        Browser[/"Client Browser"/]:::client
        Execution["JS Execution & UI Interaction"]:::client
    end

    %% Assets Groups
    subgraph "SCSS Files" 
        direction TB
        VARS["_variables.scss"]:::asset
        RESET["_reset.scss"]:::asset
        HOME["_home.scss"]:::asset
        ABOUT["_about.scss"]:::asset
        EXP["_experience.scss"]:::asset
        PROJ["_projects.scss"]:::asset
        SERV["_services.scss"]:::asset
        SKILL["_skills.scss"]:::asset
        MENU_SCSS["_menu.scss"]:::asset
        FOOT["_footer.scss"]:::asset
        MAIN_SCSS["style.scss"]:::asset
    end

    subgraph "JS Modules" 
        direction TB
        MENU_JS["menu.js"]:::asset
        MAIN_JS["main.js"]:::asset
        SCROLL["scrollReveal.js"]:::asset
        TYPE["typeWrite.js"]:::asset
        HC_DESC["hoverChangeDescription.js"]:::asset
        HC_EXP["hoverChangeExperience.js"]:::asset
    end

    subgraph "Static Media" 
        direction TB
        Icons["assets/icons"]:::asset
        Images["assets/image"]:::asset
    end

    %% Relationships
    Dev -->|edits| HTML
    Dev -->|edits| Doc
    Dev -->|edits| SCSS_SOURCES
    Dev -->|edits| JS_SOURCES

    SCSS_SOURCES --> SassCompiler
    SassCompiler --> CSS_OUT
    SassCompiler --> CSS_MAP

    Dev --> SassCompiler

    CSS_OUT --> Server
    CSS_MAP --> Server
    HTML --> Server
    JS_SOURCES --> Server
    Icons --> Server
    Images --> Server

    Browser -->|requests| Server
    Server -->|serves index.html| Browser
    Server -->|serves CSS/JS/assets| Browser
    Browser --> Execution

    %% Click Events
    click HTML "https://github.com/iuricode/portfolio/blob/main/index.html"
    click Doc "https://github.com/iuricode/portfolio/blob/main/README.md"
    click CSS_OUT "https://github.com/iuricode/portfolio/blob/main/assets/css/style.css"
    click CSS_MAP "https://github.com/iuricode/portfolio/blob/main/assets/css/style.css.map"
    click VARS "https://github.com/iuricode/portfolio/blob/main/assets/scss/_variables.scss"
    click RESET "https://github.com/iuricode/portfolio/blob/main/assets/scss/_reset.scss"
    click HOME "https://github.com/iuricode/portfolio/blob/main/assets/scss/_home.scss"
    click ABOUT "https://github.com/iuricode/portfolio/blob/main/assets/scss/_about.scss"
    click EXP "https://github.com/iuricode/portfolio/blob/main/assets/scss/_experience.scss"
    click PROJ "https://github.com/iuricode/portfolio/blob/main/assets/scss/_projects.scss"
    click SERV "https://github.com/iuricode/portfolio/blob/main/assets/scss/_services.scss"
    click SKILL "https://github.com/iuricode/portfolio/blob/main/assets/scss/_skills.scss"
    click MENU_SCSS "https://github.com/iuricode/portfolio/blob/main/assets/scss/_menu.scss"
    click FOOT "https://github.com/iuricode/portfolio/blob/main/assets/scss/_footer.scss"
    click MAIN_SCSS "https://github.com/iuricode/portfolio/blob/main/assets/scss/style.scss"
    click MENU_JS "https://github.com/iuricode/portfolio/blob/main/assets/js/menu.js"
    click MAIN_JS "https://github.com/iuricode/portfolio/blob/main/assets/js/main.js"
    click SCROLL "https://github.com/iuricode/portfolio/blob/main/assets/js/scrollReveal.js"
    click TYPE "https://github.com/iuricode/portfolio/blob/main/assets/js/typeWrite.js"
    click HC_DESC "https://github.com/iuricode/portfolio/blob/main/assets/js/hoverChangeDescription.js"
    click HC_EXP "https://github.com/iuricode/portfolio/blob/main/assets/js/hoverChangeExperience.js"
    click Icons "https://github.com/iuricode/portfolio/tree/main/assets/icons"
    click Images "https://github.com/iuricode/portfolio/tree/main/assets/image"

    %% Styles
    classDef dev fill:#FFD580,stroke:#E69A00,color:#000
    classDef build fill:#B3E5FC,stroke:#0288D1,color:#000
    classDef server fill:#C8E6C9,stroke:#388E3C,color:#000
    classDef client fill:#E1BEE7,stroke:#8E24AA,color:#000
    classDef asset fill:#F5F5F5,stroke:#BDBDBD,color:#000
```
