# javiertrujilloserrano/portafolio architecture

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

- Interactive diagram: https://gitdiagram.com/javiertrujilloserrano/portafolio
- Repository: https://github.com/javiertrujilloserrano/portafolio

## Overview

##### Project type and purpose
- This is a full-stack personal portfolio template.
- Frontend: React + Vite SPA serving cards, translations, form and download link.
- Backend: Node.js + Express API for sending email (Nodemailer) and serving the CV PDF.

##### File structure
- Top-level:
- client/ – React app
- server/ – Express server
- client/:
- src/hooks – custom hooks (language context, name-effect, privacy popup)
- src/utils – form validations (Zod)
- src/static – translation data, example
- package.json, vite.config.js – build and lint configuration
- server/:
- src/index.mjs & server.mjs – Express app setup and launch
- src/routers/nodemailer-routes.mjs – contact form API
- config/nodemailer.mjs – mail transporter using environment variables
- public/ – static assets (CV PDF)
- .env.example – example configuration

##### README for insights
- No database: user data is sent by email.
- Uses CORS for cross-origin API calls.
- Privacy policy hook pops up on first visit.
- CV download served via static folder.

##### Main components & interactions
a. Frontend (React + Vite)
- State/Context: LanguageContext, PrivacyCheckbox
- Utilities: Zod validations, Axios for API calls
- Dev/Build: Vite bundler
b. Backend (Node.js + Express)
- HTTP Server: Express app
- API Router: /api/contact → nodemailer
- Config: dotenv, CORS
- Static server: serves /public/javierTrujilloCV.pdf
c. External services
- Gmail SMTP via Nodemailer

Data flows
1. User loads SPA from Vite dev server or static build hosted somewhere.
2. SPA fetches translation files from its bundle.
3. User fills contact form → frontend uses Axios POST to Express API.
4. Express uses Nodemailer to send email.
5. SPA provides download link → browser GET /javierTrujilloCV.pdf from Express static folder.

##### Architectural patterns & design principles
- Separation of concerns:
- Presentation (components) vs. form logic (hooks/utils)
- API layer (Express routers) vs. mail configuration (config module)
- Single-page application on client, REST API on server.
- Environment-based config via dotenv.
- Client-side validation with Zod, server just forwards.
- No persistent database – stateless backend.

##### Diagramming conventions
- Use rectangles for modules (Client, Server, External).
- Blue = client modules
- Green = server modules
- Red = external services
- Environment variables (e.g., .env sends to config).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Side
    subgraph "Client SPA (React, Vite, Axios, Zod)" 
        style ClientSPA fill:#D0E8FF,stroke:#000
        UI["UI Components Module"] 
        Hooks["Hooks/Context Module"] 
        Utils["Utilities Module"] 
        Static["Static Data Module"] 
        Build["Build Config"] 
    end

    subgraph "UI Components Module"
        style UI fill:#B0DFFF,stroke:#000
        ContactComp["Contact Form Component"] 
        HeaderComp["Header Component"] 
        FooterComp["Footer Component"] 
        MainComp["Main (Cards) Component"] 
        IconsComp["Icons Component"] 
    end

    subgraph "Hooks/Context Module"
        style Hooks fill:#B0DFFF,stroke:#000
        LangCtx["Language Context"] 
        PrivacyHook["Privacy Checkbox Hook"] 
        NameEffect["Name Effect Hook"] 
        LangSwitch["Language Switch Hook"] 
    end

    subgraph "Utilities Module"
        style Utils fill:#B0DFFF,stroke:#000
        ZodValidations["Form Validations (Zod)"] 
    end

    subgraph "Static Data Module"
        style Static fill:#B0DFFF,stroke:#000
        Translations["Translations Data"] 
        TranslationExample["Translation Example"] 
    end

    subgraph "Build Config"
        style Build fill:#B0DFFF,stroke:#000
        ViteConfig["Vite Configuration"] 
        ClientPkg["Package Manifest"] 
    end

    %% Server Side
    subgraph "Server API (Node.js, Express, Nodemailer)"
        style ServerAPI fill:#D0FFDA,stroke:#000
        Entry["Express App Entrypoint"] 
        Bootstrap["Server Bootstrapping"] 
        Router["Contact API Router"] 
        Config["Mail Transport Configuration"] 
        Env["Environment Variables Example"] 
        StaticServe["Static Assets Server"] 
        ServerPkg["Package Manifest"] 
    end

    %% External Service
    SMTP["Gmail SMTP Service"]
    class SMTP external

    %% Browser
    Browser["User Browser"]
    class Browser external

    %% Connections
    Browser -->|"loads SPA"| ClientSPA
    ClientSPA -->|"renders UI"| UI
    ClientSPA -->|"uses hooks/context"| Hooks
    ClientSPA -->|"uses utilities"| Utils
    ClientSPA -->|"fetches translations"| Static
    ClientSPA -->|"bundles via Vite"| Build

    Browser -->|"GET /javierTrujilloCV.pdf"| StaticServe
    ClientSPA -->|"POST /api/contact"| Router
    Router -->|"uses config"| Config
    Router -->|"sends email via SMTP"| SMTP

    Config -->|"loads from .env"| Env
    Entry -->|"imports routes"| Router
    Bootstrap -->|"starts server"| Entry
    Bootstrap -->|"enables CORS"| Entry
    Bootstrap -->|"serves static from public"| StaticServe

    %% Click Events - Client
    click UI "https://github.com/javiertrujilloserrano/portafolio/tree/main/client/src/components"
    click ContactComp "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/components/Contact.jsx"
    click HeaderComp "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/components/Header.jsx"
    click FooterComp "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/components/Footer.jsx"
    click MainComp "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/components/Main.jsx"
    click IconsComp "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/components/Icons/Icons.jsx"
    click LangCtx "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/hooks/LanguageContext.jsx"
    click PrivacyHook "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/hooks/PrivacyCheckbox.jsx"
    click NameEffect "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/hooks/NameEffect.jsx"
    click LangSwitch "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/hooks/LanguageSwitch.jsx"
    click ZodValidations "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/utils/validations.js"
    click Translations "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/static/translations.js"
    click TranslationExample "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/src/static/translationExample.js"
    click ViteConfig "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/vite.config.js"
    click ClientPkg "https://github.com/javiertrujilloserrano/portafolio/blob/main/client/package.json"

    %% Click Events - Server
    click Entry "https://github.com/javiertrujilloserrano/portafolio/blob/main/server/src/index.mjs"
    click Bootstrap "https://github.com/javiertrujilloserrano/portafolio/blob/main/server/src/server.mjs"
    click Router "https://github.com/javiertrujilloserrano/portafolio/blob/main/server/src/routers/nodemailer-routes.mjs"
    click Config "https://github.com/javiertrujilloserrano/portafolio/blob/main/server/config/nodemailer.mjs"
    click Env "https://github.com/javiertrujilloserrano/portafolio/blob/main/server/.env.example"
    click StaticServe "https://github.com/javiertrujilloserrano/portafolio/blob/main/server/public/javierTrujilloCV.pdf"
    click ServerPkg "https://github.com/javiertrujilloserrano/portafolio/blob/main/server/package.json"

    %% Styles
    classDef client fill:#D0E8FF,stroke:#000
    classDef server fill:#D0FFDA,stroke:#000
    classDef external fill:#FFDADA,stroke:#000
```
