# 0alduin0/portfolio-with-nodejs-react architecture

> Architecture diagram of the GitHub repository 0alduin0/portfolio-with-nodejs-react, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/0alduin0/portfolio-with-nodejs-react
- Repository: https://github.com/0alduin0/portfolio-with-nodejs-react

## Overview

##### Project Type and Purpose
- This is a single‐page, frontend‐only React application (bootstrapped with Create React App) that serves as a personal portfolio/CV site.
- Key purpose: display sections like Hero, About, Skills, Projects, Contact, and incorporate Lottie animations via static JSON assets.

##### File‐Structure Analysis
- **Top‐Level Files**
- package.json / package-lock.json: dependency declarations and scripts (start, build, test, eject)
- .env.example: environment variable template
- tailwind.config.js: Tailwind CSS configuration
- **public/**
- index.html: SPA host page, references bundle.js, manifest.json, robots.txt, CV PDF
- manifest.json: PWA metadata
- static PDFs, favicon, robots.txt
- **src/**
- index.js → bootstraps React into the DOM root in index.html
- App.js → top‐level component that orchestrates child components
- components/ → UI components: Navbar, Hero, About, Projects, Skills, Contact, Footer, WelcomeScreen, Particles (with accompanying CSS)
- assets/ → static JSON animations, images
- index.css → global styles, Tailwind imports

##### README Insights
- No backend or external services—pure static frontend.
- Build & deployment flow is standard CRA: Webpack + Babel to bundle into /build.

##### Main Components
a. **Developer Workstation**
- Node.js & npm CLI
- CRA toolchain: Webpack, Babel, ESLint
- Tailwind (via PostCSS)
b. **Build Process**
- npm scripts: “start” → webpack‐dev‐server; “build” → production bundling → /build folder
c. **Static Hosting / CDN**
- Serves index.html, JS/CSS bundles, assets (animations, images, PDFs)
d. **Browser (Client)**
- Fetches index.html → downloads JS bundle → renders React App → requests assets on‐demand
e. **React Application**
- App.js (root)
- UI Components (Navbar, Hero, etc.)
- Asset loader for Lottie JSON animations
- CSS (Tailwind & component styles)

##### Relationships & Data Flow
- Developer invokes `npm run build` → Webpack compiles src/ → bundle.js + assets → deployed to hosting
- Browser HTTP GET → index.html → loads bundle.js → React hydrates DOM → on‐scroll or route change, components fetch animations/images from /assets
- No dynamic API calls—entirely static.

##### Architectural Patterns & Principles
- **Component‐based UI** (React)
- **Single‐Page Application** (client‐side routing if used)
- **Static asset serving** (animations, images, PDF)
- **Utility‐First CSS** (Tailwind)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Workstation
    subgraph "Developer Workstation"
        pkgJson["package.json"] 
        pkgLock["package-lock.json"]
        tailwindConfig["tailwind.config.js"]
        envExample[".env.example"]
    end

    %% Build Process
    subgraph "Build Process: CRA/Webpack/Babel/Tailwind"
        npmScripts["npm scripts\n(start, build)"]
        srcIndex["src/index.js"]
        srcIndexCss["src/index.css"]
    end

    %% Static Hosting / CDN
    subgraph "Static Hosting/CDN"
        indexHtml["public/index.html"]
        manifest["public/manifest.json"]
        robots["public/robots.txt"]
        cvPdf["public/Enes_Yürekli_CV.pdf"]
    end

    %% Client Browser
    browser["Browser (Client)"]:::client

    %% React SPA
    subgraph "React SPA Container"
        App["src/App.js"]
        subgraph "UI Components"
            nav["Navbar"]
            hero["Hero"]
            about["About"]
            skills["Skills"]
            projects["Projects"]
            contact["Contact"]
            welcome["WelcomeScreen"]
            footer["Footer"]
        end
        subgraph "Animations & Asset Loader"
            ParticlesJs["Particles.js"]
            ParticlesCss["Particles.css"]
            anim1["animation.json"]
            anim2["animation2.json"]
            anim3["animation3.json"]
            anim4["animation4.json"]
            anim5["animation5.json"]
        end
        subgraph "Images"
            images["images"]
        end
    end

    %% Connections
    pkgJson & pkgLock & tailwindConfig & envExample -->|configures| npmScripts
    npmScripts -->|builds src/| indexHtml
    indexHtml -->|serves| browser
    browser -->|loads bundle| App
    App -->|renders| nav
    App -->|renders| hero
    App -->|renders| about
    App -->|renders| skills
    App -->|renders| projects
    App -->|renders| contact
    App -->|renders| welcome
    App -->|renders| footer
    App -->|uses| ParticlesJs
    App -->|uses| ParticlesCss
    App -->|loads| anim1
    App -->|loads| anim2
    App -->|loads| anim3
    App -->|loads| anim4
    App -->|loads| anim5
    App -->|loads| images

    %% Click Events
    click pkgJson "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/package.json"
    click pkgLock "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/package-lock.json"
    click tailwindConfig "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/tailwind.config.js"
    click envExample "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/.env.example"
    click npmScripts "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/package.json"
    click srcIndex "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/index.js"
    click srcIndexCss "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/index.css"
    click indexHtml "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/public/index.html"
    click manifest "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/public/manifest.json"
    click robots "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/public/robots.txt"
    click cvPdf "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/public/Enes_Yürekli_CV.pdf"
    click App "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/App.js"
    click srcIndex "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/index.js"
    click nav "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Navbar.js"
    click hero "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Hero.js"
    click about "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/About.js"
    click skills "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Skills.js"
    click projects "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Projects.js"
    click contact "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Contact.js"
    click welcome "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/WelcomeScreen.js"
    click footer "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Footer.js"
    click ParticlesJs "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Particles.js"
    click ParticlesCss "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/components/Particles.css"
    click anim1 "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/assets/animation.json"
    click anim2 "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/assets/animation2.json"
    click anim3 "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/assets/animation3.json"
    click anim4 "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/assets/animation4.json"
    click anim5 "https://github.com/0alduin0/portfolio-with-nodejs-react/blob/main/src/assets/animation5.json"
    click images "https://github.com/0alduin0/portfolio-with-nodejs-react/tree/main/src/assets/images"

    %% Styles
    classDef build fill:#BBDEFB,stroke:#1E88E5
    classDef static fill:#C8E6C9,stroke:#388E3C
    classDef client fill:#FFE0B2,stroke:#FB8C00
    classDef runtime fill:#EEEEEE,stroke:#757575
    class pkgJson,pkgLock,tailwindConfig,envExample,npmScripts,srcIndex,srcIndexCss build
    class indexHtml,manifest,robots,cvPdf static
    class browser client
    class App,nav,hero,about,skills,projects,contact,welcome,footer,ParticlesJs,ParticlesCss,anim1,anim2,anim3,anim4,anim5,images runtime
```
