# ahmed3304/portfolio architecture

> Architecture diagram of the GitHub repository ahmed3304/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/ahmed3304/portfolio
- Repository: https://github.com/ahmed3304/portfolio

## Overview

This is a Three.js/WebGL 3D portfolio: the browser starts a shared Experience runtime, loads scene assets, presents an animated room, and lets visitors navigate portfolio sections through scrolling. The graph retains the main scene and runtime layers. The README gives only a brief product description, and some core files are indexed or partially excerpted; uncertain asset-manifest details and page-content wiring are therefore not inferred.

Main entry points: [`Experience/Experience.js`](https://github.com/ahmed3304/portfolio/blob/master/Experience/Experience.js) (Experience runtime), [`Experience/World/World.js`](https://github.com/ahmed3304/portfolio/blob/master/Experience/World/World.js) (World coordinator), [`Experience/Preloader.js`](https://github.com/ahmed3304/portfolio/blob/master/Experience/Preloader.js) (Intro sequence), [`Experience/World/Room.js`](https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Room.js) (Portfolio room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Browser entry"]
  node_browser["Browser canvas<br/>[index.html]"]
  node_entrypoint["App entry<br/>[main.js]"]
end

subgraph group_runtime["Experience runtime"]
  node_experience["Experience runtime<br/>[Experience.js]"]
  node_clock["Frame clock<br/>[Time.js]"]
  node_viewport["Viewport sizing<br/>[Sizes.js]"]
  node_assetlist["Asset manifest<br/>[assets.js]"]
  node_loader["Asset loader<br/>[Resources.js]"]
  node_theme["Theme state<br/>[Theme.js]"]
end

subgraph group_scene["3D portfolio scene"]
  node_camera["Cameras<br/>[Camera.js]"]
  node_renderer["WebGL renderer<br/>[Renderer.js]"]
  node_world["World coordinator<br/>[World.js]"]
  node_room["Portfolio room<br/>[Room.js]"]
  node_floor["Floor scene<br/>[Floor.js]"]
  node_environment["Lighting<br/>[Environment.js]"]
end

subgraph group_interaction["Visitor interaction"]
  node_preloader["Intro sequence<br/>[Preloader.js]"]
  node_textsplit["Text splitting"]
  node_controls["Scroll navigation<br/>[Controls.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"views"| node_browser
node_browser -->|"hosts"| node_entrypoint
node_entrypoint -->|"creates"| node_experience
node_experience -->|"creates"| node_clock
node_experience -->|"creates"| node_viewport
node_experience -->|"loads config"| node_assetlist
node_experience -->|"creates"| node_loader
node_experience -->|"creates"| node_camera
node_experience -->|"creates"| node_renderer
node_experience -->|"creates"| node_world
node_experience -->|"creates"| node_theme
node_experience -->|"creates"| node_preloader
node_experience -->|"enables on event"| node_controls
node_experience -->|"updates"| node_renderer
node_renderer -->|"renders through"| node_camera
node_experience -->|"updates"| node_world
node_world -->|"waits for ready"| node_loader
node_world -->|"creates"| node_environment
node_world -->|"creates"| node_floor
node_world -->|"creates"| node_room
node_room -->|"reads assets"| node_loader
node_world -->|"subscribes to changes"| node_theme
node_world -->|"switches lighting"| node_environment
node_experience -.->|"subscribes to ticks"| node_clock
node_preloader -->|"splits text"| node_textsplit
node_preloader -->|"animates room"| node_room
node_visitor -.->|"starts intro"| node_preloader
node_visitor -.->|"scrolls sections"| node_controls
node_experience -->|"updates"| node_controls
node_controls -->|"animates sections"| node_room

click node_browser "https://github.com/ahmed3304/portfolio/blob/master/index.html"
click node_entrypoint "https://github.com/ahmed3304/portfolio/blob/master/main.js"
click node_experience "https://github.com/ahmed3304/portfolio/blob/master/Experience/Experience.js"
click node_clock "https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/Time.js"
click node_viewport "https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/Sizes.js"
click node_assetlist "https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/assets.js"
click node_loader "https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/Resources.js"
click node_preloader "https://github.com/ahmed3304/portfolio/blob/master/Experience/Preloader.js"
click node_textsplit "https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/covertDivsToSpans.js"
click node_camera "https://github.com/ahmed3304/portfolio/blob/master/Experience/Camera.js"
click node_renderer "https://github.com/ahmed3304/portfolio/blob/master/Experience/Renderer.js"
click node_world "https://github.com/ahmed3304/portfolio/blob/master/Experience/World/World.js"
click node_room "https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Room.js"
click node_floor "https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Floor.js"
click node_environment "https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Environment.js"
click node_theme "https://github.com/ahmed3304/portfolio/blob/master/Experience/Theme.js"
click node_controls "https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Controls.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_browser,node_entrypoint toneBlue
class node_experience,node_clock,node_viewport,node_assetlist,node_loader,node_theme toneAmber
class node_camera,node_renderer,node_world,node_room,node_floor,node_environment toneMint
class node_preloader,node_textsplit,node_controls toneRose
class node_visitor toneIndigo
```

## Components

### Browser entry

- [Browser canvas](https://github.com/ahmed3304/portfolio/blob/master/index.html): `index.html`
- [App entry](https://github.com/ahmed3304/portfolio/blob/master/main.js): `main.js`

### Experience runtime

- [Experience runtime](https://github.com/ahmed3304/portfolio/blob/master/Experience/Experience.js): `Experience/Experience.js`
- [Frame clock](https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/Time.js): `Experience/Utils/Time.js`
- [Viewport sizing](https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/Sizes.js): `Experience/Utils/Sizes.js`
- [Asset manifest](https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/assets.js): `Experience/Utils/assets.js`
- [Asset loader](https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/Resources.js): `Experience/Utils/Resources.js`
- [Theme state](https://github.com/ahmed3304/portfolio/blob/master/Experience/Theme.js): `Experience/Theme.js`

### 3D portfolio scene

- [Cameras](https://github.com/ahmed3304/portfolio/blob/master/Experience/Camera.js): `Experience/Camera.js`
- [WebGL renderer](https://github.com/ahmed3304/portfolio/blob/master/Experience/Renderer.js): `Experience/Renderer.js`
- [World coordinator](https://github.com/ahmed3304/portfolio/blob/master/Experience/World/World.js): `Experience/World/World.js`
- [Portfolio room](https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Room.js): `Experience/World/Room.js`
- [Floor scene](https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Floor.js): `Experience/World/Floor.js`
- [Lighting](https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Environment.js): `Experience/World/Environment.js`

### Visitor interaction

- [Intro sequence](https://github.com/ahmed3304/portfolio/blob/master/Experience/Preloader.js): `Experience/Preloader.js`
- [Text splitting](https://github.com/ahmed3304/portfolio/blob/master/Experience/Utils/covertDivsToSpans.js): `Experience/Utils/covertDivsToSpans.js`
- [Scroll navigation](https://github.com/ahmed3304/portfolio/blob/master/Experience/World/Controls.js): `Experience/World/Controls.js`

### Other components

- **Visitor**

## Connections

- Visitor → Browser canvas: views (evidence: `README.md`)
- Browser canvas → App entry: hosts (evidence: `main.js`)
- App entry → Experience runtime: creates (evidence: `main.js`)
- Experience runtime → Frame clock: creates (evidence: `Experience/Experience.js`)
- Experience runtime → Viewport sizing: creates (evidence: `Experience/Experience.js`)
- Experience runtime → Asset manifest: loads config (evidence: `Experience/Experience.js`)
- Experience runtime → Asset loader: creates (evidence: `Experience/Experience.js`)
- Experience runtime → Cameras: creates (evidence: `Experience/Experience.js`)
- Experience runtime → WebGL renderer: creates (evidence: `Experience/Experience.js`)
- Experience runtime → World coordinator: creates (evidence: `Experience/Experience.js`)
- Experience runtime → Theme state: creates (evidence: `Experience/Experience.js`)
- Experience runtime → Intro sequence: creates (evidence: `Experience/Experience.js`)
- Experience runtime → Scroll navigation: enables on event (evidence: `Experience/Experience.js`)
- Experience runtime → WebGL renderer: updates (evidence: `Experience/Experience.js`)
- WebGL renderer → Cameras: renders through (evidence: `Experience/Renderer.js`)
- Experience runtime → World coordinator: updates (evidence: `Experience/Experience.js`)
- World coordinator → Asset loader: waits for ready (evidence: `Experience/World/World.js`)
- World coordinator → Lighting: creates (evidence: `Experience/World/World.js`)
- World coordinator → Floor scene: creates (evidence: `Experience/World/World.js`)
- World coordinator → Portfolio room: creates (evidence: `Experience/World/World.js`)
- Portfolio room → Asset loader: reads assets (evidence: `Experience/World/Room.js`)
- World coordinator → Theme state: subscribes to changes (evidence: `Experience/World/World.js`)
- World coordinator → Lighting: switches lighting (evidence: `Experience/World/World.js`)
- Experience runtime → Frame clock: subscribes to ticks (evidence: `Experience/Experience.js`)
- Intro sequence → Text splitting: splits text (evidence: `Experience/Preloader.js`)
- Intro sequence → Portfolio room: animates room (evidence: `Experience/Preloader.js`)
- Visitor → Intro sequence: starts intro
- Visitor → Scroll navigation: scrolls sections
- Experience runtime → Scroll navigation: updates (evidence: `Experience/Experience.js`)
- Scroll navigation → Portfolio room: animates sections (evidence: `Experience/World/Controls.js`)
