# leoncaal/portfolio architecture

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

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

## Overview

This is a bilingual personal portfolio: visitors browse the developer profile and project work, open project details, and can submit a contact message that triggers email delivery and a confirmation response. The graph follows the rendered page composition and the contact request path; it also preserves profile, navigation preferences, analytics, and project-detail capabilities identified in the source index. Unexcerpted analytics wiring is included only where the index explicitly records imports; other uncertain connections are omitted.

Main entry points: [`src/app/[locale]/page.js`](https://github.com/leoncaal/portfolio/blob/main/src/app/%5Blocale%5D/page.js) (Home page), [`src/components/projects/Projects.js`](https://github.com/leoncaal/portfolio/blob/main/src/components/projects/Projects.js) (Project catalog), [`src/components/navBar/Navbar.js`](https://github.com/leoncaal/portfolio/blob/main/src/components/navBar/Navbar.js) (Navigation), [`src/components/contact/Contacto.js`](https://github.com/leoncaal/portfolio/blob/main/src/components/contact/Contacto.js) (Contact form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Portfolio experience"]
  node_home["Home page<br/>[page.js]"]
  node_navbar["Navigation<br/>[Navbar.js]"]
  node_profile["Developer profile<br/>[Perfil.js]"]
  node_footer["Footer<br/>[Footer.js]"]
end

subgraph group_projects["Project showcase"]
  node_projects["Project catalog<br/>[Projects.js]"]
  node_cards["Project cards<br/>[CardProjects.js]"]
  node_webdetail["Web details<br/>[DetailProject.js]"]
  node_uxdetail["UX details<br/>[DetailProjectUx.js]"]
end

subgraph group_contact["Contact delivery"]
  node_contactform["Contact form<br/>[Contacto.js]"]
  node_validation["Input validation<br/>[Validation.js]"]
  node_api["Contact API<br/>[handler.js]"]
  node_mailer["Email sender<br/>[mailer.js]"]
end

subgraph group_platform["Localization and analytics"]
  node_layout["Locale layout<br/>[layout.js]"]
  node_language["Language switcher"]
  node_theme["Theme control<br/>[Theme.js]"]
  node_analytics["Analytics component<br/>[GoogleAnalytics.js]"]
  node_gtag["Analytics helper<br/>[gtagHelper.js]"]
end

node_visitor(("Portfolio visitor"))
node_gmail(("Gmail"))

node_visitor -->|"opens"| node_home
node_home -->|"renders"| node_navbar
node_home -->|"renders"| node_profile
node_home -->|"renders"| node_projects
node_home -->|"renders"| node_contactform
node_home -->|"renders"| node_footer
node_navbar -->|"renders"| node_language
node_navbar -->|"renders"| node_theme
node_projects -->|"renders"| node_cards
node_projects -->|"renders"| node_webdetail
node_projects -->|"renders"| node_uxdetail
node_contactform -->|"validates with"| node_validation
node_contactform -->|"posts to"| node_api
node_api -->|"calls"| node_mailer
node_mailer -->|"sends email"| node_gmail
node_layout -->|"renders"| node_analytics
node_analytics -->|"uses"| node_gtag

click node_home "https://github.com/leoncaal/portfolio/blob/main/src/app/%5Blocale%5D/page.js"
click node_navbar "https://github.com/leoncaal/portfolio/blob/main/src/components/navBar/Navbar.js"
click node_profile "https://github.com/leoncaal/portfolio/blob/main/src/components/perfil/Perfil.js"
click node_footer "https://github.com/leoncaal/portfolio/blob/main/src/components/footer/Footer.js"
click node_projects "https://github.com/leoncaal/portfolio/blob/main/src/components/projects/Projects.js"
click node_cards "https://github.com/leoncaal/portfolio/blob/main/src/components/projects/CardProjects.js"
click node_webdetail "https://github.com/leoncaal/portfolio/blob/main/src/components/projects/DetailProject.js"
click node_uxdetail "https://github.com/leoncaal/portfolio/blob/main/src/components/projects/DetailProjectUx.js"
click node_contactform "https://github.com/leoncaal/portfolio/blob/main/src/components/contact/Contacto.js"
click node_validation "https://github.com/leoncaal/portfolio/blob/main/src/components/contact/Validation.js"
click node_api "https://github.com/leoncaal/portfolio/blob/main/pages/api/handler.js"
click node_mailer "https://github.com/leoncaal/portfolio/blob/main/pages/api/mailer.js"
click node_layout "https://github.com/leoncaal/portfolio/blob/main/src/app/%5Blocale%5D/layout.js"
click node_language "https://github.com/leoncaal/portfolio/blob/main/src/components/language/LanguageSelector.js"
click node_theme "https://github.com/leoncaal/portfolio/blob/main/src/components/theme/Theme.js"
click node_analytics "https://github.com/leoncaal/portfolio/blob/main/src/components/googleAnalytics/GoogleAnalytics.js"
click node_gtag "https://github.com/leoncaal/portfolio/blob/main/src/lib/gtagHelper.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_navbar,node_profile,node_footer toneBlue
class node_projects,node_cards,node_webdetail,node_uxdetail toneAmber
class node_contactform,node_validation,node_api,node_mailer toneMint
class node_layout,node_language,node_theme,node_analytics,node_gtag toneRose
class node_visitor,node_gmail toneIndigo
```

## Components

### Portfolio experience

- [Home page](https://github.com/leoncaal/portfolio/blob/main/src/app/%5Blocale%5D/page.js): `src/app/[locale]/page.js`
- [Navigation](https://github.com/leoncaal/portfolio/blob/main/src/components/navBar/Navbar.js): `src/components/navBar/Navbar.js`
- [Developer profile](https://github.com/leoncaal/portfolio/blob/main/src/components/perfil/Perfil.js): `src/components/perfil/Perfil.js`
- [Footer](https://github.com/leoncaal/portfolio/blob/main/src/components/footer/Footer.js): `src/components/footer/Footer.js`

### Project showcase

- [Project catalog](https://github.com/leoncaal/portfolio/blob/main/src/components/projects/Projects.js): `src/components/projects/Projects.js`
- [Project cards](https://github.com/leoncaal/portfolio/blob/main/src/components/projects/CardProjects.js): `src/components/projects/CardProjects.js`
- [Web details](https://github.com/leoncaal/portfolio/blob/main/src/components/projects/DetailProject.js): `src/components/projects/DetailProject.js`
- [UX details](https://github.com/leoncaal/portfolio/blob/main/src/components/projects/DetailProjectUx.js): `src/components/projects/DetailProjectUx.js`

### Contact delivery

- [Contact form](https://github.com/leoncaal/portfolio/blob/main/src/components/contact/Contacto.js): `src/components/contact/Contacto.js`
- [Input validation](https://github.com/leoncaal/portfolio/blob/main/src/components/contact/Validation.js): `src/components/contact/Validation.js`
- [Contact API](https://github.com/leoncaal/portfolio/blob/main/pages/api/handler.js): `pages/api/handler.js`
- [Email sender](https://github.com/leoncaal/portfolio/blob/main/pages/api/mailer.js): `pages/api/mailer.js`

### Localization and analytics

- [Locale layout](https://github.com/leoncaal/portfolio/blob/main/src/app/%5Blocale%5D/layout.js): `src/app/[locale]/layout.js`
- [Language switcher](https://github.com/leoncaal/portfolio/blob/main/src/components/language/LanguageSelector.js): `src/components/language/LanguageSelector.js`
- [Theme control](https://github.com/leoncaal/portfolio/blob/main/src/components/theme/Theme.js): `src/components/theme/Theme.js`
- [Analytics component](https://github.com/leoncaal/portfolio/blob/main/src/components/googleAnalytics/GoogleAnalytics.js): `src/components/googleAnalytics/GoogleAnalytics.js`
- [Analytics helper](https://github.com/leoncaal/portfolio/blob/main/src/lib/gtagHelper.js): `src/lib/gtagHelper.js`

### Other components

- **Portfolio visitor**
- **Gmail**

## Connections

- Portfolio visitor → Home page: opens
- Home page → Navigation: renders (evidence: `src/app/[locale]/page.js`)
- Home page → Developer profile: renders (evidence: `src/app/[locale]/page.js`)
- Home page → Project catalog: renders (evidence: `src/app/[locale]/page.js`)
- Home page → Contact form: renders (evidence: `src/app/[locale]/page.js`)
- Home page → Footer: renders (evidence: `src/app/[locale]/page.js`)
- Navigation → Language switcher: renders (evidence: `src/components/navBar/Navbar.js`)
- Navigation → Theme control: renders (evidence: `src/components/navBar/Navbar.js`)
- Project catalog → Project cards: renders (evidence: `src/components/projects/Projects.js`)
- Project catalog → Web details: renders (evidence: `src/components/projects/Projects.js`)
- Project catalog → UX details: renders (evidence: `src/components/projects/Projects.js`)
- Contact form → Input validation: validates with (evidence: `src/components/contact/Contacto.js`)
- Contact form → Contact API: posts to (evidence: `src/components/contact/Contacto.js`)
- Contact API → Email sender: calls (evidence: `pages/api/handler.js`)
- Email sender → Gmail: sends email (evidence: `pages/api/mailer.js`)
- Locale layout → Analytics component: renders (evidence: `src/app/[locale]/layout.js`)
- Analytics component → Analytics helper: uses (evidence: `src/components/googleAnalytics/GoogleAnalytics.js`)
