# cuestalex/portfolio architecture

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

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

## Overview

This is a single-page personal portfolio. A visitor browses the navigation or hero links, reads the profile and skills, reviews project cards and links, then reaches contact details or a message form. The sampled app explicitly composes these page sections; no backend or form-submission behavior is shown. The shared UI layer is represented by its substantial reusable sidebar component and the helpers it explicitly uses. Other UI primitives exist in the tree but are not expanded individually.

Main entry points: [`src/app/components/Hero.tsx`](https://github.com/cuestalex/portfolio/blob/main/src/app/components/Hero.tsx) (Introduction), [`src/app/components/ui/sidebar.tsx`](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/sidebar.tsx) (Responsive sidebar), [`src/app/App.tsx`](https://github.com/cuestalex/portfolio/blob/main/src/app/App.tsx) (Page composition), [`src/app/components/Contact.tsx`](https://github.com/cuestalex/portfolio/blob/main/src/app/components/Contact.tsx) (Contact section)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_page["Portfolio page"]
  node_app["Page composition<br/>[App.tsx]"]
  node_nav["Section navigation<br/>[Navigation.tsx]"]
  node_hero["Introduction<br/>[Hero.tsx]"]
  node_about["Profile and skills<br/>[About.tsx]"]
  node_projects["Project showcase<br/>[Projects.tsx]"]
  node_contact["Contact section<br/>[Contact.tsx]"]
end

subgraph group_ui["Shared UI"]
  node_sidebar["Responsive sidebar<br/>[sidebar.tsx]"]
  node_mobile["Mobile detection<br/>[use-mobile.ts]"]
  node_sheet["Sheet primitives<br/>[sheet.tsx]"]
  node_tooltip["Tooltip primitives<br/>[tooltip.tsx]"]
  node_skeleton["Loading skeleton<br/>[skeleton.tsx]"]
  node_button["Button primitive<br/>[button.tsx]"]
  node_utils["Class utility<br/>[utils.ts]"]
  node_chart["Chart primitives<br/>[chart.tsx]"]
  node_dialog["Dialog primitives<br/>[dialog.tsx]"]
end

node_visitor(("Visitor"))
node_mount["React mount<br/>[main.tsx]"]
node_github(("GitHub profile"))
node_linkedin(("LinkedIn profile"))
node_email(("Email client"))
node_projectlinks(("Project destinations"))

node_visitor -->|"opens site"| node_mount
node_mount -->|"renders"| node_app
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_about
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_contact
node_visitor -->|"chooses section"| node_nav
node_visitor -->|"views intro"| node_hero
node_visitor -->|"reads profile"| node_about
node_visitor -->|"reviews work"| node_projects
node_visitor -->|"contacts"| node_contact
node_hero -->|"anchors to"| node_projects
node_hero -->|"anchors to"| node_contact
node_hero -->|"links to"| node_github
node_hero -->|"links to"| node_linkedin
node_hero -->|"opens mail"| node_email
node_contact -->|"links to"| node_github
node_contact -->|"links to"| node_linkedin
node_contact -->|"opens mail"| node_email
node_projects -->|"links to demos"| node_projectlinks
node_sidebar -->|"detects viewport"| node_mobile
node_sidebar -->|"renders mobile panel"| node_sheet
node_sidebar -->|"renders tooltips"| node_tooltip
node_sidebar -->|"renders placeholder"| node_skeleton
node_sidebar -->|"uses toggle"| node_button
node_sidebar -->|"merges classes"| node_utils
node_button -->|"merges classes"| node_utils
node_chart -->|"merges classes"| node_utils
node_dialog -->|"merges classes"| node_utils

click node_mount "https://github.com/cuestalex/portfolio/blob/main/src/main.tsx"
click node_app "https://github.com/cuestalex/portfolio/blob/main/src/app/App.tsx"
click node_nav "https://github.com/cuestalex/portfolio/blob/main/src/app/components/Navigation.tsx"
click node_hero "https://github.com/cuestalex/portfolio/blob/main/src/app/components/Hero.tsx"
click node_about "https://github.com/cuestalex/portfolio/blob/main/src/app/components/About.tsx"
click node_projects "https://github.com/cuestalex/portfolio/blob/main/src/app/components/Projects.tsx"
click node_contact "https://github.com/cuestalex/portfolio/blob/main/src/app/components/Contact.tsx"
click node_sidebar "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/sidebar.tsx"
click node_mobile "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/use-mobile.ts"
click node_sheet "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/sheet.tsx"
click node_tooltip "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/tooltip.tsx"
click node_skeleton "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/skeleton.tsx"
click node_button "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/button.tsx"
click node_utils "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/utils.ts"
click node_chart "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/chart.tsx"
click node_dialog "https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/dialog.tsx"

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_app,node_nav,node_hero,node_about,node_projects,node_contact,node_email toneBlue
class node_sidebar,node_mobile,node_sheet,node_tooltip,node_skeleton,node_button,node_utils,node_chart,node_dialog toneAmber
class node_visitor,node_github,node_linkedin,node_projectlinks toneIndigo
class node_mount toneTeal
```

## Components

### Portfolio page

- [Page composition](https://github.com/cuestalex/portfolio/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [Section navigation](https://github.com/cuestalex/portfolio/blob/main/src/app/components/Navigation.tsx): `src/app/components/Navigation.tsx`
- [Introduction](https://github.com/cuestalex/portfolio/blob/main/src/app/components/Hero.tsx): `src/app/components/Hero.tsx`
- [Profile and skills](https://github.com/cuestalex/portfolio/blob/main/src/app/components/About.tsx): `src/app/components/About.tsx`
- [Project showcase](https://github.com/cuestalex/portfolio/blob/main/src/app/components/Projects.tsx): `src/app/components/Projects.tsx`
- [Contact section](https://github.com/cuestalex/portfolio/blob/main/src/app/components/Contact.tsx): `src/app/components/Contact.tsx`

### Shared UI

- [Responsive sidebar](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/sidebar.tsx): `src/app/components/ui/sidebar.tsx`
- [Mobile detection](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/use-mobile.ts): `src/app/components/ui/use-mobile.ts`
- [Sheet primitives](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/sheet.tsx): `src/app/components/ui/sheet.tsx`
- [Tooltip primitives](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/tooltip.tsx): `src/app/components/ui/tooltip.tsx`
- [Loading skeleton](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/skeleton.tsx): `src/app/components/ui/skeleton.tsx`
- [Button primitive](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/button.tsx): `src/app/components/ui/button.tsx`
- [Class utility](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/utils.ts): `src/app/components/ui/utils.ts`
- [Chart primitives](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/chart.tsx): `src/app/components/ui/chart.tsx`
- [Dialog primitives](https://github.com/cuestalex/portfolio/blob/main/src/app/components/ui/dialog.tsx): `src/app/components/ui/dialog.tsx`

### Other components

- **Visitor**
- [React mount](https://github.com/cuestalex/portfolio/blob/main/src/main.tsx): `src/main.tsx`
- **GitHub profile**
- **LinkedIn profile**
- **Email client**
- **Project destinations**

## Connections

- Visitor → React mount: opens site (evidence: `src/main.tsx`)
- React mount → Page composition: renders (evidence: `src/main.tsx`)
- Page composition → Section navigation: renders (evidence: `src/app/App.tsx`)
- Page composition → Introduction: renders (evidence: `src/app/App.tsx`)
- Page composition → Profile and skills: renders (evidence: `src/app/App.tsx`)
- Page composition → Project showcase: renders (evidence: `src/app/App.tsx`)
- Page composition → Contact section: renders (evidence: `src/app/App.tsx`)
- Visitor → Section navigation: chooses section (evidence: `src/app/components/Navigation.tsx`)
- Visitor → Introduction: views intro (evidence: `src/app/components/Hero.tsx`)
- Visitor → Profile and skills: reads profile (evidence: `src/app/components/About.tsx`)
- Visitor → Project showcase: reviews work (evidence: `src/app/components/Projects.tsx`)
- Visitor → Contact section: contacts (evidence: `src/app/components/Contact.tsx`)
- Introduction → Project showcase: anchors to (evidence: `src/app/components/Hero.tsx`)
- Introduction → Contact section: anchors to (evidence: `src/app/components/Hero.tsx`)
- Introduction → GitHub profile: links to (evidence: `src/app/components/Hero.tsx`)
- Introduction → LinkedIn profile: links to (evidence: `src/app/components/Hero.tsx`)
- Introduction → Email client: opens mail (evidence: `src/app/components/Hero.tsx`)
- Contact section → GitHub profile: links to (evidence: `src/app/components/Contact.tsx`)
- Contact section → LinkedIn profile: links to (evidence: `src/app/components/Contact.tsx`)
- Contact section → Email client: opens mail (evidence: `src/app/components/Contact.tsx`)
- Project showcase → Project destinations: links to demos (evidence: `src/app/components/Projects.tsx`)
- Responsive sidebar → Mobile detection: detects viewport (evidence: `src/app/components/ui/sidebar.tsx`)
- Responsive sidebar → Sheet primitives: renders mobile panel (evidence: `src/app/components/ui/sidebar.tsx`)
- Responsive sidebar → Tooltip primitives: renders tooltips (evidence: `src/app/components/ui/sidebar.tsx`)
- Responsive sidebar → Loading skeleton: renders placeholder (evidence: `src/app/components/ui/sidebar.tsx`)
- Responsive sidebar → Button primitive: uses toggle (evidence: `src/app/components/ui/sidebar.tsx`)
- Responsive sidebar → Class utility: merges classes (evidence: `src/app/components/ui/sidebar.tsx`)
- Button primitive → Class utility: merges classes (evidence: `src/app/components/ui/button.tsx`)
- Chart primitives → Class utility: merges classes (evidence: `src/app/components/ui/chart.tsx`)
- Dialog primitives → Class utility: merges classes (evidence: `src/app/components/ui/dialog.tsx`)
