# adalamanju06-arch/myportfolio architecture

> Architecture diagram of the GitHub repository adalamanju06-arch/myportfolio, 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/adalamanju06-arch/myportfolio
- Repository: https://github.com/adalamanju06-arch/myportfolio

## Overview

This repository is a personal portfolio website. Its main user journey is opening the portfolio, completing the character-model loading intro, and exploring landing, about, skills, work, career, and contact content through a scroll-driven page. The sampled source shows the app composition and 3D scene flow; the README provides no further capability details, so some page-section connections are based on the indexed MainContainer references rather than inspected implementation.

Main entry points: [`src/components/MainContainer.tsx`](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/MainContainer.tsx) (Page composition), [`src/components/Character/Scene.tsx`](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/Scene.tsx) (Character view), [`src/App.tsx`](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/App.tsx) (App composition), [`src/context/LoadingProvider.tsx`](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/context/LoadingProvider.tsx) (Loading state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Portfolio shell"]
  node_root["React entry<br/>[main.tsx]"]
  node_appcomp["App composition<br/>[App.tsx]"]
end

subgraph group_content["Portfolio sections"]
  node_sections["Page composition<br/>[MainContainer.tsx]"]
  node_landing["Landing section<br/>[Landing.tsx]"]
  node_about["About section<br/>[About.tsx]"]
  node_career["Career timeline<br/>[Career.tsx]"]
  node_whatido["Skills overview<br/>[WhatIDo.tsx]"]
  node_techstack["Interactive tech stack<br/>[TechStack.tsx]"]
  node_work["Work portfolio<br/>[Work.tsx]"]
  node_contact["Contact section<br/>[Contact.tsx]"]
  node_navigation["Navigation<br/>[Navbar.tsx]"]
  node_social["Social links<br/>[SocialIcons.tsx]"]
  node_cursor["Custom cursor<br/>[Cursor.tsx]"]
end

subgraph group_character["3D character"]
  node_modelview["Character view<br/>[Scene.tsx]"]
  node_modelsetup["Model loader<br/>[character.ts]"]
  node_animation["Character animation<br/>[animationUtils.ts]"]
  node_pointer["Pointer interaction<br/>[mouseUtils.ts]"]
  node_lighting["Scene lighting<br/>[lighting.ts]"]
  node_resize["Scene resizing<br/>[resizeUtils.ts]"]
  node_boneconfig["Rig bone data<br/>[boneData.ts]"]
end

subgraph group_motion["Loading and motion"]
  node_loadstate["Loading state"]
  node_loaderui["Loading intro<br/>[Loading.tsx]"]
  node_introfx["Intro effects<br/>[initialFX.ts]"]
  node_scrollmotion["Scroll choreography<br/>[GsapScroll.ts]"]
  node_textmotion["Text splitting<br/>[splitText.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_root
node_root -->|"renders"| node_appcomp
node_appcomp -->|"renders"| node_sections
node_appcomp -->|"wraps with"| node_loadstate
node_appcomp -->|"loads"| node_modelview
node_sections -->|"renders"| node_landing
node_sections -->|"renders"| node_about
node_sections -->|"renders"| node_career
node_sections -->|"renders"| node_whatido
node_sections -->|"renders"| node_techstack
node_sections -->|"renders"| node_work
node_sections -->|"renders"| node_contact
node_sections -->|"renders"| node_navigation
node_sections -->|"renders"| node_social
node_sections -->|"renders"| node_cursor
node_sections -->|"uses"| node_textmotion
node_loadstate -->|"renders"| node_loaderui
node_loaderui -->|"updates"| node_loadstate
node_loaderui -->|"runs"| node_introfx
node_modelview -->|"reports progress"| node_loadstate
node_modelview -->|"loads model"| node_modelsetup
node_modelview -->|"starts animations"| node_animation
node_modelview -->|"handles input"| node_pointer
node_modelview -->|"sets lighting"| node_lighting
node_modelview -->|"handles resize"| node_resize
node_modelsetup -->|"configures timelines"| node_scrollmotion
node_animation -->|"uses bone data"| node_boneconfig

click node_root "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/main.tsx"
click node_appcomp "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/App.tsx"
click node_sections "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/MainContainer.tsx"
click node_landing "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Landing.tsx"
click node_about "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/About.tsx"
click node_career "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Career.tsx"
click node_whatido "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/WhatIDo.tsx"
click node_techstack "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/TechStack.tsx"
click node_work "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Work.tsx"
click node_contact "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Contact.tsx"
click node_navigation "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Navbar.tsx"
click node_social "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/SocialIcons.tsx"
click node_cursor "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Cursor.tsx"
click node_modelview "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/Scene.tsx"
click node_modelsetup "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/character.ts"
click node_animation "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/animationUtils.ts"
click node_pointer "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/mouseUtils.ts"
click node_lighting "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/lighting.ts"
click node_resize "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/resizeUtils.ts"
click node_boneconfig "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/data/boneData.ts"
click node_loadstate "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/context/LoadingProvider.tsx"
click node_loaderui "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Loading.tsx"
click node_introfx "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/utils/initialFX.ts"
click node_scrollmotion "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/utils/GsapScroll.ts"
click node_textmotion "https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/utils/splitText.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_root,node_appcomp toneBlue
class node_sections,node_landing,node_about,node_career,node_whatido,node_techstack,node_work,node_contact,node_navigation,node_social,node_cursor toneAmber
class node_modelview,node_modelsetup,node_animation,node_pointer,node_lighting,node_resize,node_boneconfig toneMint
class node_loadstate,node_loaderui,node_introfx,node_scrollmotion,node_textmotion toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio shell

- [React entry](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/main.tsx): `src/main.tsx`
- [App composition](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/App.tsx): `src/App.tsx`

### Portfolio sections

- [Page composition](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/MainContainer.tsx): `src/components/MainContainer.tsx`
- [Landing section](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Landing.tsx): `src/components/Landing.tsx`
- [About section](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Career timeline](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Career.tsx): `src/components/Career.tsx`
- [Skills overview](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/WhatIDo.tsx): `src/components/WhatIDo.tsx`
- [Interactive tech stack](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/TechStack.tsx): `src/components/TechStack.tsx`
- [Work portfolio](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Work.tsx): `src/components/Work.tsx`
- [Contact section](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`
- [Navigation](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Social links](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/SocialIcons.tsx): `src/components/SocialIcons.tsx`
- [Custom cursor](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Cursor.tsx): `src/components/Cursor.tsx`

### 3D character

- [Character view](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/Scene.tsx): `src/components/Character/Scene.tsx`
- [Model loader](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/character.ts): `src/components/Character/utils/character.ts`
- [Character animation](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/animationUtils.ts): `src/components/Character/utils/animationUtils.ts`
- [Pointer interaction](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/mouseUtils.ts): `src/components/Character/utils/mouseUtils.ts`
- [Scene lighting](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/lighting.ts): `src/components/Character/utils/lighting.ts`
- [Scene resizing](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Character/utils/resizeUtils.ts): `src/components/Character/utils/resizeUtils.ts`
- [Rig bone data](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/data/boneData.ts): `src/data/boneData.ts`

### Loading and motion

- [Loading state](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/context/LoadingProvider.tsx): `src/context/LoadingProvider.tsx`
- [Loading intro](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/Loading.tsx): `src/components/Loading.tsx`
- [Intro effects](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/utils/initialFX.ts): `src/components/utils/initialFX.ts`
- [Scroll choreography](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/utils/GsapScroll.ts): `src/components/utils/GsapScroll.ts`
- [Text splitting](https://github.com/adalamanju06-arch/myportfolio/blob/main/src/components/utils/splitText.ts): `src/components/utils/splitText.ts`

### Other components

- **Visitor**

## Connections

- Visitor → React entry: opens (evidence: `src/main.tsx`)
- React entry → App composition: renders (evidence: `src/main.tsx`)
- App composition → Page composition: renders (evidence: `src/App.tsx`)
- App composition → Loading state: wraps with (evidence: `src/App.tsx`)
- App composition → Character view: loads (evidence: `src/App.tsx`)
- Page composition → Landing section: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → About section: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Career timeline: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Skills overview: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Interactive tech stack: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Work portfolio: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Contact section: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Navigation: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Social links: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Custom cursor: renders (evidence: `src/components/MainContainer.tsx`)
- Page composition → Text splitting: uses (evidence: `src/components/MainContainer.tsx`)
- Loading state → Loading intro: renders (evidence: `src/context/LoadingProvider.tsx`)
- Loading intro → Loading state: updates (evidence: `src/components/Loading.tsx`)
- Loading intro → Intro effects: runs (evidence: `src/components/Loading.tsx`)
- Character view → Loading state: reports progress (evidence: `src/components/Character/Scene.tsx`)
- Character view → Model loader: loads model (evidence: `src/components/Character/Scene.tsx`)
- Character view → Character animation: starts animations (evidence: `src/components/Character/Scene.tsx`)
- Character view → Pointer interaction: handles input (evidence: `src/components/Character/Scene.tsx`)
- Character view → Scene lighting: sets lighting (evidence: `src/components/Character/Scene.tsx`)
- Character view → Scene resizing: handles resize (evidence: `src/components/Character/Scene.tsx`)
- Model loader → Scroll choreography: configures timelines (evidence: `src/components/Character/utils/character.ts`)
- Character animation → Rig bone data: uses bone data (evidence: `src/components/Character/utils/animationUtils.ts`)
