# murtzaharri21-cyber/my-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/murtzaharri21-cyber/my-portfolio
- Repository: https://github.com/murtzaharri21-cyber/my-portfolio

## Overview

This repository contains a personal portfolio presented through a React site and an interactive browser experience. Visitors browse profile, career, skills, and project content; interact with a 3D character and scene controls; and can submit a contact form. The graph preserves both the React component structure and the separate public JavaScript interaction modules. Some component relationships are based on the SOURCE INDEX; unsampled implementation details and connections are omitted.

Main entry points: [`src/components/MainContainer.tsx`](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/MainContainer.tsx) (Page Sections), [`public/js/app.js`](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/app.js) (Experience Controller), [`src/App.tsx`](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/App.tsx) (App Shell), [`src/components/Character/Scene.tsx`](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Character/Scene.tsx) (Character Scene)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio Site"]
  node_entry["React Entry<br/>[main.tsx]"]
  node_app["App Shell<br/>[App.tsx]"]
  node_loading["Loading State"]
  node_loader["Loading Screen<br/>[Loading.tsx]"]
end

subgraph group_character["3D Character"]
  node_character["Character Scene<br/>[Scene.tsx]"]
  node_model["Character Loader<br/>[character.ts]"]
  node_animation["Character Animation<br/>[animationUtils.ts]"]
  node_scroll["Scroll Timelines<br/>[GsapScroll.ts]"]
end

subgraph group_interactive["Interactive Experience"]
  node_publicapp["Experience Controller<br/>[app.js]"]
  node_scene["Scene Engine<br/>[three-scene.js]"]
  node_terminal["Terminal<br/>[terminal.js]"]
  node_audio["Sound Engine<br/>[audio.js]"]
  node_i18n["Translations<br/>[i18n.js]"]
end

subgraph group_content["Portfolio Content"]
  node_sections["Page Sections<br/>[MainContainer.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_career["Career<br/>[Career.tsx]"]
  node_landing["Landing<br/>[Landing.tsx]"]
  node_contact["Contact<br/>[Contact.tsx]"]
  node_work["Project Carousel<br/>[Work.tsx]"]
  node_workimage["Project Image<br/>[WorkImage.tsx]"]
  node_tech["Tech Stack<br/>[TechStack.tsx]"]
  node_whatido["Services<br/>[WhatIDo.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_social["Social Links<br/>[SocialIcons.tsx]"]
  node_hover["Hover Links<br/>[HoverLinks.tsx]"]
end

node_visitor(("Visitor"))
node_contactapi["Contact Endpoint"]

node_visitor -->|"opens"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"wraps"| node_loading
node_loading -->|"renders"| node_loader
node_app -->|"renders"| node_sections
node_app -->|"renders"| node_character
node_sections -->|"renders"| node_about
node_sections -->|"renders"| node_career
node_sections -->|"renders"| node_landing
node_sections -->|"renders"| node_contact
node_sections -->|"renders"| node_work
node_sections -->|"renders"| node_tech
node_sections -->|"renders"| node_whatido
node_sections -->|"renders"| node_navbar
node_sections -->|"renders"| node_social
node_work -->|"renders"| node_workimage
node_navbar -->|"uses"| node_hover
node_social -->|"uses"| node_hover
node_character -->|"loads"| node_model
node_character -->|"sets animations"| node_animation
node_character -->|"reports progress"| node_loading
node_model -->|"sets timelines"| node_scroll
node_visitor -->|"interacts"| node_publicapp
node_publicapp -->|"sets mode"| node_scene
node_publicapp -->|"plays sound"| node_audio
node_publicapp -->|"initializes"| node_terminal
node_terminal -->|"sets mode"| node_scene
node_terminal -->|"plays sound"| node_audio
node_publicapp -->|"posts form"| node_contactapi
node_publicapp -.-> node_i18n

click node_entry "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/main.tsx"
click node_app "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/App.tsx"
click node_loading "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/context/LoadingProvider.tsx"
click node_loader "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Loading.tsx"
click node_sections "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/MainContainer.tsx"
click node_about "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/About.tsx"
click node_career "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Career.tsx"
click node_landing "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Landing.tsx"
click node_contact "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Contact.tsx"
click node_work "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Work.tsx"
click node_workimage "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/WorkImage.tsx"
click node_tech "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/TechStack.tsx"
click node_whatido "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/WhatIDo.tsx"
click node_navbar "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Navbar.tsx"
click node_social "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/SocialIcons.tsx"
click node_hover "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/HoverLinks.tsx"
click node_character "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Character/Scene.tsx"
click node_model "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Character/utils/character.ts"
click node_animation "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Character/utils/animationUtils.ts"
click node_scroll "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/utils/GsapScroll.ts"
click node_publicapp "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/app.js"
click node_scene "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/three-scene.js"
click node_terminal "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/terminal.js"
click node_audio "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/audio.js"
click node_i18n "https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/i18n.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_entry,node_app,node_loading,node_loader toneBlue
class node_character,node_model,node_animation,node_scroll toneAmber
class node_publicapp,node_scene,node_terminal,node_audio,node_i18n toneMint
class node_sections,node_about,node_career,node_landing,node_contact,node_work,node_workimage,node_tech,node_whatido,node_navbar,node_social,node_hover toneRose
class node_visitor,node_contactapi toneIndigo
```

## Components

### Portfolio Site

- [React Entry](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/main.tsx): `src/main.tsx`
- [App Shell](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [Loading State](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/context/LoadingProvider.tsx): `src/context/LoadingProvider.tsx`
- [Loading Screen](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Loading.tsx): `src/components/Loading.tsx`

### 3D Character

- [Character Scene](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Character/Scene.tsx): `src/components/Character/Scene.tsx`
- [Character Loader](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Character/utils/character.ts): `src/components/Character/utils/character.ts`
- [Character Animation](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Character/utils/animationUtils.ts): `src/components/Character/utils/animationUtils.ts`
- [Scroll Timelines](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/utils/GsapScroll.ts): `src/components/utils/GsapScroll.ts`

### Interactive Experience

- [Experience Controller](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/app.js): `public/js/app.js`
- [Scene Engine](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/three-scene.js): `public/js/three-scene.js`
- [Terminal](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/terminal.js): `public/js/terminal.js`
- [Sound Engine](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/audio.js): `public/js/audio.js`
- [Translations](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/public/js/i18n.js): `public/js/i18n.js`

### Portfolio Content

- [Page Sections](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/MainContainer.tsx): `src/components/MainContainer.tsx`
- [About](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Career](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Career.tsx): `src/components/Career.tsx`
- [Landing](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Landing.tsx): `src/components/Landing.tsx`
- [Contact](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`
- [Project Carousel](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Work.tsx): `src/components/Work.tsx`
- [Project Image](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/WorkImage.tsx): `src/components/WorkImage.tsx`
- [Tech Stack](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/TechStack.tsx): `src/components/TechStack.tsx`
- [Services](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/WhatIDo.tsx): `src/components/WhatIDo.tsx`
- [Navigation](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Social Links](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/SocialIcons.tsx): `src/components/SocialIcons.tsx`
- [Hover Links](https://github.com/murtzaharri21-cyber/my-portfolio/blob/main/src/components/HoverLinks.tsx): `src/components/HoverLinks.tsx`

### Other components

- **Visitor**
- **Contact Endpoint**

## Connections

- Visitor → React Entry: opens (evidence: `src/main.tsx`)
- React Entry → App Shell: renders (evidence: `src/main.tsx`)
- App Shell → Loading State: wraps (evidence: `src/App.tsx`)
- Loading State → Loading Screen: renders (evidence: `src/context/LoadingProvider.tsx`)
- App Shell → Page Sections: renders (evidence: `src/App.tsx`)
- App Shell → Character Scene: renders (evidence: `src/App.tsx`)
- Page Sections → About: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Career: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Landing: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Contact: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Project Carousel: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Tech Stack: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Services: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Navigation: renders (evidence: `src/components/MainContainer.tsx`)
- Page Sections → Social Links: renders (evidence: `src/components/MainContainer.tsx`)
- Project Carousel → Project Image: renders (evidence: `src/components/Work.tsx`)
- Navigation → Hover Links: uses (evidence: `src/components/Navbar.tsx`)
- Social Links → Hover Links: uses (evidence: `src/components/SocialIcons.tsx`)
- Character Scene → Character Loader: loads (evidence: `src/components/Character/Scene.tsx`)
- Character Scene → Character Animation: sets animations (evidence: `src/components/Character/Scene.tsx`)
- Character Scene → Loading State: reports progress (evidence: `src/components/Character/Scene.tsx`)
- Character Loader → Scroll Timelines: sets timelines (evidence: `src/components/Character/utils/character.ts`)
- Visitor → Experience Controller: interacts (evidence: `public/js/app.js`)
- Experience Controller → Scene Engine: sets mode (evidence: `public/js/app.js`)
- Experience Controller → Sound Engine: plays sound (evidence: `public/js/app.js`)
- Experience Controller → Terminal: initializes (evidence: `public/js/app.js`)
- Terminal → Scene Engine: sets mode (evidence: `public/js/terminal.js`)
- Terminal → Sound Engine: plays sound (evidence: `public/js/terminal.js`)
- Experience Controller → Contact Endpoint: posts form (evidence: `public/js/app.js`)
- Experience Controller → Translations (evidence: `public/js/app.js`)
