# orinvernizzi/portfolio architecture

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

## Overview

This is a bilingual personal portfolio with two visitor-facing experiences: a navigable 3D spiral and a plain scrolling list. Visitors open section panels or jump to sections from the menu; project cards can open interactive diagrams. The main internal layers are the application shell, localized content, section views, and spiral rendering. The wiring shown is based on the README and source-index references; some section and component implementations were not sampled, so uncertain links are omitted.

Main entry points: [`src/App.tsx`](https://github.com/orinvernizzi/portfolio/blob/main/src/App.tsx) (App coordinator), [`src/lib/content.ts`](https://github.com/orinvernizzi/portfolio/blob/main/src/lib/content.ts) (Content hooks), [`src/spiral/Spiral.tsx`](https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/Spiral.tsx) (Spiral scene), [`src/components/TopBar.tsx`](https://github.com/orinvernizzi/portfolio/blob/main/src/components/TopBar.tsx) (Top bar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_app["App coordinator<br/>[App.tsx]"]
  node_entry["React entry<br/>[main.tsx]"]
  node_topbar["Top bar<br/>[TopBar.tsx]"]
  node_menu["Section menu<br/>[MenuDrawer.tsx]"]
  node_panel["Section panel<br/>[Panel.tsx]"]
  node_list["List view<br/>[ListView.tsx]"]
  node_landscape["Landscape backdrop<br/>[LandscapeLayer.tsx]"]
  node_preloader["Preloader<br/>[Preloader.tsx]"]
end

subgraph group_content["Content and language"]
  node_language["Language selection<br/>[i18n.ts]"]
  node_contentdata["Localized content<br/>[index.ts]"]
  node_contenthooks["Content hooks<br/>[content.ts]"]
end

subgraph group_sections["Portfolio sections"]
  node_registry["Section registry<br/>[registry.tsx]"]
  node_sectionviews["Section views"]
  node_projects["Project showcase<br/>[Projects.tsx]"]
  node_diagram["Diagram viewer<br/>[DiagramViewer.tsx]"]
  node_rowing["Rowing section<br/>[Rowing.tsx]"]
end

subgraph group_spiral["3D spiral"]
  node_spiral["Spiral scene<br/>[Spiral.tsx]"]
  node_card["3D cards<br/>[Card3D.tsx]"]
  node_cardart["Card artwork<br/>[cardDrawing.ts]"]
  node_scroll["Spiral navigation"]
  node_hud["Spiral HUD<br/>[SpiralHud.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"uses portfolio"| node_app
node_entry -->|"mounts"| node_app
node_app -->|"renders"| node_topbar
node_app -->|"renders"| node_menu
node_app -->|"renders"| node_panel
node_app -->|"renders"| node_list
node_app -->|"renders"| node_landscape
node_app -->|"renders"| node_preloader
node_app -->|"loads"| node_spiral
node_topbar -->|"sets language"| node_language
node_topbar -->|"reads labels"| node_contenthooks
node_language -->|"loads translations"| node_contentdata
node_contenthooks -->|"reads language"| node_language
node_panel -->|"selects view"| node_registry
node_panel -->|"reads section labels"| node_contenthooks
node_registry -->|"registers views"| node_sectionviews
node_list -->|"uses sections"| node_registry
node_list -->|"reads content"| node_contenthooks
node_projects -->|"reads projects"| node_contenthooks
node_projects -->|"opens diagrams"| node_diagram
node_rowing -->|"reads content"| node_contenthooks
node_spiral -->|"renders cards"| node_card
node_spiral -->|"renders HUD"| node_hud
node_card -->|"paints textures"| node_cardart
node_spiral -->|"tracks navigation"| node_scroll
node_spiral -->|"reads content"| node_contenthooks

click node_app "https://github.com/orinvernizzi/portfolio/blob/main/src/App.tsx"
click node_entry "https://github.com/orinvernizzi/portfolio/blob/main/src/main.tsx"
click node_topbar "https://github.com/orinvernizzi/portfolio/blob/main/src/components/TopBar.tsx"
click node_menu "https://github.com/orinvernizzi/portfolio/blob/main/src/components/MenuDrawer.tsx"
click node_panel "https://github.com/orinvernizzi/portfolio/blob/main/src/components/Panel.tsx"
click node_list "https://github.com/orinvernizzi/portfolio/blob/main/src/components/ListView.tsx"
click node_landscape "https://github.com/orinvernizzi/portfolio/blob/main/src/components/LandscapeLayer.tsx"
click node_preloader "https://github.com/orinvernizzi/portfolio/blob/main/src/components/Preloader.tsx"
click node_language "https://github.com/orinvernizzi/portfolio/blob/main/src/i18n.ts"
click node_contentdata "https://github.com/orinvernizzi/portfolio/blob/main/src/content/index.ts"
click node_contenthooks "https://github.com/orinvernizzi/portfolio/blob/main/src/lib/content.ts"
click node_registry "https://github.com/orinvernizzi/portfolio/blob/main/src/sections/registry.tsx"
click node_sectionviews "https://github.com/orinvernizzi/portfolio/tree/main/src/sections"
click node_projects "https://github.com/orinvernizzi/portfolio/blob/main/src/sections/Projects.tsx"
click node_diagram "https://github.com/orinvernizzi/portfolio/blob/main/src/components/DiagramViewer.tsx"
click node_rowing "https://github.com/orinvernizzi/portfolio/blob/main/src/sections/Rowing.tsx"
click node_spiral "https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/Spiral.tsx"
click node_card "https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/Card3D.tsx"
click node_cardart "https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/cardDrawing.ts"
click node_scroll "https://github.com/orinvernizzi/portfolio/blob/main/src/lib/useScrollProgress.ts"
click node_hud "https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/SpiralHud.tsx"

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_entry,node_topbar,node_menu,node_panel,node_list,node_landscape,node_preloader toneBlue
class node_language,node_contentdata,node_contenthooks toneAmber
class node_registry,node_sectionviews,node_projects,node_diagram,node_rowing toneMint
class node_spiral,node_card,node_cardart,node_scroll,node_hud toneRose
class node_visitor toneIndigo
```

## Components

### App shell

- [App coordinator](https://github.com/orinvernizzi/portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [React entry](https://github.com/orinvernizzi/portfolio/blob/main/src/main.tsx): `src/main.tsx`
- [Top bar](https://github.com/orinvernizzi/portfolio/blob/main/src/components/TopBar.tsx): `src/components/TopBar.tsx`
- [Section menu](https://github.com/orinvernizzi/portfolio/blob/main/src/components/MenuDrawer.tsx): `src/components/MenuDrawer.tsx`
- [Section panel](https://github.com/orinvernizzi/portfolio/blob/main/src/components/Panel.tsx): `src/components/Panel.tsx`
- [List view](https://github.com/orinvernizzi/portfolio/blob/main/src/components/ListView.tsx): `src/components/ListView.tsx`
- [Landscape backdrop](https://github.com/orinvernizzi/portfolio/blob/main/src/components/LandscapeLayer.tsx): `src/components/LandscapeLayer.tsx`
- [Preloader](https://github.com/orinvernizzi/portfolio/blob/main/src/components/Preloader.tsx): `src/components/Preloader.tsx`

### Content and language

- [Language selection](https://github.com/orinvernizzi/portfolio/blob/main/src/i18n.ts): `src/i18n.ts`
- [Localized content](https://github.com/orinvernizzi/portfolio/blob/main/src/content/index.ts): `src/content/index.ts`
- [Content hooks](https://github.com/orinvernizzi/portfolio/blob/main/src/lib/content.ts): `src/lib/content.ts`

### Portfolio sections

- [Section registry](https://github.com/orinvernizzi/portfolio/blob/main/src/sections/registry.tsx): `src/sections/registry.tsx`
- [Section views](https://github.com/orinvernizzi/portfolio/tree/main/src/sections): `src/sections`
- [Project showcase](https://github.com/orinvernizzi/portfolio/blob/main/src/sections/Projects.tsx): `src/sections/Projects.tsx`
- [Diagram viewer](https://github.com/orinvernizzi/portfolio/blob/main/src/components/DiagramViewer.tsx): `src/components/DiagramViewer.tsx`
- [Rowing section](https://github.com/orinvernizzi/portfolio/blob/main/src/sections/Rowing.tsx): `src/sections/Rowing.tsx`

### 3D spiral

- [Spiral scene](https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/Spiral.tsx): `src/spiral/Spiral.tsx`
- [3D cards](https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/Card3D.tsx): `src/spiral/Card3D.tsx`
- [Card artwork](https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/cardDrawing.ts): `src/spiral/cardDrawing.ts`
- [Spiral navigation](https://github.com/orinvernizzi/portfolio/blob/main/src/lib/useScrollProgress.ts): `src/lib/useScrollProgress.ts`
- [Spiral HUD](https://github.com/orinvernizzi/portfolio/blob/main/src/spiral/SpiralHud.tsx): `src/spiral/SpiralHud.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → App coordinator: uses portfolio (evidence: `README.md`)
- React entry → App coordinator: mounts (evidence: `src/main.tsx`)
- App coordinator → Top bar: renders (evidence: `src/App.tsx`)
- App coordinator → Section menu: renders (evidence: `src/App.tsx`)
- App coordinator → Section panel: renders (evidence: `src/App.tsx`)
- App coordinator → List view: renders (evidence: `src/App.tsx`)
- App coordinator → Landscape backdrop: renders (evidence: `src/App.tsx`)
- App coordinator → Preloader: renders (evidence: `src/App.tsx`)
- App coordinator → Spiral scene: loads (evidence: `src/App.tsx`)
- Top bar → Language selection: sets language (evidence: `src/components/TopBar.tsx`)
- Top bar → Content hooks: reads labels (evidence: `src/components/TopBar.tsx`)
- Language selection → Localized content: loads translations (evidence: `src/i18n.ts`)
- Content hooks → Language selection: reads language (evidence: `src/lib/content.ts`)
- Section panel → Section registry: selects view (evidence: `src/components/Panel.tsx`)
- Section panel → Content hooks: reads section labels (evidence: `src/components/Panel.tsx`)
- Section registry → Section views: registers views (evidence: `src/sections/registry.tsx`)
- List view → Section registry: uses sections (evidence: `src/components/ListView.tsx`)
- List view → Content hooks: reads content (evidence: `src/components/ListView.tsx`)
- Project showcase → Content hooks: reads projects (evidence: `src/sections/Projects.tsx`)
- Project showcase → Diagram viewer: opens diagrams (evidence: `src/sections/Projects.tsx`)
- Rowing section → Content hooks: reads content (evidence: `src/sections/Rowing.tsx`)
- Spiral scene → 3D cards: renders cards (evidence: `src/spiral/Spiral.tsx`)
- Spiral scene → Spiral HUD: renders HUD (evidence: `src/spiral/Spiral.tsx`)
- 3D cards → Card artwork: paints textures (evidence: `src/spiral/Card3D.tsx`)
- Spiral scene → Spiral navigation: tracks navigation (evidence: `src/spiral/Spiral.tsx`)
- Spiral scene → Content hooks: reads content (evidence: `src/spiral/Spiral.tsx`)
