# ketankapale/portfolio architecture

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

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

## Overview

1. This repository is a Vite-powered React single-page experience, not a traditional multi-page app. The architecture is centered around a single app shell in `src/main.jsx` and `src/App.jsx`, with most of the visual logic split into composable scene and UI components.

2. The top-level runtime boundary is:
   - `src/main.jsx` bootstraps React into `index.html`
   - `src/App.jsx` acts as the composition root
   - global styling is split between `src/index.css` and `src/App.css`
   This makes the app a client-rendered frontend with Vite handling dev server, bundling, and static asset serving.

3. The component structure suggests a highly visual portfolio/landing page. `src/components/Ketan.jsx` is likely the primary identity/hero element, while `Skillset.jsx`, `Upgrade.jsx`, and `Upgrades.jsx` indicate content sections or interactive presentation of capabilities and achievements.

4. The repository also has a strong “scene” subsystem. Components such as `Scenery.jsx`, `Trees.jsx`, `Bird.jsx`, `Butterfly.jsx`, and `Coffee.jsx` imply decorative or animated elements layered into the page. These are likely responsible for the environment and motion that make the experience feel more like an interactive diorama than a standard website.

5. `LoadingScreen.jsx` and `ErrorBoundary.jsx` define the app’s resilience boundaries. The loading screen suggests that some assets or scene elements are expensive to initialize, while the error boundary isolates failures in the visual/3D portion so the whole app does not crash if a model or animation fails.

6. Static media is a major part of the architecture. The `public/walking/Strut Walking.gltf` and `public/walking/buffer.bin` files indicate a glTF model with external binary data, likely loaded at runtime as part of the scene. The `public/cv/KetanKapaleUpdated.pdf` file is a downloadable resume asset, separate from the React bundle and served directly as static content.

7. The public directory also contains `manifest.webmanifest`, `robots.txt`, and `sitemap.xml`, which means the site is treated as a deployable public-facing portfolio with PWA/SEO considerations. These files are part of the deployment boundary rather than application logic.

8. `index.html` is the Vite HTML entry point, and `vite.config.js` defines build-time behavior and dev tooling. The project includes `eslint.config.js`, showing code quality is enforced at the source level. `package.json` and `package-lock.json` define the app’s JavaScript dependency graph and deterministic installs.

9. `netlify.toml` indicates the deployment target is Netlify. That matters architecturally because the app is built as a static frontend and hosted on a CDN-backed platform, with routing/redirect behavior likely controlled through Netlify config rather than a custom server.

10. The data flow is mostly one-way and client-side: React mounts the app, `App` assembles the scene and content components, the components render layered visuals and portfolio content, and external assets are fetched from `public/` at runtime. There is no evidence of a backend API, database, or server-side business logic in this repository.

11. In diagram terms, the key boundaries are:
   - build/runtime: Vite + React
   - composition: `App.jsx`
   - presentation/animation: the scene and character components
   - static asset delivery: `public/`
   - resilience: loading and error handling
   - deployment: Netlify/CDN hosting

12. Overall, this is best modeled as a static, client-rendered portfolio site with rich visual composition, runtime-loaded media assets, and deployment-oriented public files for SEO, PWA metadata, and downloadable documents.

Main entry points: [`src/App.jsx`](https://github.com/ketankapale/portfolio/blob/main/src/App.jsx) (App.jsx), [`src/components/Scenery.jsx`](https://github.com/ketankapale/portfolio/blob/main/src/components/Scenery.jsx) (Scenery), [`index.html`](https://github.com/ketankapale/portfolio/blob/main/index.html) (index.html), [`src/main.jsx`](https://github.com/ketankapale/portfolio/blob/main/src/main.jsx) (main.jsx)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime & build"]
  node_index_html["index.html<br/>html entry<br/>[index.html]"]
  node_main_jsx["main.jsx<br/>bootstrap<br/>[main.jsx]"]
  node_vite_config["vite.config.js<br/>build config<br/>[vite.config.js]"]
end

subgraph group_shell["Shell & styling"]
  node_app_jsx["App.jsx<br/>app shell<br/>[App.jsx]"]
  node_app_css["App.css<br/>app styles<br/>[App.css]"]
  node_index_css["index.css<br/>global styles<br/>[index.css]"]
end

subgraph group_content["Content sections"]
  node_ketan["Ketan<br/>hero identity<br/>[Ketan.jsx]"]
  node_skillset["Skillset<br/>skills section<br/>[Skillset.jsx]"]
  node_upgrade["Upgrade<br/>achievement card<br/>[Upgrade.jsx]"]
  node_upgrades["Upgrades<br/>achievement list<br/>[Upgrades.jsx]"]
end

subgraph group_scene["Scene system"]
  node_scenery["Scenery<br/>scene compositor<br/>[Scenery.jsx]"]
  node_trees["Trees<br/>environment layer<br/>[Trees.jsx]"]
  node_bird["Bird<br/>animated actor<br/>[Bird.jsx]"]
  node_butterfly["Butterfly<br/>animated actor<br/>[Butterfly.jsx]"]
  node_coffee["Coffee<br/>scene prop<br/>[Coffee.jsx]"]
end

subgraph group_resilience["Resilience"]
  node_loading["LoadingScreen<br/>loading state<br/>[LoadingScreen.jsx]"]
  node_error_boundary["ErrorBoundary<br/>error guard<br/>[ErrorBoundary.jsx]"]
end

subgraph group_assets["Static assets & deploy"]
  node_walking_model["Walking Model<br/>runtime asset<br/>[Strut Walking.gltf]"]
  node_resume_pdf["Resume PDF<br/>download asset"]
  node_pwa_meta["PWA Meta<br/>public metadata"]
  node_netlify_toml["netlify.toml<br/>deploy config<br/>[netlify.toml]"]
end

node_index_html -->|"loads"| node_main_jsx
node_main_jsx -->|"renders"| node_app_jsx
node_app_jsx -->|"shows"| node_loading
node_app_jsx -->|"wraps"| node_error_boundary
node_app_jsx -->|"composes"| node_ketan
node_app_jsx -->|"composes"| node_skillset
node_app_jsx -->|"composes"| node_upgrades
node_upgrades -->|"contains"| node_upgrade
node_app_jsx -->|"composes"| node_scenery
node_scenery -->|"layers"| node_trees
node_scenery -->|"layers"| node_bird
node_scenery -->|"layers"| node_butterfly
node_scenery -->|"layers"| node_coffee
node_app_jsx -->|"styles"| node_app_css
node_app_jsx -->|"styles"| node_index_css
node_scenery -->|"loads"| node_walking_model
node_app_jsx -->|"links"| node_resume_pdf
node_app_jsx -->|"publishes"| node_pwa_meta
node_vite_config -->|"serves"| node_index_html
node_netlify_toml -->|"hosts"| node_index_html

click node_index_html "https://github.com/ketankapale/portfolio/blob/main/index.html"
click node_main_jsx "https://github.com/ketankapale/portfolio/blob/main/src/main.jsx"
click node_vite_config "https://github.com/ketankapale/portfolio/blob/main/vite.config.js"
click node_app_jsx "https://github.com/ketankapale/portfolio/blob/main/src/App.jsx"
click node_app_css "https://github.com/ketankapale/portfolio/blob/main/src/App.css"
click node_index_css "https://github.com/ketankapale/portfolio/blob/main/src/index.css"
click node_loading "https://github.com/ketankapale/portfolio/blob/main/src/components/LoadingScreen.jsx"
click node_error_boundary "https://github.com/ketankapale/portfolio/blob/main/src/components/ErrorBoundary.jsx"
click node_ketan "https://github.com/ketankapale/portfolio/blob/main/src/components/Ketan.jsx"
click node_skillset "https://github.com/ketankapale/portfolio/blob/main/src/components/Skillset.jsx"
click node_upgrade "https://github.com/ketankapale/portfolio/blob/main/src/components/Upgrade.jsx"
click node_upgrades "https://github.com/ketankapale/portfolio/blob/main/src/components/Upgrades.jsx"
click node_scenery "https://github.com/ketankapale/portfolio/blob/main/src/components/Scenery.jsx"
click node_trees "https://github.com/ketankapale/portfolio/blob/main/src/components/Trees.jsx"
click node_bird "https://github.com/ketankapale/portfolio/blob/main/src/components/Bird.jsx"
click node_butterfly "https://github.com/ketankapale/portfolio/blob/main/src/components/Butterfly.jsx"
click node_coffee "https://github.com/ketankapale/portfolio/blob/main/src/components/Coffee.jsx"
click node_walking_model "https://github.com/ketankapale/portfolio/blob/main/public/walking/Strut Walking.gltf"
click node_resume_pdf "https://github.com/ketankapale/portfolio/blob/main/public/cv/KetanKapaleUpdated.pdf"
click node_pwa_meta "https://github.com/ketankapale/portfolio/blob/main/public/manifest.webmanifest"
click node_netlify_toml "https://github.com/ketankapale/portfolio/blob/main/netlify.toml"

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_index_html,node_main_jsx,node_vite_config toneBlue
class node_app_jsx,node_app_css,node_index_css toneAmber
class node_ketan,node_skillset,node_upgrade,node_upgrades toneMint
class node_scenery,node_trees,node_bird,node_butterfly,node_coffee toneRose
class node_loading,node_error_boundary toneIndigo
class node_walking_model,node_resume_pdf,node_pwa_meta,node_netlify_toml toneTeal
```

## Components

### Runtime & build

Vite entrypoint and client-side bootstrap boundary.

- [index.html](https://github.com/ketankapale/portfolio/blob/main/index.html): html entry · Vite HTML entrypoint that mounts the React bundle. · `index.html`
- [main.jsx](https://github.com/ketankapale/portfolio/blob/main/src/main.jsx): bootstrap · Client bootstrap that renders React into the page. · `src/main.jsx`
- [vite.config.js](https://github.com/ketankapale/portfolio/blob/main/vite.config.js): build config · Build and dev-server configuration for the Vite app. · `vite.config.js`

### Shell & styling

Application composition root and global styles.

- [App.jsx](https://github.com/ketankapale/portfolio/blob/main/src/App.jsx): app shell · Composition root that assembles the page experience. · `src/App.jsx`
- [App.css](https://github.com/ketankapale/portfolio/blob/main/src/App.css): app styles · Component-scoped styling for the main shell. · `src/App.css`
- [index.css](https://github.com/ketankapale/portfolio/blob/main/src/index.css): global styles · Global baseline styles for the client-rendered app. · `src/index.css`

### Content sections

Portfolio identity and capability sections.

- [Ketan](https://github.com/ketankapale/portfolio/blob/main/src/components/Ketan.jsx): hero identity · Primary personal/hero presentation for the portfolio. · `src/components/Ketan.jsx`
- [Skillset](https://github.com/ketankapale/portfolio/blob/main/src/components/Skillset.jsx): skills section · Capability and technology presentation section. · `src/components/Skillset.jsx`
- [Upgrade](https://github.com/ketankapale/portfolio/blob/main/src/components/Upgrade.jsx): achievement card · Content block for an individual upgrade or milestone. · `src/components/Upgrade.jsx`
- [Upgrades](https://github.com/ketankapale/portfolio/blob/main/src/components/Upgrades.jsx): achievement list · Collection view for progress, highlights, or updates. · `src/components/Upgrades.jsx`

### Scene system

Decorative and animated environment elements.

- [Scenery](https://github.com/ketankapale/portfolio/blob/main/src/components/Scenery.jsx): scene compositor · Coordinates the layered decorative environment. · `src/components/Scenery.jsx`
- [Trees](https://github.com/ketankapale/portfolio/blob/main/src/components/Trees.jsx): environment layer · Background terrain and natural scene elements. · `src/components/Trees.jsx`
- [Bird](https://github.com/ketankapale/portfolio/blob/main/src/components/Bird.jsx): animated actor · Moving scene element that adds life and motion. · `src/components/Bird.jsx`
- [Butterfly](https://github.com/ketankapale/portfolio/blob/main/src/components/Butterfly.jsx): animated actor · Small decorative motion element in the scene. · `src/components/Butterfly.jsx`
- [Coffee](https://github.com/ketankapale/portfolio/blob/main/src/components/Coffee.jsx): scene prop · Ambient prop used to reinforce the portfolio mood. · `src/components/Coffee.jsx`

### Resilience

Loading and failure boundaries for expensive visual assets.

- [LoadingScreen](https://github.com/ketankapale/portfolio/blob/main/src/components/LoadingScreen.jsx): loading state · Fallback UI while heavy visuals or assets initialize. · `src/components/LoadingScreen.jsx`
- [ErrorBoundary](https://github.com/ketankapale/portfolio/blob/main/src/components/ErrorBoundary.jsx): error guard · Isolates failures in the visual experience. · `src/components/ErrorBoundary.jsx`

### Static assets & deploy

Public runtime assets and deployment-oriented files.

- [Walking Model](https://github.com/ketankapale/portfolio/blob/HEAD/public/walking/Strut%20Walking.gltf): runtime asset · glTF model loaded at runtime; uses an external binary buffer. · `public/walking/Strut Walking.gltf`
- [Resume PDF](https://github.com/ketankapale/portfolio/blob/main/public/cv/KetanKapaleUpdated.pdf): download asset · Public CV document served directly from the site. · `public/cv/KetanKapaleUpdated.pdf`
- [PWA Meta](https://github.com/ketankapale/portfolio/blob/main/public/manifest.webmanifest): public metadata · Manifest and crawl metadata for deployment and discovery. · `public/manifest.webmanifest`
- [netlify.toml](https://github.com/ketankapale/portfolio/blob/main/netlify.toml): deploy config · Netlify deployment and routing configuration. · `netlify.toml`

## Connections

- index.html → main.jsx: loads · HTML entry loads the React bootstrap.
- main.jsx → App.jsx: renders · Bootstrap mounts the app shell into the DOM.
- App.jsx → LoadingScreen: shows · App coordinates the loading state for heavy initialization.
- App.jsx → ErrorBoundary: wraps · App is protected by a visual error boundary.
- App.jsx → Ketan: composes · Shell assembles the hero identity section.
- App.jsx → Skillset: composes · Shell assembles the skills content section.
- App.jsx → Upgrades: composes · Shell assembles the upgrades/achievements section.
- Upgrades → Upgrade: contains · The upgrades collection renders individual cards.
- App.jsx → Scenery: composes · Shell includes the decorative scene layer.
- Scenery → Trees: layers · Scene compositor includes background environment.
- Scenery → Bird: layers · Scene compositor includes animated bird motion.
- Scenery → Butterfly: layers · Scene compositor includes animated butterfly motion.
- Scenery → Coffee: layers · Scene compositor includes ambient prop styling.
- App.jsx → App.css: styles · Main shell pulls in component-scoped styles.
- App.jsx → index.css: styles · Main shell depends on global baseline styles.
- Scenery → Walking Model: loads · Scene runtime fetches the glTF asset during render.
- App.jsx → Resume PDF: links · Portfolio content exposes the downloadable resume.
- App.jsx → PWA Meta: publishes · Deployment uses public metadata and crawl files.
- vite.config.js → index.html: serves · Vite config governs how the entry page is built and served.
- netlify.toml → index.html: hosts · Netlify hosts the built static frontend.
