# killich8/devops-website architecture

> Architecture diagram of the GitHub repository killich8/devops-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/killich8/devops-website
- Repository: https://github.com/killich8/devops-website

## Overview

##### Project type and purpose
- This is a single-page frontend application built with React and Vite.
- It appears to be a personal/portfolio-style site (sections like Hero, About, Experience, Blogs, Contact, with 3D canvas scenes).
- It is configured for Firebase Hosting (firebase.json, .firebaserc).

##### File structure
- Top level:
- Configuration files (vite.config.js, tailwind.config.js, eslint.config.js, package.json, firebase.json)
- Public folder: static assets and 3D scene files under `public/desktop_pc`, `public/planet`
- src folder: application source code
- src breakdown:
- App.jsx / main.jsx entrypoints
- components/ – React presentational & canvas components (Ball, Earth, Computers, Stars)
- hoc/ – SectionWrapper higher-order component
- constants/, utils/ – shared values and motion helpers
- styles.js, index.css – styling (tailwind + CSS modules)
- Build & deployment:
- Vite dev server with HMR
- Production build outputs to `/dist` (zipped in dist.zip)
- Hosted via Firebase

##### README
- Confirms React + Vite template with HMR via either Babel or SWC plugin
- No backend services beyond static hosting

a. Main components
- Developer workstation
- Source code (src/)
- Vite dev server + HMR
- Build pipeline
- Vite (plugins: @vitejs/plugin-react or plugin-react-swc)
- Tailwind CSS processor
- ESLint, postcss
- Runtime environment
- Static assets (public/) served by Firebase Hosting (CDN)
- Client browser running React app
- External services
- Firebase Hosting
b. Relationships & interactions
- DEV: Editor → Vite dev server → Browser (HMR)
- PROD: src + public + configs → Vite build → dist (static files) → Firebase CLI → Firebase Hosting (CDN) → End-user browser
- At runtime the React app loads 3D scenes from `/public/*`, assets from `/assets/*`, and renders via three.js in canvas components.
c. Architectural patterns / design principles
- Component-based UI (React)
- HOC pattern (SectionWrapper) for section demarcation
- Static asset pipeline (3D models, textures)
- CSS utility classes (Tailwind)
d. Key technologies
- React, Vite, Babel or SWC plugin
- Tailwind CSS, PostCSS
- ESLint
- Firebase Hosting
- three.js (via canvas components)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer Machine
    subgraph "Developer Machine"
        direction TB
        Editor["Code Editor"]:::tool
        ViteDev["Vite Dev Server"]:::tool
    end

    %% Build Pipeline
    subgraph "Build Pipeline"
        direction TB
        Vite["Vite Build"]:::tool
        ESLint["ESLint"]:::tool
        TailwindPostCSS["Tailwind CSS & PostCSS"]:::tool
    end

    %% Static Hosting
    subgraph "Static Hosting"
        direction TB
        FirebaseCLI["Firebase CLI"]:::tool
        FirebaseHost["Firebase Hosting (CDN)"]:::service
    end

    %% Browser / Client
    subgraph "Browser / Client"
        direction TB
        ReactApp["React Application"]:::code
        Assets["Image & Icon Assets"]:::asset
        Scenes["3D Scenes & Textures"]:::asset
    end

    %% React Application Internal
    subgraph "React Application Components"
        direction TB
        Sections["SectionWrapper HOC"]:::code
        Presentational["Presentational Components"]:::code
        Canvas["Canvas (three.js) Scenes"]:::code
        Utils["Motion Utilities"]:::code
        Constants["Constants"]:::code
        StylesJS["JS-based Styles"]:::code
        GlobalCSS["Global CSS"]:::code
    end

    %% Flows
    Editor -->|edits src/ & configs| ViteDev
    ViteDev -->|HMR| ReactApp

    %% Production Flow
    Src["Source Code (src/)"]:::code -->|input| Vite
    Public["Static Assets (public/)"]:::asset -->|input| Vite
    Configs["Configs (vite.config.js, tailwind.config.js, eslint.config.js, postcss.config.js)"]:::code -->|input| Vite
    Vite -->|build output| Dist["Dist (dist/)"]:::output
    Dist -->|deploy| FirebaseCLI
    FirebaseCLI -->|deploy| FirebaseHost
    FirebaseHost -->|serves| ReactApp

    %% Runtime asset loading
    ReactApp -->|loads| Assets
    ReactApp -->|loads| Scenes

    %% React internal composition
    ReactApp --> Sections
    ReactApp --> Presentational
    ReactApp --> Canvas
    ReactApp --> Utils
    ReactApp --> Constants
    ReactApp --> StylesJS
    ReactApp --> GlobalCSS

    %% Click events
    click Src "https://github.com/killich8/devops-website/tree/main/src/"
    click Vite "https://github.com/killich8/devops-website/blob/main/vite.config.js"
    click Configs "https://github.com/killich8/devops-website/blob/main/vite.config.js"
    click Configs "https://github.com/killich8/devops-website/blob/main/tailwind.config.js"
    click Configs "https://github.com/killich8/devops-website/blob/main/eslint.config.js"
    click Configs "https://github.com/killich8/devops-website/blob/main/postcss.config.js"
    click ViteDev "https://github.com/killich8/devops-website/blob/main/vite.config.js"
    click Sections "https://github.com/killich8/devops-website/blob/main/src/hoc/SectionWrapper.jsx"
    click Presentational "https://github.com/killich8/devops-website/tree/main/src/components/"
    click Canvas "https://github.com/killich8/devops-website/tree/main/src/components/canvas/"
    click Utils "https://github.com/killich8/devops-website/blob/main/src/utils/motion.js"
    click Constants "https://github.com/killich8/devops-website/blob/main/src/constants/index.js"
    click StylesJS "https://github.com/killich8/devops-website/blob/main/src/styles.js"
    click GlobalCSS "https://github.com/killich8/devops-website/blob/main/src/index.css"
    click Assets "https://github.com/killich8/devops-website/tree/main/src/assets/"
    click Scenes "https://github.com/killich8/devops-website/tree/main/public/desktop_pc/"
    click Scenes "https://github.com/killich8/devops-website/tree/main/public/planet/"
    click FirebaseCLI "https://github.com/killich8/devops-website/blob/main/firebase.json"
    click FirebaseCLI "https://github.com/killich8/devops-website/blob/main/.firebaserc"
    click Dist "https://github.com/killich8/devops-website/blob/main/dist.zip"

    %% Styles
    classDef tool fill:#f9f,stroke:#333,stroke-width:1px;
    classDef code fill:#ff9,stroke:#333,stroke-width:1px;
    classDef service fill:#9f9,stroke:#333,stroke-width:1px;
    classDef asset fill:#9cf,stroke:#333,stroke-width:1px;
    classDef output fill:#f99,stroke:#333,stroke-width:1px;
```
