# naguirrel0209/portfolio architecture

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

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

## Overview

This React portfolio presents Norman Aguirre’s profile, experience, projects, and contact form through a routed site. Visitors first choose a visual era; the app then renders that era’s interface and its corresponding portfolio views. The standard site also provides home, project-list, project-detail, and contact routes. Shared project and timeline data support these views, while theme, language, era, and Pixel Desktop settings personalize the experience. Contact submission validates locally and opens a prefilled email draft. Some era-specific wiring is shown only by the source index, so uncertain connections are omitted.

Main entry points: [`src/App.jsx`](https://github.com/naguirrel0209/portfolio/blob/main/src/App.jsx) (App router), [`src/data/projects.js`](https://github.com/naguirrel0209/portfolio/blob/main/src/data/projects.js) (Project catalog), [`src/pages/Home.jsx`](https://github.com/naguirrel0209/portfolio/blob/main/src/pages/Home.jsx) (Home page), [`src/main.jsx`](https://github.com/naguirrel0209/portfolio/blob/main/src/main.jsx) (App bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App routing"]
  node_app["App router<br/>[App.jsx]"]
  node_bootstrap["App bootstrap<br/>[main.jsx]"]
  node_era_choice["Era selection<br/>[EraSelector.jsx]"]
  node_boot["Boot screen<br/>[BootScreen.jsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_home["Home page<br/>[Home.jsx]"]
  node_projects["Project list<br/>[Projects.jsx]"]
  node_project_detail["Project detail<br/>[ProjectDetail.jsx]"]
  node_project_card["Project card<br/>[ProjectCard.jsx]"]
  node_timeline_item["Timeline item<br/>[TimelineItem.jsx]"]
end

subgraph group_eras["Era interfaces"]
  node_classic_shell["Classic Web"]
  node_classic_projects["Classic projects"]
  node_mainframe_shell["Mainframe<br/>[MainframeShell.jsx]"]
  node_mainframe_projects["Mainframe projects"]
  node_mainframe_section["Mainframe sections"]
  node_mainframe_type["Typed text"]
  node_mainframe_styles["Mainframe styles<br/>[mainframeStyles.js]"]
  node_pixel_shell["Pixel Desktop"]
  node_pixel_projects["Pixel projects"]
end

subgraph group_shared["Shared state and data"]
  node_era_state["Era state<br/>[EraContext.jsx]"]
  node_project_data["Project catalog<br/>[projects.js]"]
  node_timeline_data["Timeline data<br/>[timeline.js]"]
  node_pixel_settings["Desktop settings"]
  node_theme_state["Theme state<br/>[ThemeContext.jsx]"]
end

subgraph group_contact["Contact workflow"]
  node_contact_page["Contact page<br/>[Contact.jsx]"]
  node_contact_form["Contact form logic<br/>[useContactForm.js]"]
end

node_visitor(("Visitor"))
node_mail_app(("Visitor mail app"))

node_visitor -->|"opens site"| node_bootstrap
node_bootstrap -->|"renders"| node_app
node_bootstrap -->|"provides"| node_era_state
node_app -->|"reads selection"| node_era_state
node_app -->|"shows before selection"| node_boot
node_boot -->|"renders"| node_era_choice
node_era_choice -->|"selects era"| node_era_state
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_projects
node_app -->|"routes to"| node_project_detail
node_app -->|"routes to"| node_contact_page
node_app -->|"selects interface"| node_classic_shell
node_app -->|"selects interface"| node_mainframe_shell
node_app -->|"selects interface"| node_pixel_shell
node_home -->|"reads featured projects"| node_project_data
node_home -->|"reads experience"| node_timeline_data
node_home -->|"renders"| node_project_card
node_home -->|"renders"| node_timeline_item
node_projects -->|"reads projects"| node_project_data
node_projects -->|"renders"| node_project_card
node_project_detail -->|"looks up project"| node_project_data
node_classic_shell -->|"renders"| node_classic_projects
node_classic_projects -->|"reads projects"| node_project_data
node_mainframe_shell -->|"routes view"| node_mainframe_projects
node_mainframe_projects -->|"renders through"| node_mainframe_section
node_mainframe_section -->|"uses"| node_mainframe_type
node_mainframe_section -->|"uses"| node_mainframe_styles
node_mainframe_shell -.->|"serves project views"| node_project_data
node_pixel_shell -->|"renders"| node_pixel_projects
node_pixel_projects -->|"reads projects"| node_project_data
node_pixel_shell -->|"uses settings"| node_pixel_settings
node_contact_page -->|"uses form logic"| node_contact_form
node_contact_form -->|"opens email draft"| node_mail_app
node_visitor -->|"fills form"| node_contact_page
node_visitor -.->|"chooses theme"| node_theme_state

click node_app "https://github.com/naguirrel0209/portfolio/blob/main/src/App.jsx"
click node_bootstrap "https://github.com/naguirrel0209/portfolio/blob/main/src/main.jsx"
click node_era_choice "https://github.com/naguirrel0209/portfolio/blob/main/src/components/era/EraSelector.jsx"
click node_boot "https://github.com/naguirrel0209/portfolio/blob/main/src/components/era/BootScreen.jsx"
click node_era_state "https://github.com/naguirrel0209/portfolio/blob/main/src/context/EraContext.jsx"
click node_home "https://github.com/naguirrel0209/portfolio/blob/main/src/pages/Home.jsx"
click node_projects "https://github.com/naguirrel0209/portfolio/blob/main/src/pages/Projects.jsx"
click node_project_detail "https://github.com/naguirrel0209/portfolio/blob/main/src/pages/ProjectDetail.jsx"
click node_project_card "https://github.com/naguirrel0209/portfolio/blob/main/src/components/ui/ProjectCard.jsx"
click node_timeline_item "https://github.com/naguirrel0209/portfolio/blob/main/src/components/ui/TimelineItem.jsx"
click node_project_data "https://github.com/naguirrel0209/portfolio/blob/main/src/data/projects.js"
click node_timeline_data "https://github.com/naguirrel0209/portfolio/blob/main/src/data/timeline.js"
click node_classic_shell "https://github.com/naguirrel0209/portfolio/blob/main/src/components/classic-web/ClassicWebShell.jsx"
click node_classic_projects "https://github.com/naguirrel0209/portfolio/blob/main/src/components/classic-web/ClassicWebProjects.jsx"
click node_mainframe_shell "https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeShell.jsx"
click node_mainframe_projects "https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeProjects.jsx"
click node_mainframe_section "https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeSection.jsx"
click node_mainframe_type "https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeTypedText.jsx"
click node_mainframe_styles "https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/mainframeStyles.js"
click node_pixel_shell "https://github.com/naguirrel0209/portfolio/blob/main/src/components/pixel-desktop/PixelDesktopShell.jsx"
click node_pixel_projects "https://github.com/naguirrel0209/portfolio/blob/main/src/components/pixel-desktop/PixelDesktopProjects.jsx"
click node_pixel_settings "https://github.com/naguirrel0209/portfolio/blob/main/src/hooks/usePixelDesktopSettings.js"
click node_theme_state "https://github.com/naguirrel0209/portfolio/blob/main/src/context/ThemeContext.jsx"
click node_contact_page "https://github.com/naguirrel0209/portfolio/blob/main/src/pages/Contact.jsx"
click node_contact_form "https://github.com/naguirrel0209/portfolio/blob/main/src/hooks/useContactForm.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_app,node_bootstrap,node_era_choice,node_boot toneBlue
class node_home,node_projects,node_project_detail,node_project_card,node_timeline_item toneAmber
class node_classic_shell,node_classic_projects,node_mainframe_shell,node_mainframe_projects,node_mainframe_section,node_mainframe_type,node_mainframe_styles,node_pixel_shell,node_pixel_projects toneMint
class node_era_state,node_project_data,node_timeline_data,node_pixel_settings,node_theme_state toneRose
class node_contact_page,node_contact_form,node_visitor,node_mail_app toneIndigo
```

## Components

### App routing

- [App router](https://github.com/naguirrel0209/portfolio/blob/main/src/App.jsx): `src/App.jsx`
- [App bootstrap](https://github.com/naguirrel0209/portfolio/blob/main/src/main.jsx): `src/main.jsx`
- [Era selection](https://github.com/naguirrel0209/portfolio/blob/main/src/components/era/EraSelector.jsx): `src/components/era/EraSelector.jsx`
- [Boot screen](https://github.com/naguirrel0209/portfolio/blob/main/src/components/era/BootScreen.jsx): `src/components/era/BootScreen.jsx`

### Portfolio content

- [Home page](https://github.com/naguirrel0209/portfolio/blob/main/src/pages/Home.jsx): `src/pages/Home.jsx`
- [Project list](https://github.com/naguirrel0209/portfolio/blob/main/src/pages/Projects.jsx): `src/pages/Projects.jsx`
- [Project detail](https://github.com/naguirrel0209/portfolio/blob/main/src/pages/ProjectDetail.jsx): `src/pages/ProjectDetail.jsx`
- [Project card](https://github.com/naguirrel0209/portfolio/blob/main/src/components/ui/ProjectCard.jsx): `src/components/ui/ProjectCard.jsx`
- [Timeline item](https://github.com/naguirrel0209/portfolio/blob/main/src/components/ui/TimelineItem.jsx): `src/components/ui/TimelineItem.jsx`

### Era interfaces

- [Classic Web](https://github.com/naguirrel0209/portfolio/blob/main/src/components/classic-web/ClassicWebShell.jsx): `src/components/classic-web/ClassicWebShell.jsx`
- [Classic projects](https://github.com/naguirrel0209/portfolio/blob/main/src/components/classic-web/ClassicWebProjects.jsx): `src/components/classic-web/ClassicWebProjects.jsx`
- [Mainframe](https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeShell.jsx): `src/components/mainframe/MainframeShell.jsx`
- [Mainframe projects](https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeProjects.jsx): `src/components/mainframe/MainframeProjects.jsx`
- [Mainframe sections](https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeSection.jsx): `src/components/mainframe/MainframeSection.jsx`
- [Typed text](https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/MainframeTypedText.jsx): `src/components/mainframe/MainframeTypedText.jsx`
- [Mainframe styles](https://github.com/naguirrel0209/portfolio/blob/main/src/components/mainframe/mainframeStyles.js): `src/components/mainframe/mainframeStyles.js`
- [Pixel Desktop](https://github.com/naguirrel0209/portfolio/blob/main/src/components/pixel-desktop/PixelDesktopShell.jsx): `src/components/pixel-desktop/PixelDesktopShell.jsx`
- [Pixel projects](https://github.com/naguirrel0209/portfolio/blob/main/src/components/pixel-desktop/PixelDesktopProjects.jsx): `src/components/pixel-desktop/PixelDesktopProjects.jsx`

### Shared state and data

- [Era state](https://github.com/naguirrel0209/portfolio/blob/main/src/context/EraContext.jsx): `src/context/EraContext.jsx`
- [Project catalog](https://github.com/naguirrel0209/portfolio/blob/main/src/data/projects.js): `src/data/projects.js`
- [Timeline data](https://github.com/naguirrel0209/portfolio/blob/main/src/data/timeline.js): `src/data/timeline.js`
- [Desktop settings](https://github.com/naguirrel0209/portfolio/blob/main/src/hooks/usePixelDesktopSettings.js): `src/hooks/usePixelDesktopSettings.js`
- [Theme state](https://github.com/naguirrel0209/portfolio/blob/main/src/context/ThemeContext.jsx): `src/context/ThemeContext.jsx`

### Contact workflow

- [Contact page](https://github.com/naguirrel0209/portfolio/blob/main/src/pages/Contact.jsx): `src/pages/Contact.jsx`
- [Contact form logic](https://github.com/naguirrel0209/portfolio/blob/main/src/hooks/useContactForm.js): `src/hooks/useContactForm.js`

### Other components

- **Visitor**
- **Visitor mail app**

## Connections

- Visitor → App bootstrap: opens site (evidence: `src/main.jsx`)
- App bootstrap → App router: renders (evidence: `src/main.jsx`)
- App bootstrap → Era state: provides (evidence: `src/main.jsx`)
- App router → Era state: reads selection (evidence: `src/App.jsx`)
- App router → Boot screen: shows before selection (evidence: `src/App.jsx`)
- Boot screen → Era selection: renders (evidence: `src/components/era/BootScreen.jsx`)
- Era selection → Era state: selects era (evidence: `src/components/era/EraSelector.jsx`)
- App router → Home page: routes to (evidence: `src/App.jsx`)
- App router → Project list: routes to (evidence: `src/App.jsx`)
- App router → Project detail: routes to (evidence: `src/App.jsx`)
- App router → Contact page: routes to (evidence: `src/App.jsx`)
- App router → Classic Web: selects interface (evidence: `src/App.jsx`)
- App router → Mainframe: selects interface (evidence: `src/App.jsx`)
- App router → Pixel Desktop: selects interface (evidence: `src/App.jsx`)
- Home page → Project catalog: reads featured projects (evidence: `src/pages/Home.jsx`)
- Home page → Timeline data: reads experience (evidence: `src/pages/Home.jsx`)
- Home page → Project card: renders (evidence: `src/pages/Home.jsx`)
- Home page → Timeline item: renders (evidence: `src/pages/Home.jsx`)
- Project list → Project catalog: reads projects (evidence: `src/pages/Projects.jsx`)
- Project list → Project card: renders (evidence: `src/pages/Projects.jsx`)
- Project detail → Project catalog: looks up project (evidence: `src/pages/ProjectDetail.jsx`)
- Classic Web → Classic projects: renders (evidence: `src/components/classic-web/ClassicWebShell.jsx`)
- Classic projects → Project catalog: reads projects (evidence: `src/components/classic-web/ClassicWebProjects.jsx`)
- Mainframe → Mainframe projects: routes view (evidence: `src/App.jsx`)
- Mainframe projects → Mainframe sections: renders through (evidence: `src/components/mainframe/MainframeProjects.jsx`)
- Mainframe sections → Typed text: uses (evidence: `src/components/mainframe/MainframeAbout.jsx`)
- Mainframe sections → Mainframe styles: uses (evidence: `src/components/mainframe/MainframeAbout.jsx`)
- Mainframe → Project catalog: serves project views
- Pixel Desktop → Pixel projects: renders (evidence: `src/components/pixel-desktop/PixelDesktopShell.jsx`)
- Pixel projects → Project catalog: reads projects (evidence: `src/components/pixel-desktop/PixelDesktopProjects.jsx`)
- Pixel Desktop → Desktop settings: uses settings (evidence: `src/components/pixel-desktop/PixelDesktopShell.jsx`)
- Contact page → Contact form logic: uses form logic (evidence: `src/pages/Contact.jsx`)
- Contact form logic → Visitor mail app: opens email draft (evidence: `src/hooks/useContactForm.js`)
- Visitor → Contact page: fills form (evidence: `src/pages/Contact.jsx`)
- Visitor → Theme state: chooses theme
