# luizlopes12/portfolio-2 architecture

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

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

## Overview

##### Project type and purpose
- This is a single-page front-end web application—your personal portfolio built with React, TypeScript, Vite and Sass.
- There is no separate backend service; the app is compiled into static assets and served from a web server or CDN.
- Purpose: showcase your experience, projects and contact info, with support for multiple locales (i18n).

##### File structure
- Top‐level directory “portfolio” contains:
– Configuration: package.json, tsconfig.json/node, vite.config.ts, .eslintrc.cjs
– Public assets: index.html, public/projects-images
– Source code in src/:
· main.tsx bootstraps the React app
· components/ subdivided by UI features (Navbar, Footer, About, Projects, etc.)
· pages/HomePage
· assets/ (img, Sass files: variables, mixins, global styling)
· i18n/ for translation loader and locale files (en, es, pt)
- Build scripts managed by Vite; client-side routing handled in React.

##### README
- Confirms it’s a “Fullstack developer” portfolio, but contains only front-end code.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Subgraph Development Environment
    subgraph "Development Environment"
        Gitignore[".gitignore"]:::config
        Readme["README.md"]:::config
        PackageJson["package.json"]:::config
    end

    %% Subgraph Build & CI/CD
    subgraph "Build & CI/CD"
        ViteDev["Vite Dev Server"]:::build
        ViteConfig["vite.config.ts"]:::config
        MainTSX["main.tsx"]:::config
        TSConfig["tsconfig.json"]:::config
        TSConfigNode["tsconfig.node.json"]:::config
        ViteBuild["Vite Build (prod)"]:::build
        CICD["GitHub Actions / Netlify"]:::build
    end

    %% Subgraph Production Hosting
    subgraph "Production Hosting / CDN"
        IndexHTML["index.html"]:::host
        PublicAssets["public/"]:::asset
        ProjectImages["public/projects-images/"]:::asset
        StaticCDN["Static CDN / Web Server"]:::host
    end

    %% Subgraph Client Runtime
    subgraph "Client Runtime"
        Browser["End-User Browser"]:::client

        subgraph "React Application"
            ReactApp["React SPA"]:::client
            subgraph "UI Components"
                Navbar["Navbar Component"]:::ui
                Footer["Footer Component"]:::ui
                About["About Section"]:::ui
                Projects["Projects Section"]:::ui
                ProjectCard["ProjectCard"]:::ui
                Contact["Contact Section"]:::ui
                Experiences["Experiences Section"]:::ui
                ExperienceItem["ExperienceItem"]:::ui
                Techs["Techs Component"]:::ui
                HomePage["HomePage"]:::ui
            end
            subgraph "i18n Module"
                I18nIndex["index.ts"]:::i18n
                LocaleEn["en.ts"]:::i18n
                LocaleEs["es.ts"]:::i18n
                LocalePt["pt.ts"]:::i18n
                Translator["Translator.ts"]:::i18n
            end
        end
    end

    %% Connections: Dev to Build
    Gitignore -->|commits| ViteDev
    Readme -->|commits| ViteDev
    PackageJson -->|commits| ViteDev
    ViteDev -->|hot-reload| ReactApp
    ViteDev -.->|dev feedback| Gitignore

    %% Build tool files
    ViteConfig -->|configures| ViteDev
    MainTSX -->|entry bootstrap| ViteDev
    TSConfig -->|type setup| ViteDev
    TSConfigNode -->|node config| ViteDev

    %% Build to Production
    ViteBuild -->|bundles| StaticCDN
    CICD -->|deploys artifacts| StaticCDN

    %% Hosting to Browser
    Browser -->|requests index.html| StaticCDN
    StaticCDN -->|serves HTML/JS/CSS| Browser

    %% Runtime flow inside browser
    Browser -->|loads| ReactApp
    ReactApp -->|renders UI| Navbar
    ReactApp -->|renders UI| Footer
    ReactApp -->|renders UI| About
    ReactApp -->|renders UI| Projects
    Projects -->|uses| ProjectCard
    ReactApp -->|renders UI| Contact
    ReactApp -->|renders UI| Experiences
    Experiences -->|uses| ExperienceItem
    ReactApp -->|renders UI| Techs
    ReactApp -->|loads page| HomePage

    %% i18n flow
    ReactApp -->|loads translations| I18nIndex
    I18nIndex -->|imports| LocaleEn
    I18nIndex -->|imports| LocaleEs
    I18nIndex -->|imports| LocalePt
    ReactApp -->|uses| Translator

    %% Click Events
    click Gitignore "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/.gitignore"
    click Readme "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/README.md"
    click PackageJson "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/package.json"
    click ViteConfig "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/vite.config.ts"
    click MainTSX "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/main.tsx"
    click TSConfig "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/tsconfig.json"
    click TSConfigNode "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/tsconfig.node.json"
    click IndexHTML "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/index.html"
    click PublicAssets "https://github.com/luizlopes12/portfolio-2/tree/main/portfolio/public/"
    click ProjectImages "https://github.com/luizlopes12/portfolio-2/tree/main/portfolio/public/projects-images/"
    click I18nIndex "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/i18n/index.ts"
    click LocaleEn "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/i18n/locales/en.ts"
    click LocaleEs "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/i18n/locales/es.ts"
    click LocalePt "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/i18n/locales/pt.ts"
    click Translator "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/I18n/Translator.ts"
    click Navbar "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Navbar/index.tsx"
    click Footer "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Footer/index.tsx"
    click About "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/About/index.tsx"
    click Projects "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Projects/index.tsx"
    click ProjectCard "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/ProjectCard/index.tsx"
    click Contact "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Contact/index.tsx"
    click Experiences "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Experiences/index.tsx"
    click ExperienceItem "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/ExperienceItem/index.tsx"
    click Techs "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Techs/index.tsx"
    click HomePage "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/pages/HomePage/HomePage.tsx"
    click PublicAssets "https://github.com/luizlopes12/portfolio-2/tree/main/portfolio/public/"
    click ProjectImages "https://github.com/luizlopes12/portfolio-2/tree/main/portfolio/public/projects-images/"
    click Translator "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/I18n/Translator.ts"
    click Navbar "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Navbar/index.tsx"
    click Footer "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Footer/index.tsx"
    click About "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/About/index.tsx"
    click Projects "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Projects/index.tsx"
    click ProjectCard "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/ProjectCard/index.tsx"
    click Contact "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Contact/index.tsx"
    click Experiences "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Experiences/index.tsx"
    click ExperienceItem "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/ExperienceItem/index.tsx"
    click Techs "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/components/Techs/index.tsx"
    click HomePage "https://github.com/luizlopes12/portfolio-2/blob/main/portfolio/src/pages/HomePage/HomePage.tsx"

    %% Styles
    classDef dev fill:#f2f2f2,stroke:#999,stroke-width:1px
    classDef build fill:#cce5ff,stroke:#004085,stroke-width:1px
    classDef host fill:#d4edda,stroke:#155724,stroke-width:1px
    classDef client fill:#fff3cd,stroke:#856404,stroke-width:1px
    classDef ui fill:#ffe5b4,stroke:#cc8400,stroke-width:1px
    classDef i18n fill:#e2cfe5,stroke:#7e5685,stroke-width:1px
    classDef config fill:#e2f0f9,stroke:#31708f,stroke-width:1px
    classDef asset fill:#fff5cc,stroke:#b7950b,stroke-width:1px
```
