# barbarapapa/my-portfolio architecture

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

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

## Overview

##### Main Components
- Frontend (UI Layer): This includes the HTML (index.html) which provides the structure of the portfolio.
- Styling Layer: All SCSS and CSS files in the “style” directory (like main.scss, _header.scss, _footer.scss, etc.) that define the look and feel.
- Development Environment: The “.vscode” folder indicates that Visual Studio Code was used for development and configuration.

##### Relationships and Interactions
- The HTML file (index.html) loads and references the main CSS file (generated from main.scss) which in turn imports and compiles several SCSS partials (_header.scss, _footer.scss, etc.).
- The CSS styling influences the layout and presentation of the content in the HTML.

##### Important Architectural Patterns or Design Principles
- Modular CSS Architecture: Use of multiple SCSS partials (e.g., _header.scss, _footer.scss, _cards.scss) indicates a modular approach to styling.
- Static Content Delivery: As a static portfolio, there’s no backend logic; the content is served as-is, making the deployment straightforward (via GitHub Pages or similar).

##### Relevant Technologies, Frameworks, or Libraries
- HTML for markup.
- SCSS for writing modular styles (which compile to main.css that the browser loads).
- CSS for styling applied to the webpage.
- VSCode for the development environment (as indicated by the .vscode folder).
- GitHub Pages (as inferred from the README link) for site hosting.

##### Additional Detail
- Optionally, include a note near the “Styling Components” that highlights the modular SCSS approach, indicating files like _header.scss, _footer.scss, _navigation.scss are composed into the final stylesheet.
- That the architecture is intentionally streamlined for static content, allowing for easy updates and maintenance.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend"
        A["index.html"]:::frontend
    end

    %% Styling Components
    subgraph "Styling Components"
        direction TB
        B["main.scss"]:::scss
        C["_header.scss"]:::scss
        D["_footer.scss"]:::scss
        E["_cards.scss"]:::scss
        F["_about.scss"]:::scss
        G["_cv.scss"]:::scss
        H["_navigation.scss"]:::scss
        I["_placeholder.scss"]:::scss
        J["_skills.scss"]:::scss
        K["_work.scss"]:::scss
        L["Compiled CSS (main.css)"]:::css
        M["Source Map (main.css.map)"]:::css

        %% Compilation arrows from SCSS files to Compiled CSS
        B -->|"compiled"| L
        C --> L
        D --> L
        E --> L
        F --> L
        G --> L
        H --> L
        I --> L
        J --> L
        K --> L
    end

    %% Media Assets
    subgraph "Media Assets"
        direction TB
        N["Images"]:::media
        O["Icons"]:::media
    end

    %% Development Environment
    subgraph "Development/Configuration"
        P[".vscode"]:::dev
    end

    %% Relationships
    A -->|"loads"| L
    L -->|"references"| N
    L -->|"references"| O

    %% Annotation for modular SCSS approach
    Note["Note: Modular SCSS approach with partials"]:::note
    L --- Note

    %% Click events for components
    click A "https://github.com/barbarapapa/my-portfolio/blob/main/index.html"
    click B "https://github.com/barbarapapa/my-portfolio/blob/main/style/main.scss"
    click C "https://github.com/barbarapapa/my-portfolio/blob/main/style/_header.scss"
    click D "https://github.com/barbarapapa/my-portfolio/blob/main/style/_footer.scss"
    click E "https://github.com/barbarapapa/my-portfolio/blob/main/style/_cards.scss"
    click F "https://github.com/barbarapapa/my-portfolio/blob/main/style/_about.scss"
    click G "https://github.com/barbarapapa/my-portfolio/blob/main/style/_cv.scss"
    click H "https://github.com/barbarapapa/my-portfolio/blob/main/style/_navigation.scss"
    click I "https://github.com/barbarapapa/my-portfolio/blob/main/style/_placeholder.scss"
    click J "https://github.com/barbarapapa/my-portfolio/blob/main/style/_skills.scss"
    click K "https://github.com/barbarapapa/my-portfolio/blob/main/style/_work.scss"
    click L "https://github.com/barbarapapa/my-portfolio/blob/main/style/main.css"
    click M "https://github.com/barbarapapa/my-portfolio/blob/main/style/main.css.map"
    click N "https://github.com/barbarapapa/my-portfolio/tree/main/images"
    click O "https://github.com/barbarapapa/my-portfolio/tree/main/icons"
    click P "https://github.com/barbarapapa/my-portfolio/blob/main/.vscode"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:2px;
    classDef scss fill:#90EE90,stroke:#000,stroke-width:2px;
    classDef css fill:#32CD32,stroke:#000,stroke-width:2px;
    classDef media fill:#FFA500,stroke:#000,stroke-width:2px;
    classDef dev fill:#D3D3D3,stroke:#000,stroke-width:2px;
    classDef note fill:#FFFFE0,stroke:#000,stroke-dasharray:5,5,stroke-width:2px;
```
