# mahdimarino/my-work-site architecture

> Architecture diagram of the GitHub repository mahdimarino/my-work-site, 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/mahdimarino/my-work-site
- Repository: https://github.com/mahdimarino/my-work-site

## Overview

This is a React portfolio site: visitors browse an assembled profile, capabilities, skills, selected work, teaching material, and contact links. The runtime entry mounts App, which composes the page sections; each section reads its content from the centralized content module. The skills visualization also uses an intersection observer to reveal its bars when visible. The graph reflects shown imports and calls; it does not imply that the portfolio's showcased projects are implemented by this site.

Main entry points: [`src/App.tsx`](https://github.com/mahdimarino/my-work-site/blob/main/src/App.tsx) (Page assembly), [`src/components/Nav.tsx`](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Nav.tsx) (Navigation), [`src/components/Skyline.tsx`](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Skyline.tsx) (Skills skyline), [`src/content.ts`](https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts) (Profile data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_page["Portfolio page"]
  node_entry["React entry<br/>[main.tsx]"]
  node_assembly["Page assembly<br/>[App.tsx]"]
  node_navigation["Navigation<br/>[Nav.tsx]"]
  node_introduction["Introduction<br/>[Hero.tsx]"]
  node_capabilities["Capabilities<br/>[WhatIDo.tsx]"]
  node_skills["Skills skyline<br/>[Skyline.tsx]"]
  node_work["Selected work<br/>[Work.tsx]"]
  node_teaching["Teaching content<br/>[Teaching.tsx]"]
  node_contact["Contact links<br/>[Contact.tsx]"]
end

subgraph group_content["Portfolio content"]
  node_profile_data["Profile data<br/>[content.ts]"]
  node_capability_data["Capability data<br/>[content.ts]"]
  node_skill_data["Skill data<br/>[content.ts]"]
  node_project_data["Project data<br/>[content.ts]"]
  node_teaching_data["Teaching data<br/>[content.ts]"]
  node_navigation_data["Navigation data<br/>[content.ts]"]
end

subgraph group_interaction["Page interaction"]
  node_visibility["Visibility observer<br/>[useInView.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens site"| node_entry
node_entry -->|"renders"| node_assembly
node_assembly -->|"renders"| node_navigation
node_assembly -->|"renders"| node_introduction
node_assembly -->|"renders"| node_capabilities
node_assembly -->|"renders"| node_skills
node_assembly -->|"renders"| node_work
node_assembly -->|"renders"| node_teaching
node_assembly -->|"renders"| node_contact
node_navigation -->|"reads"| node_profile_data
node_navigation -->|"reads"| node_navigation_data
node_introduction -->|"reads"| node_profile_data
node_capabilities -->|"reads"| node_capability_data
node_skills -->|"reads"| node_skill_data
node_skills -->|"uses"| node_visibility
node_work -->|"reads"| node_project_data
node_teaching -->|"reads"| node_teaching_data
node_contact -->|"reads"| node_profile_data

click node_entry "https://github.com/mahdimarino/my-work-site/blob/main/src/main.tsx"
click node_assembly "https://github.com/mahdimarino/my-work-site/blob/main/src/App.tsx"
click node_navigation "https://github.com/mahdimarino/my-work-site/blob/main/src/components/Nav.tsx"
click node_introduction "https://github.com/mahdimarino/my-work-site/blob/main/src/components/Hero.tsx"
click node_capabilities "https://github.com/mahdimarino/my-work-site/blob/main/src/components/WhatIDo.tsx"
click node_skills "https://github.com/mahdimarino/my-work-site/blob/main/src/components/Skyline.tsx"
click node_work "https://github.com/mahdimarino/my-work-site/blob/main/src/components/Work.tsx"
click node_teaching "https://github.com/mahdimarino/my-work-site/blob/main/src/components/Teaching.tsx"
click node_contact "https://github.com/mahdimarino/my-work-site/blob/main/src/components/Contact.tsx"
click node_profile_data "https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts"
click node_capability_data "https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts"
click node_skill_data "https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts"
click node_project_data "https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts"
click node_teaching_data "https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts"
click node_navigation_data "https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts"
click node_visibility "https://github.com/mahdimarino/my-work-site/blob/main/src/hooks/useInView.ts"

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_entry,node_assembly,node_navigation,node_introduction,node_capabilities,node_skills,node_work,node_teaching,node_contact toneBlue
class node_profile_data,node_capability_data,node_skill_data,node_project_data,node_teaching_data,node_navigation_data toneAmber
class node_visibility toneMint
class node_visitor toneIndigo
```

## Components

### Portfolio page

- [React entry](https://github.com/mahdimarino/my-work-site/blob/main/src/main.tsx): `src/main.tsx`
- [Page assembly](https://github.com/mahdimarino/my-work-site/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Nav.tsx): `src/components/Nav.tsx`
- [Introduction](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [Capabilities](https://github.com/mahdimarino/my-work-site/blob/main/src/components/WhatIDo.tsx): `src/components/WhatIDo.tsx`
- [Skills skyline](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Skyline.tsx): `src/components/Skyline.tsx`
- [Selected work](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Work.tsx): `src/components/Work.tsx`
- [Teaching content](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Teaching.tsx): `src/components/Teaching.tsx`
- [Contact links](https://github.com/mahdimarino/my-work-site/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`

### Portfolio content

- [Profile data](https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts): `src/content.ts`
- [Capability data](https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts): `src/content.ts`
- [Skill data](https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts): `src/content.ts`
- [Project data](https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts): `src/content.ts`
- [Teaching data](https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts): `src/content.ts`
- [Navigation data](https://github.com/mahdimarino/my-work-site/blob/main/src/content.ts): `src/content.ts`

### Page interaction

- [Visibility observer](https://github.com/mahdimarino/my-work-site/blob/main/src/hooks/useInView.ts): `src/hooks/useInView.ts`

### Other components

- **Visitor**

## Connections

- Visitor → React entry: opens site (evidence: `README.md`)
- React entry → Page assembly: renders (evidence: `src/main.tsx`)
- Page assembly → Navigation: renders (evidence: `src/App.tsx`)
- Page assembly → Introduction: renders (evidence: `src/App.tsx`)
- Page assembly → Capabilities: renders (evidence: `src/App.tsx`)
- Page assembly → Skills skyline: renders (evidence: `src/App.tsx`)
- Page assembly → Selected work: renders (evidence: `src/App.tsx`)
- Page assembly → Teaching content: renders (evidence: `src/App.tsx`)
- Page assembly → Contact links: renders (evidence: `src/App.tsx`)
- Navigation → Profile data: reads (evidence: `src/components/Nav.tsx`)
- Navigation → Navigation data: reads (evidence: `src/components/Nav.tsx`)
- Introduction → Profile data: reads (evidence: `src/components/Hero.tsx`)
- Capabilities → Capability data: reads (evidence: `src/components/WhatIDo.tsx`)
- Skills skyline → Skill data: reads (evidence: `src/components/Skyline.tsx`)
- Skills skyline → Visibility observer: uses (evidence: `src/components/Skyline.tsx`)
- Selected work → Project data: reads (evidence: `src/components/Work.tsx`)
- Teaching content → Teaching data: reads (evidence: `src/components/Teaching.tsx`)
- Contact links → Profile data: reads (evidence: `src/components/Contact.tsx`)
