# kathir57/portfolio architecture

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

## Overview

This is a React portfolio website presenting the owner’s experience, services, work, and contact details. The main visitor workflow is to enter the page, pass through a loading overlay, then explore sections through scrolling or navigation; a Three.js character accompanies the experience. Separate branches cover the portfolio’s content sections and its character’s model, animation, lighting, and input behavior. The source index supports the listed module relationships, but several section implementations were not excerpted, so their internal behavior and links are not expanded.

Main entry points: [`src/components/MainContainer.tsx`](https://github.com/kathir57/portfolio/blob/main/src/components/MainContainer.tsx) (Page Composer), [`src/components/Character/Scene.tsx`](https://github.com/kathir57/portfolio/blob/main/src/components/Character/Scene.tsx) (Three.js Scene), [`src/App.tsx`](https://github.com/kathir57/portfolio/blob/main/src/App.tsx) (App), [`src/components/Loading.tsx`](https://github.com/kathir57/portfolio/blob/main/src/components/Loading.tsx) (Loading Screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_entry["React Entry<br/>[main.tsx]"]
  node_app_component["App<br/>[App.tsx]"]
  node_main["Page Composer<br/>[MainContainer.tsx]"]
  node_loading_context["Loading State"]
end

subgraph group_content["Portfolio Content"]
  node_landing["Landing<br/>[Landing.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_services["Services<br/>[WhatIDo.tsx]"]
  node_career["Career<br/>[Career.tsx]"]
  node_work["Work Carousel<br/>[Work.tsx]"]
  node_work_image["Project Image<br/>[WorkImage.tsx]"]
  node_tech["Tech Stack<br/>[TechStack.tsx]"]
  node_contact["Contact<br/>[Contact.tsx]"]
end

subgraph group_experience["Page Experience"]
  node_loading_ui["Loading Screen<br/>[Loading.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_hover_links["Hover Links<br/>[HoverLinks.tsx]"]
  node_social["Social Links<br/>[SocialIcons.tsx]"]
  node_cursor["Custom Cursor<br/>[Cursor.tsx]"]
  node_split_text["Text Splitting<br/>[splitText.ts]"]
  node_initial_fx["Intro Effects<br/>[initialFX.ts]"]
  node_scroll_motion["Scroll Motion<br/>[GsapScroll.ts]"]
end

subgraph group_character["3D Character"]
  node_scene["Three.js Scene<br/>[Scene.tsx]"]
  node_model_loader["Character Loader<br/>[character.ts]"]
  node_decrypt["Model Decryption<br/>[decrypt.ts]"]
  node_animation["Animation<br/>[animationUtils.ts]"]
  node_bone_data["Bone Data<br/>[boneData.ts]"]
  node_lighting["Lighting<br/>[lighting.ts]"]
  node_mouse["Pointer Input<br/>[mouseUtils.ts]"]
  node_resize["Scene Resize<br/>[resizeUtils.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_entry
node_entry -->|"renders"| node_app_component
node_app_component -->|"wraps"| node_loading_context
node_app_component -->|"renders"| node_main
node_app_component -->|"renders"| node_scene
node_loading_context -->|"shows"| node_loading_ui
node_main -->|"renders"| node_landing
node_main -->|"renders"| node_about
node_main -->|"renders"| node_services
node_main -->|"renders"| node_career
node_main -->|"renders"| node_work
node_main -->|"renders"| node_tech
node_main -->|"renders"| node_contact
node_main -->|"renders"| node_navbar
node_main -->|"renders"| node_social
node_main -->|"renders"| node_cursor
node_main -->|"invokes"| node_split_text
node_navbar -->|"renders"| node_hover_links
node_work -->|"renders"| node_work_image
node_loading_ui -->|"invokes"| node_initial_fx
node_loading_ui -->|"updates"| node_loading_context
node_scene -->|"loads model"| node_model_loader
node_scene -->|"sets lighting"| node_lighting
node_scene -->|"starts animations"| node_animation
node_scene -->|"handles input"| node_mouse
node_scene -->|"handles resize"| node_resize
node_scene -->|"reports progress"| node_loading_ui
node_model_loader -->|"decrypts model"| node_decrypt
node_model_loader -->|"sets timelines"| node_scroll_motion
node_animation -->|"uses bone names"| node_bone_data
node_initial_fx -->|"references"| node_navbar

click node_entry "https://github.com/kathir57/portfolio/blob/main/src/main.tsx"
click node_app_component "https://github.com/kathir57/portfolio/blob/main/src/App.tsx"
click node_main "https://github.com/kathir57/portfolio/blob/main/src/components/MainContainer.tsx"
click node_loading_context "https://github.com/kathir57/portfolio/blob/main/src/context/LoadingProvider.tsx"
click node_loading_ui "https://github.com/kathir57/portfolio/blob/main/src/components/Loading.tsx"
click node_landing "https://github.com/kathir57/portfolio/blob/main/src/components/Landing.tsx"
click node_about "https://github.com/kathir57/portfolio/blob/main/src/components/About.tsx"
click node_services "https://github.com/kathir57/portfolio/blob/main/src/components/WhatIDo.tsx"
click node_career "https://github.com/kathir57/portfolio/blob/main/src/components/Career.tsx"
click node_work "https://github.com/kathir57/portfolio/blob/main/src/components/Work.tsx"
click node_work_image "https://github.com/kathir57/portfolio/blob/main/src/components/WorkImage.tsx"
click node_tech "https://github.com/kathir57/portfolio/blob/main/src/components/TechStack.tsx"
click node_contact "https://github.com/kathir57/portfolio/blob/main/src/components/Contact.tsx"
click node_navbar "https://github.com/kathir57/portfolio/blob/main/src/components/Navbar.tsx"
click node_hover_links "https://github.com/kathir57/portfolio/blob/main/src/components/HoverLinks.tsx"
click node_social "https://github.com/kathir57/portfolio/blob/main/src/components/SocialIcons.tsx"
click node_cursor "https://github.com/kathir57/portfolio/blob/main/src/components/Cursor.tsx"
click node_split_text "https://github.com/kathir57/portfolio/blob/main/src/components/utils/splitText.ts"
click node_initial_fx "https://github.com/kathir57/portfolio/blob/main/src/components/utils/initialFX.ts"
click node_scene "https://github.com/kathir57/portfolio/blob/main/src/components/Character/Scene.tsx"
click node_model_loader "https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/character.ts"
click node_decrypt "https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/decrypt.ts"
click node_animation "https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/animationUtils.ts"
click node_bone_data "https://github.com/kathir57/portfolio/blob/main/src/data/boneData.ts"
click node_lighting "https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/lighting.ts"
click node_mouse "https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/mouseUtils.ts"
click node_resize "https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/resizeUtils.ts"
click node_scroll_motion "https://github.com/kathir57/portfolio/blob/main/src/components/utils/GsapScroll.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_entry,node_app_component,node_main,node_loading_context toneBlue
class node_landing,node_about,node_services,node_career,node_work,node_work_image,node_tech,node_contact toneAmber
class node_loading_ui,node_navbar,node_hover_links,node_social,node_cursor,node_split_text,node_initial_fx,node_scroll_motion toneMint
class node_scene,node_model_loader,node_decrypt,node_animation,node_bone_data,node_lighting,node_mouse,node_resize toneRose
class node_visitor toneIndigo
```

## Components

### Application Shell

- [React Entry](https://github.com/kathir57/portfolio/blob/main/src/main.tsx): `src/main.tsx`
- [App](https://github.com/kathir57/portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [Page Composer](https://github.com/kathir57/portfolio/blob/main/src/components/MainContainer.tsx): `src/components/MainContainer.tsx`
- [Loading State](https://github.com/kathir57/portfolio/blob/main/src/context/LoadingProvider.tsx): `src/context/LoadingProvider.tsx`

### Portfolio Content

- [Landing](https://github.com/kathir57/portfolio/blob/main/src/components/Landing.tsx): `src/components/Landing.tsx`
- [About](https://github.com/kathir57/portfolio/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Services](https://github.com/kathir57/portfolio/blob/main/src/components/WhatIDo.tsx): `src/components/WhatIDo.tsx`
- [Career](https://github.com/kathir57/portfolio/blob/main/src/components/Career.tsx): `src/components/Career.tsx`
- [Work Carousel](https://github.com/kathir57/portfolio/blob/main/src/components/Work.tsx): `src/components/Work.tsx`
- [Project Image](https://github.com/kathir57/portfolio/blob/main/src/components/WorkImage.tsx): `src/components/WorkImage.tsx`
- [Tech Stack](https://github.com/kathir57/portfolio/blob/main/src/components/TechStack.tsx): `src/components/TechStack.tsx`
- [Contact](https://github.com/kathir57/portfolio/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`

### Page Experience

- [Loading Screen](https://github.com/kathir57/portfolio/blob/main/src/components/Loading.tsx): `src/components/Loading.tsx`
- [Navigation](https://github.com/kathir57/portfolio/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Hover Links](https://github.com/kathir57/portfolio/blob/main/src/components/HoverLinks.tsx): `src/components/HoverLinks.tsx`
- [Social Links](https://github.com/kathir57/portfolio/blob/main/src/components/SocialIcons.tsx): `src/components/SocialIcons.tsx`
- [Custom Cursor](https://github.com/kathir57/portfolio/blob/main/src/components/Cursor.tsx): `src/components/Cursor.tsx`
- [Text Splitting](https://github.com/kathir57/portfolio/blob/main/src/components/utils/splitText.ts): `src/components/utils/splitText.ts`
- [Intro Effects](https://github.com/kathir57/portfolio/blob/main/src/components/utils/initialFX.ts): `src/components/utils/initialFX.ts`
- [Scroll Motion](https://github.com/kathir57/portfolio/blob/main/src/components/utils/GsapScroll.ts): `src/components/utils/GsapScroll.ts`

### 3D Character

- [Three.js Scene](https://github.com/kathir57/portfolio/blob/main/src/components/Character/Scene.tsx): `src/components/Character/Scene.tsx`
- [Character Loader](https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/character.ts): `src/components/Character/utils/character.ts`
- [Model Decryption](https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/decrypt.ts): `src/components/Character/utils/decrypt.ts`
- [Animation](https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/animationUtils.ts): `src/components/Character/utils/animationUtils.ts`
- [Bone Data](https://github.com/kathir57/portfolio/blob/main/src/data/boneData.ts): `src/data/boneData.ts`
- [Lighting](https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/lighting.ts): `src/components/Character/utils/lighting.ts`
- [Pointer Input](https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/mouseUtils.ts): `src/components/Character/utils/mouseUtils.ts`
- [Scene Resize](https://github.com/kathir57/portfolio/blob/main/src/components/Character/utils/resizeUtils.ts): `src/components/Character/utils/resizeUtils.ts`

### Other components

- **Visitor**

## Connections

- Visitor → React Entry: opens (evidence: `src/main.tsx`)
- React Entry → App: renders (evidence: `src/main.tsx`)
- App → Loading State: wraps (evidence: `src/App.tsx`)
- App → Page Composer: renders (evidence: `src/App.tsx`)
- App → Three.js Scene: renders (evidence: `src/App.tsx`)
- Loading State → Loading Screen: shows (evidence: `src/context/LoadingProvider.tsx`)
- Page Composer → Landing: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → About: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Services: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Career: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Work Carousel: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Tech Stack: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Contact: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Navigation: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Social Links: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Custom Cursor: renders (evidence: `src/components/MainContainer.tsx`)
- Page Composer → Text Splitting: invokes (evidence: `src/components/MainContainer.tsx`)
- Navigation → Hover Links: renders (evidence: `src/components/Navbar.tsx`)
- Work Carousel → Project Image: renders (evidence: `src/components/Work.tsx`)
- Loading Screen → Intro Effects: invokes (evidence: `src/components/Loading.tsx`)
- Loading Screen → Loading State: updates (evidence: `src/components/Loading.tsx`)
- Three.js Scene → Character Loader: loads model (evidence: `src/components/Character/Scene.tsx`)
- Three.js Scene → Lighting: sets lighting (evidence: `src/components/Character/Scene.tsx`)
- Three.js Scene → Animation: starts animations (evidence: `src/components/Character/Scene.tsx`)
- Three.js Scene → Pointer Input: handles input (evidence: `src/components/Character/Scene.tsx`)
- Three.js Scene → Scene Resize: handles resize (evidence: `src/components/Character/Scene.tsx`)
- Three.js Scene → Loading Screen: reports progress (evidence: `src/components/Character/Scene.tsx`)
- Character Loader → Model Decryption: decrypts model (evidence: `src/components/Character/utils/character.ts`)
- Character Loader → Scroll Motion: sets timelines (evidence: `src/components/Character/utils/character.ts`)
- Animation → Bone Data: uses bone names (evidence: `src/components/Character/utils/animationUtils.ts`)
- Intro Effects → Navigation: references (evidence: `src/components/utils/initialFX.ts`)
