# rohithpranov07/portfolio-cinematic architecture

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

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

## Overview

This is a single-route, cinematic personal portfolio. Visitors scroll through an editorial sequence: an interactive IDE-style introduction, 3D and story chapters, project showcases, a design gallery, contact card, and footer. The root layout supplies page-wide cursor, reveal, and smooth-scroll behavior; the page composes the scenes. The README documents capabilities whose implementation was not sampled, so those are represented at subsystem level; edges are limited to documented or indexed relationships.

Main entry points: [`app/page.tsx`](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/app/page.tsx) (Home composition), [`components/ui/vscode-portfolio.tsx`](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/vscode-portfolio.tsx) (IDE introduction), [`app/layout.tsx`](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/app/layout.tsx) (Root layout), [`components/animations/SmoothScrollProvider.tsx`](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/SmoothScrollProvider.tsx) (Smooth scrolling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Page shell"]
  node_root["Root layout<br/>[layout.tsx]"]
  node_home["Home composition<br/>[page.tsx]"]
end

subgraph group_motion["Motion system"]
  node_smooth["Smooth scrolling"]
  node_lenis["Lenis hook<br/>[useLenis.ts]"]
  node_cursor["Mouse follower<br/>[MouseFollower.tsx]"]
  node_pagefx["Page reveal<br/>[PageTransition.tsx]"]
  node_gsap["GSAP utilities<br/>[gsap.ts]"]
end

subgraph group_scenes["Portfolio scenes"]
  node_intro["IDE introduction"]
  node_ideframe["Frame transition"]
  node_filetree["File tree<br/>[file-tree.tsx]"]
  node_spotlight["Spotlight search"]
  node_menubar["Menu bar"]
  node_spline["Spline scene"]
  node_story["About chapter"]
  node_transitions["Chapter transitions"]
end

subgraph group_showcase["Project showcase"]
  node_parallax["Project parallax<br/>[hero-parallax.tsx]"]
  node_morph["Project morph"]
  node_tilted["Tilted grid"]
  node_carousel["Design carousel<br/>[card-carousel.tsx]"]
  node_rays["Light rays<br/>[LightRays.tsx]"]
  node_zoom["Zoom parallax<br/>[zoom-parallax.tsx]"]
  node_contact["Contact card<br/>[ProfileCard.tsx]"]
  node_footer["Footer composition<br/>[footer-demo.tsx]"]
  node_footerui["Footer component"]
  node_projectmodal["Project details<br/>[project-modal.tsx]"]
  node_scrollstack["Stacked cards<br/>[scroll-stack.tsx]"]
  node_carouseldata["Carousel scene"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_root -->|"renders"| node_home
node_root -->|"provides"| node_smooth
node_root -->|"renders"| node_cursor
node_root -->|"renders"| node_pagefx
node_smooth -->|"uses"| node_lenis
node_lenis -->|"updates ticker"| node_gsap
node_home -->|"renders"| node_intro
node_home -->|"wraps"| node_ideframe
node_ideframe -->|"renders within"| node_intro
node_intro -->|"renders"| node_filetree
node_intro -->|"renders"| node_spotlight
node_intro -->|"renders"| node_menubar
node_intro -->|"renders"| node_projectmodal
node_home -->|"renders"| node_spline
node_home -->|"renders"| node_story
node_home -->|"renders"| node_transitions
node_transitions -->|"uses"| node_gsap
node_home -->|"renders"| node_parallax
node_home -->|"renders"| node_morph
node_home -->|"renders"| node_tilted
node_home -->|"renders"| node_carouseldata
node_carouseldata -->|"renders"| node_carousel
node_home -->|"renders"| node_rays
node_home -->|"renders"| node_zoom
node_home -->|"renders"| node_contact
node_home -->|"renders"| node_footer
node_footer -->|"renders"| node_footerui
node_intro -->|"uses"| node_scrollstack

click node_root "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/app/layout.tsx"
click node_home "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/app/page.tsx"
click node_smooth "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/SmoothScrollProvider.tsx"
click node_lenis "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/hooks/useLenis.ts"
click node_cursor "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/MouseFollower.tsx"
click node_pagefx "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/PageTransition.tsx"
click node_gsap "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/lib/gsap.ts"
click node_intro "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/vscode-portfolio.tsx"
click node_ideframe "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/FrameToFullscreen.tsx"
click node_filetree "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/file-tree.tsx"
click node_spotlight "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/apple-spotlight.tsx"
click node_menubar "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/mac-os-menu-bar.tsx"
click node_spline "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/spline-scene-basic.tsx"
click node_story "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/story-scroll-demo.tsx"
click node_transitions "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/ScrollWarpPortal.tsx"
click node_parallax "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/hero-parallax.tsx"
click node_morph "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/scroll-morph-hero.tsx"
click node_tilted "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/scroll-tilted-grid.tsx"
click node_carousel "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/card-carousel.tsx"
click node_rays "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/LightRays.tsx"
click node_zoom "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/zoom-parallax.tsx"
click node_contact "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/ProfileCard.tsx"
click node_footer "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/footer-demo.tsx"
click node_footerui "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/modem-animated-footer.tsx"
click node_projectmodal "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/project-modal.tsx"
click node_scrollstack "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/scroll-stack.tsx"
click node_carouseldata "https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/card-carousel-demo.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_root,node_home toneBlue
class node_smooth,node_lenis,node_cursor,node_pagefx,node_gsap toneAmber
class node_intro,node_ideframe,node_filetree,node_spotlight,node_menubar,node_spline,node_story,node_transitions toneMint
class node_parallax,node_morph,node_tilted,node_carousel,node_rays,node_zoom,node_contact,node_footer,node_footerui,node_projectmodal,node_scrollstack,node_carouseldata toneRose
class node_visitor toneIndigo
```

## Components

### Page shell

- [Root layout](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/app/layout.tsx): `app/layout.tsx`
- [Home composition](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/app/page.tsx): `app/page.tsx`

### Motion system

- [Smooth scrolling](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/SmoothScrollProvider.tsx): `components/animations/SmoothScrollProvider.tsx`
- [Lenis hook](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/hooks/useLenis.ts): `hooks/useLenis.ts`
- [Mouse follower](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/MouseFollower.tsx): `components/animations/MouseFollower.tsx`
- [Page reveal](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/PageTransition.tsx): `components/animations/PageTransition.tsx`
- [GSAP utilities](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/lib/gsap.ts): `lib/gsap.ts`

### Portfolio scenes

- [IDE introduction](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/vscode-portfolio.tsx): `components/ui/vscode-portfolio.tsx`
- [Frame transition](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/FrameToFullscreen.tsx): `components/animations/FrameToFullscreen.tsx`
- [File tree](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/file-tree.tsx): `components/ui/file-tree.tsx`
- [Spotlight search](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/apple-spotlight.tsx): `components/ui/apple-spotlight.tsx`
- [Menu bar](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/mac-os-menu-bar.tsx): `components/ui/mac-os-menu-bar.tsx`
- [Spline scene](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/spline-scene-basic.tsx): `components/ui/spline-scene-basic.tsx`
- [About chapter](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/story-scroll-demo.tsx): `components/ui/story-scroll-demo.tsx`
- [Chapter transitions](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/animations/ScrollWarpPortal.tsx): `components/animations/ScrollWarpPortal.tsx`

### Project showcase

- [Project parallax](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/hero-parallax.tsx): `components/ui/hero-parallax.tsx`
- [Project morph](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/scroll-morph-hero.tsx): `components/ui/scroll-morph-hero.tsx`
- [Tilted grid](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/scroll-tilted-grid.tsx): `components/ui/scroll-tilted-grid.tsx`
- [Design carousel](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/card-carousel.tsx): `components/ui/card-carousel.tsx`
- [Light rays](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/LightRays.tsx): `components/ui/LightRays.tsx`
- [Zoom parallax](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/zoom-parallax.tsx): `components/ui/zoom-parallax.tsx`
- [Contact card](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/ProfileCard.tsx): `components/ui/ProfileCard.tsx`
- [Footer composition](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/footer-demo.tsx): `components/ui/footer-demo.tsx`
- [Footer component](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/modem-animated-footer.tsx): `components/ui/modem-animated-footer.tsx`
- [Project details](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/project-modal.tsx): `components/ui/project-modal.tsx`
- [Stacked cards](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/scroll-stack.tsx): `components/ui/scroll-stack.tsx`
- [Carousel scene](https://github.com/rohithpranov07/portfolio-cinematic/blob/main/components/ui/card-carousel-demo.tsx): `components/ui/card-carousel-demo.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → Home composition: opens
- Root layout → Home composition: renders (evidence: `app/layout.tsx`)
- Root layout → Smooth scrolling: provides (evidence: `app/layout.tsx`)
- Root layout → Mouse follower: renders (evidence: `app/layout.tsx`)
- Root layout → Page reveal: renders (evidence: `app/layout.tsx`)
- Smooth scrolling → Lenis hook: uses (evidence: `hooks/useLenis.ts`)
- Lenis hook → GSAP utilities: updates ticker (evidence: `hooks/useLenis.ts`)
- Home composition → IDE introduction: renders (evidence: `app/page.tsx`)
- Home composition → Frame transition: wraps (evidence: `app/page.tsx`)
- Frame transition → IDE introduction: renders within
- IDE introduction → File tree: renders (evidence: `components/ui/vscode-portfolio.tsx`)
- IDE introduction → Spotlight search: renders (evidence: `components/ui/vscode-portfolio.tsx`)
- IDE introduction → Menu bar: renders (evidence: `components/ui/vscode-portfolio.tsx`)
- IDE introduction → Project details: renders (evidence: `components/ui/vscode-portfolio.tsx`)
- Home composition → Spline scene: renders (evidence: `app/page.tsx`)
- Home composition → About chapter: renders (evidence: `app/page.tsx`)
- Home composition → Chapter transitions: renders (evidence: `app/page.tsx`)
- Chapter transitions → GSAP utilities: uses (evidence: `components/animations/ScrollWarpPortal.tsx`)
- Home composition → Project parallax: renders (evidence: `app/page.tsx`)
- Home composition → Project morph: renders (evidence: `app/page.tsx`)
- Home composition → Tilted grid: renders (evidence: `app/page.tsx`)
- Home composition → Carousel scene: renders (evidence: `app/page.tsx`)
- Carousel scene → Design carousel: renders (evidence: `components/ui/card-carousel-demo.tsx`)
- Home composition → Light rays: renders (evidence: `app/page.tsx`)
- Home composition → Zoom parallax: renders (evidence: `app/page.tsx`)
- Home composition → Contact card: renders (evidence: `app/page.tsx`)
- Home composition → Footer composition: renders (evidence: `app/page.tsx`)
- Footer composition → Footer component: renders (evidence: `components/ui/footer-demo.tsx`)
- IDE introduction → Stacked cards: uses (evidence: `components/ui/vscode-portfolio.tsx`)
