# imrude16/3d-portfolio-using-react architecture

> Architecture diagram of the GitHub repository imrude16/3d-portfolio-using-react, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/imrude16/3d-portfolio-using-react
- Repository: https://github.com/imrude16/3d-portfolio-using-react

## Overview

##### Project type and purpose
- This is a single-page, client-only front-end application—a 3D portfolio/site—built with React and Vite.
- It renders 3D models (GLB files) via a React–Three.js integration (likely react-three-fiber), and serves static assets (images, videos, textures) from a public folder.

##### File structure
- Top-level files:
– package.json, package-lock.json → npm dependencies and scripts
– vite.config.js → build/dev server configuration
– index.html → HTML entry point
– .env, .gitignore, eslint.config.js → environment, lint rules
- public/ → static assets (images/, models/, etc.) served as-is
- src/ → React source:
– main.jsx → mounts App
– App.jsx & FeatureCards.jsx → high-level composition
– components/ → reusable UI (buttons, nav, hero models, 3D model wrappers)
– sections/ → page sections (Hero, Experience, Contact, TechStack, Footer)
– constants/ → shared data (e.g., card content)
– index.css → global styles

##### README for additional insights
- Confirms a minimal React+Vite template, HMR via @vitejs/plugin-react or plugin-react-swc
- Suggests ESLint and (optionally) TypeScript for production builds

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Development Environment
    subgraph "Development Environment"
        direction TB
        DevWorkstation["Developer Workstation (IDE)"]:::dev
        GitHub["Version Control (GitHub)"]:::dev
        subgraph "Source Code"
            direction TB
            PKGJson["package.json"]:::dev
            PKGLock["package-lock.json"]:::dev
            EnvFile[".env"]:::dev
            ESLintCfg["eslint.config.js"]:::dev
            ViteCfg["vite.config.js"]:::dev
            HTML["index.html"]:::dev
            subgraph "src"
                direction TB
                MainJSX["src/main.jsx"]:::dev
                AppJSX["src/App.jsx"]:::dev
                Styles["src/index.css"]:::dev
                FeatureCards["src/FeatureCards.jsx"]:::dev
                Constants["src/constants/index.js"]:::dev
                subgraph "components"
                    direction TB
                    Button["Button.jsx"]:::dev
                    NavBar["NavBar.jsx"]:::dev
                    GlowCard["GlowCard.jsx"]:::dev
                    AnimatedCounter["AnimatedCounter.jsx"]:::dev
                    TitleHeader["TitleHeader.jsx"]:::dev
                    subgraph "heromodels"
                        direction TB
                        HeroExp["HeroExperience.jsx"]:::dev
                        HeroLight["HeroLights.jsx"]:::dev
                        Particles["Particles.jsx"]:::dev
                        Room["Room.jsx"]:::dev
                    end
                    subgraph "models"
                        direction TB
                        ComputerOpt["Computer-optimized.jsx"]:::dev
                        subgraph "models/contact"
                            ContactExp["ContactExperience.jsx"]:::dev
                        end
                        subgraph "models/techlogos"
                            TechIcon["TechIcon.jsx"]:::dev
                        end
                    end
                end
                subgraph "sections"
                    direction TB
                    HeroSec["Hero.jsx"]:::dev
                    ExpSec["ExperienceSection.jsx"]:::dev
                    ContactSec["Contact.jsx"]:::dev
                    TechSec["TechStack.jsx"]:::dev
                    FooterSec["Footer.jsx"]:::dev
                    LogoSec["LogoSection.jsx"]:::dev
                    ShowcaseSec["ShowcaseSection.jsx"]:::dev
                    Testimonials["Testimonials.jsx"]:::dev
                end
            end
        end
    end

    DevWorkstation -->|"git push"| GitHub

    %% Build & CI/CD
    subgraph "Build & CI/CD Pipeline"
        direction TB
        CI["CI/CD (GitHub Actions)"]:::build
        ViteDev["Vite Dev Server (HMR)"]:::build
        Bundler["Vite/Rollup Bundler"]:::build
    end

    GitHub -->|"trigger build"| CI
    CI -->|"run dev server"| ViteDev
    CI -->|"bundle code"| Bundler

    %% Hosting & CDN
    subgraph "Hosting & CDN"
        direction TB
        StaticHost["Static File Host / CDN"]:::host
        AssetStorage["Static Assets (public/)"]:::asset
    end

    Bundler -->|"deploy static files"| StaticHost
    StaticHost --> AssetStorage

    %% Browser Runtime
    subgraph "Browser Runtime"
        direction TB
        Browser["Web Browser"]:::runtime
        ReactApp["React App (bundle.js)"]:::runtime
        R3F["react-three-fiber"]:::runtime
        ThreeJS["Three.js Engine"]:::runtime
        Assets["GLB & Images"]:::asset
    end

    StaticHost -->|"GET /index.html, bundle.js"| Browser
    Browser -->|"load bundle"| ReactApp
    ReactApp -->|"render components"| R3F
    R3F -->|"calls Three.js"| ThreeJS
    ReactApp -->|"fetch assets"| Assets
    ThreeJS -->|"load models/textures"| Assets

    %% Click Events
    click PKGJson "https://github.com/imrude16/3d-portfolio-using-react/blob/main/package.json"
    click PKGLock "https://github.com/imrude16/3d-portfolio-using-react/blob/main/package-lock.json"
    click EnvFile "https://github.com/imrude16/3d-portfolio-using-react/blob/main/.env"
    click ESLintCfg "https://github.com/imrude16/3d-portfolio-using-react/blob/main/eslint.config.js"
    click ViteCfg "https://github.com/imrude16/3d-portfolio-using-react/blob/main/vite.config.js"
    click HTML "https://github.com/imrude16/3d-portfolio-using-react/blob/main/index.html"
    click MainJSX "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/main.jsx"
    click AppJSX "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/App.jsx"
    click Styles "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/index.css"
    click FeatureCards "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/FeatureCards.jsx"
    click Constants "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/constants/index.js"
    click Button "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/Button.jsx"
    click NavBar "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/NavBar.jsx"
    click GlowCard "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/GlowCard.jsx"
    click AnimatedCounter "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/AnimatedCounter.jsx"
    click TitleHeader "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/TitleHeader.jsx"
    click HeroExp "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/heromodels/HeroExperience.jsx"
    click HeroLight "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/heromodels/HeroLights.jsx"
    click Particles "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/heromodels/Particles.jsx"
    click Room "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/heromodels/Room.jsx"
    click ComputerOpt "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/models/Computer-optimized.jsx"
    click ContactExp "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/models/contact/ContactExperience.jsx"
    click TechIcon "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/components/models/techlogos/TechIcon.jsx"
    click HeroSec "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/Hero.jsx"
    click ExpSec "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/ExperienceSection.jsx"
    click ContactSec "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/Contact.jsx"
    click TechSec "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/TechStack.jsx"
    click FooterSec "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/Footer.jsx"
    click LogoSec "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/LogoSection.jsx"
    click ShowcaseSec "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/ShowcaseSection.jsx"
    click Testimonials "https://github.com/imrude16/3d-portfolio-using-react/blob/main/src/sections/Testimonials.jsx"

    %% Styles
    classDef dev fill:#D0E8FF,stroke:#0275d8,color:#000
    classDef build fill:#FFE6C7,stroke:#f0ad4e,color:#000
    classDef host fill:#DFF0D8,stroke:#5cb85c,color:#000
    classDef runtime fill:#F2DEDE,stroke:#d9534f,color:#000
    classDef asset fill:#FCF8E3,stroke:#f7e1a1,color:#000
```
