# leonardoszervinski/portfolio architecture

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

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

## Overview

This is a bilingual, interactive personal portfolio: visitors explore a hero scene, scroll or use touch/keyboard to fly into a laptop, and browse animated project showcases. They can also open project stories, profile and résumé dialogs, and switch language. The graph follows the documented runtime composition; arrows are limited to relationships shown in excerpts, the source index, or README. Several product components are documented but not sampled, so their internal links are omitted.

Main entry points: [`src/main.js`](https://github.com/leonardoszervinski/portfolio/blob/main/src/main.js) (Page composition), [`src/journey/Journey.js`](https://github.com/leonardoszervinski/portfolio/blob/main/src/journey/Journey.js) (Journey state), [`src/components/StoryDialog.js`](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/StoryDialog.js) (Project stories), [`src/input/InputController.js`](https://github.com/leonardoszervinski/portfolio/blob/main/src/input/InputController.js) (Gesture controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_journey["Journey and input"]
  node_input["Gesture controls<br/>[InputController.js]"]
  node_gestures["Gesture physics<br/>[gestures.js]"]
  node_journey_state["Journey state<br/>[Journey.js]"]
  node_progress["Progress tween<br/>[ProgressTween.js]"]
  node_layout["Viewport layout<br/>[ViewportLayout.js]"]
  node_geometry["Camera geometry<br/>[geometry.js]"]
end

subgraph group_showcase["Project showcase"]
  node_showcase_panel["Project details<br/>[ShowcasePanel.js]"]
  node_player["Screen player<br/>[ScreenPlayer.js]"]
  node_factory["Slide factory<br/>[slideFactory.js]"]
  node_scene_slide["Scene slide<br/>[SceneSlide.js]"]
  node_video_slide["Video slide<br/>[VideoSlide.js]"]
  node_projects["Project catalog<br/>[projects.js]"]
  node_scenes["Showcase scenes<br/>[scenes.js]"]
  node_story["Project stories<br/>[StoryDialog.js]"]
  node_story_content["Story content<br/>[story.js]"]
end

subgraph group_interface["Portfolio interface"]
  node_entry["Page composition<br/>[main.js]"]
  node_laptop["Laptop model<br/>[Laptop.js]"]
  node_hero["Hero scene<br/>[Hero.js]"]
  node_badge["Profile badge<br/>[Badge.js]"]
  node_memoji["Memoji display<br/>[Memoji.js]"]
  node_dialog["Accessible dialogs<br/>[Dialog.js]"]
  node_resume["Résumé dialog<br/>[ResumeDialog.js]"]
  node_resume_reveal["Résumé reveal<br/>[ResumeReveal.js]"]
  node_language_toggle["Language toggle<br/>[LanguageToggle.js]"]
  node_contact["Contact details<br/>[contact.js]"]
end

subgraph group_shared["Shared runtime"]
  node_i18n["Localization<br/>[I18n.js]"]
  node_translations["Translations<br/>[translations.js]"]
  node_bus["Event bus<br/>[EventBus.js]"]
  node_motion["Motion support<br/>[Motion.js]"]
  node_math["Math helpers<br/>[math.js]"]
  node_dom["DOM helpers<br/>[dom.js]"]
end

node_visitor(("Visitor"))
node_storage[("Browser storage")]
node_audio_assets["Narration audio"]

node_visitor -->|"opens portfolio"| node_entry
node_entry -->|"registers controls"| node_input
node_entry -->|"wires journey"| node_journey_state
node_entry -->|"creates hero"| node_hero
node_entry -->|"creates badge"| node_badge
node_entry -->|"creates display"| node_memoji
node_entry -->|"creates layout"| node_layout
node_entry -->|"creates dialogs"| node_dialog
node_entry -->|"creates story"| node_story
node_entry -->|"creates reveal"| node_resume_reveal
node_entry -->|"creates toggle"| node_language_toggle
node_entry -->|"creates localization"| node_i18n
node_entry -->|"creates event bus"| node_bus
node_entry -->|"creates motion"| node_motion
node_entry -->|"sets contact links"| node_contact
node_visitor -->|"sends gestures"| node_input
node_input -->|"commands journey"| node_journey_state
node_input -->|"measures swipes"| node_gestures
node_journey_state -->|"advances progress"| node_progress
node_journey_state -->|"calculates poses"| node_geometry
node_journey_state -->|"measures viewport"| node_layout
node_journey_state -->|"moves laptop"| node_laptop
node_journey_state -->|"positions display"| node_memoji
node_journey_state -->|"updates hero"| node_hero
node_journey_state -->|"updates project UI"| node_showcase_panel
node_journey_state -->|"controls playback"| node_player
node_layout -->|"uses geometry"| node_geometry
node_geometry -->|"uses math"| node_math
node_progress -->|"uses math"| node_math
node_player -->|"creates slides"| node_factory
node_factory -->|"creates scenes"| node_scene_slide
node_factory -->|"creates videos"| node_video_slide
node_visitor -->|"browses projects"| node_player
node_scenes -.->|"provides scene data"| node_scene_slide
node_projects -.->|"supplies project media"| node_player
node_story -->|"extends dialog"| node_dialog
node_story -->|"builds story slides"| node_dom
node_visitor -->|"opens project stories"| node_story
node_story -.->|"uses story content"| node_story_content
node_story -.->|"plays narration"| node_audio_assets
node_resume -->|"extends dialog"| node_dialog
node_entry -.->|"opens résumé"| node_resume
node_visitor -->|"chooses language"| node_language_toggle
node_language_toggle -.->|"sets language"| node_i18n
node_i18n -->|"reads strings"| node_translations
node_i18n -->|"persists choice"| node_storage
node_entry -->|"loads translations"| node_translations
node_entry -->|"loads projects"| node_projects

click node_entry "https://github.com/leonardoszervinski/portfolio/blob/main/src/main.js"
click node_input "https://github.com/leonardoszervinski/portfolio/blob/main/src/input/InputController.js"
click node_gestures "https://github.com/leonardoszervinski/portfolio/blob/main/src/journey/gestures.js"
click node_journey_state "https://github.com/leonardoszervinski/portfolio/blob/main/src/journey/Journey.js"
click node_progress "https://github.com/leonardoszervinski/portfolio/blob/main/src/journey/ProgressTween.js"
click node_layout "https://github.com/leonardoszervinski/portfolio/blob/main/src/layout/ViewportLayout.js"
click node_geometry "https://github.com/leonardoszervinski/portfolio/blob/main/src/layout/geometry.js"
click node_laptop "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Laptop.js"
click node_hero "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Hero.js"
click node_badge "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Badge.js"
click node_memoji "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Memoji.js"
click node_showcase_panel "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/ShowcasePanel.js"
click node_player "https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/ScreenPlayer.js"
click node_factory "https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/slideFactory.js"
click node_scene_slide "https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/SceneSlide.js"
click node_video_slide "https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/VideoSlide.js"
click node_projects "https://github.com/leonardoszervinski/portfolio/blob/main/src/config/projects.js"
click node_scenes "https://github.com/leonardoszervinski/portfolio/blob/main/src/config/scenes.js"
click node_story "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/StoryDialog.js"
click node_story_content "https://github.com/leonardoszervinski/portfolio/blob/main/src/config/story.js"
click node_dialog "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Dialog.js"
click node_resume "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/ResumeDialog.js"
click node_resume_reveal "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/ResumeReveal.js"
click node_language_toggle "https://github.com/leonardoszervinski/portfolio/blob/main/src/components/LanguageToggle.js"
click node_i18n "https://github.com/leonardoszervinski/portfolio/blob/main/src/i18n/I18n.js"
click node_translations "https://github.com/leonardoszervinski/portfolio/blob/main/src/config/translations.js"
click node_bus "https://github.com/leonardoszervinski/portfolio/blob/main/src/core/EventBus.js"
click node_motion "https://github.com/leonardoszervinski/portfolio/blob/main/src/core/Motion.js"
click node_math "https://github.com/leonardoszervinski/portfolio/blob/main/src/core/math.js"
click node_dom "https://github.com/leonardoszervinski/portfolio/blob/main/src/core/dom.js"
click node_contact "https://github.com/leonardoszervinski/portfolio/blob/main/src/config/contact.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_input,node_gestures,node_journey_state,node_progress,node_layout,node_geometry toneBlue
class node_showcase_panel,node_player,node_factory,node_scene_slide,node_video_slide,node_projects,node_scenes,node_story,node_story_content,node_storage toneAmber
class node_entry,node_laptop,node_hero,node_badge,node_memoji,node_dialog,node_resume,node_resume_reveal,node_language_toggle,node_contact toneMint
class node_i18n,node_translations,node_bus,node_motion,node_math,node_dom toneRose
class node_visitor,node_audio_assets toneIndigo
```

## Components

### Journey and input

- [Gesture controls](https://github.com/leonardoszervinski/portfolio/blob/main/src/input/InputController.js): `src/input/InputController.js`
- [Gesture physics](https://github.com/leonardoszervinski/portfolio/blob/main/src/journey/gestures.js): `src/journey/gestures.js`
- [Journey state](https://github.com/leonardoszervinski/portfolio/blob/main/src/journey/Journey.js): `src/journey/Journey.js`
- [Progress tween](https://github.com/leonardoszervinski/portfolio/blob/main/src/journey/ProgressTween.js): `src/journey/ProgressTween.js`
- [Viewport layout](https://github.com/leonardoszervinski/portfolio/blob/main/src/layout/ViewportLayout.js): `src/layout/ViewportLayout.js`
- [Camera geometry](https://github.com/leonardoszervinski/portfolio/blob/main/src/layout/geometry.js): `src/layout/geometry.js`

### Project showcase

- [Project details](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/ShowcasePanel.js): `src/components/ShowcasePanel.js`
- [Screen player](https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/ScreenPlayer.js): `src/screen/ScreenPlayer.js`
- [Slide factory](https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/slideFactory.js): `src/screen/slideFactory.js`
- [Scene slide](https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/SceneSlide.js): `src/screen/SceneSlide.js`
- [Video slide](https://github.com/leonardoszervinski/portfolio/blob/main/src/screen/VideoSlide.js): `src/screen/VideoSlide.js`
- [Project catalog](https://github.com/leonardoszervinski/portfolio/blob/main/src/config/projects.js): `src/config/projects.js`
- [Showcase scenes](https://github.com/leonardoszervinski/portfolio/blob/main/src/config/scenes.js): `src/config/scenes.js`
- [Project stories](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/StoryDialog.js): `src/components/StoryDialog.js`
- [Story content](https://github.com/leonardoszervinski/portfolio/blob/main/src/config/story.js): `src/config/story.js`

### Portfolio interface

- [Page composition](https://github.com/leonardoszervinski/portfolio/blob/main/src/main.js): `src/main.js`
- [Laptop model](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Laptop.js): `src/components/Laptop.js`
- [Hero scene](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Hero.js): `src/components/Hero.js`
- [Profile badge](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Badge.js): `src/components/Badge.js`
- [Memoji display](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Memoji.js): `src/components/Memoji.js`
- [Accessible dialogs](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/Dialog.js): `src/components/Dialog.js`
- [Résumé dialog](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/ResumeDialog.js): `src/components/ResumeDialog.js`
- [Résumé reveal](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/ResumeReveal.js): `src/components/ResumeReveal.js`
- [Language toggle](https://github.com/leonardoszervinski/portfolio/blob/main/src/components/LanguageToggle.js): `src/components/LanguageToggle.js`
- [Contact details](https://github.com/leonardoszervinski/portfolio/blob/main/src/config/contact.js): `src/config/contact.js`

### Shared runtime

- [Localization](https://github.com/leonardoszervinski/portfolio/blob/main/src/i18n/I18n.js): `src/i18n/I18n.js`
- [Translations](https://github.com/leonardoszervinski/portfolio/blob/main/src/config/translations.js): `src/config/translations.js`
- [Event bus](https://github.com/leonardoszervinski/portfolio/blob/main/src/core/EventBus.js): `src/core/EventBus.js`
- [Motion support](https://github.com/leonardoszervinski/portfolio/blob/main/src/core/Motion.js): `src/core/Motion.js`
- [Math helpers](https://github.com/leonardoszervinski/portfolio/blob/main/src/core/math.js): `src/core/math.js`
- [DOM helpers](https://github.com/leonardoszervinski/portfolio/blob/main/src/core/dom.js): `src/core/dom.js`

### Other components

- **Visitor**
- **Browser storage**
- **Narration audio**

## Connections

- Visitor → Page composition: opens portfolio (evidence: `README.md`)
- Page composition → Gesture controls: registers controls (evidence: `src/main.js`)
- Page composition → Journey state: wires journey (evidence: `src/main.js`)
- Page composition → Hero scene: creates hero (evidence: `src/main.js`)
- Page composition → Profile badge: creates badge (evidence: `src/main.js`)
- Page composition → Memoji display: creates display (evidence: `src/main.js`)
- Page composition → Viewport layout: creates layout (evidence: `src/main.js`)
- Page composition → Accessible dialogs: creates dialogs (evidence: `src/main.js`)
- Page composition → Project stories: creates story (evidence: `src/main.js`)
- Page composition → Résumé reveal: creates reveal (evidence: `src/main.js`)
- Page composition → Language toggle: creates toggle (evidence: `src/main.js`)
- Page composition → Localization: creates localization (evidence: `src/main.js`)
- Page composition → Event bus: creates event bus (evidence: `src/main.js`)
- Page composition → Motion support: creates motion (evidence: `src/main.js`)
- Page composition → Contact details: sets contact links (evidence: `src/main.js`)
- Visitor → Gesture controls: sends gestures (evidence: `README.md`)
- Gesture controls → Journey state: commands journey (evidence: `src/input/InputController.js`)
- Gesture controls → Gesture physics: measures swipes (evidence: `src/input/InputController.js`)
- Journey state → Progress tween: advances progress (evidence: `src/journey/Journey.js`)
- Journey state → Camera geometry: calculates poses (evidence: `src/journey/Journey.js`)
- Journey state → Viewport layout: measures viewport (evidence: `src/journey/Journey.js`)
- Journey state → Laptop model: moves laptop (evidence: `src/main.js`)
- Journey state → Memoji display: positions display (evidence: `src/main.js`)
- Journey state → Hero scene: updates hero (evidence: `src/main.js`)
- Journey state → Project details: updates project UI (evidence: `src/main.js`)
- Journey state → Screen player: controls playback (evidence: `src/main.js`)
- Viewport layout → Camera geometry: uses geometry (evidence: `src/layout/ViewportLayout.js`)
- Camera geometry → Math helpers: uses math (evidence: `src/layout/geometry.js`)
- Progress tween → Math helpers: uses math (evidence: `src/journey/ProgressTween.js`)
- Screen player → Slide factory: creates slides (evidence: `src/screen/ScreenPlayer.js`)
- Slide factory → Scene slide: creates scenes (evidence: `src/screen/slideFactory.js`)
- Slide factory → Video slide: creates videos (evidence: `src/screen/slideFactory.js`)
- Visitor → Screen player: browses projects (evidence: `README.md`)
- Showcase scenes → Scene slide: provides scene data
- Project catalog → Screen player: supplies project media
- Project stories → Accessible dialogs: extends dialog (evidence: `src/components/StoryDialog.js`)
- Project stories → DOM helpers: builds story slides (evidence: `src/components/StoryDialog.js`)
- Visitor → Project stories: opens project stories (evidence: `README.md`)
- Project stories → Story content: uses story content
- Project stories → Narration audio: plays narration
- Résumé dialog → Accessible dialogs: extends dialog (evidence: `src/components/ResumeDialog.js`)
- Page composition → Résumé dialog: opens résumé (evidence: `src/main.js`)
- Visitor → Language toggle: chooses language (evidence: `README.md`)
- Language toggle → Localization: sets language
- Localization → Translations: reads strings (evidence: `src/i18n/I18n.js`)
- Localization → Browser storage: persists choice (evidence: `src/i18n/I18n.js`)
- Page composition → Translations: loads translations (evidence: `src/main.js`)
- Page composition → Project catalog: loads projects (evidence: `src/main.js`)
