# duisternis/r-dexpo24 architecture

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

- Interactive diagram: https://gitdiagram.com/duisternis/r-dexpo24
- Repository: https://github.com/duisternis/r-dexpo24

## Overview

##### Project Type and Purpose
- This is a single-page application (SPA) built with React and Vite.
- It has no dedicated backend or database—its focus is on rendering a dynamic landing/event page, complete with preloader, animated components, and static 3D/GLB assets.
- The README confirms it’s a minimal React + Vite template enhanced with Tailwind CSS, Framer Motion, Material-UI, GSAP, and React Swipeable Views.

##### File Structure
Top-level:
- index.html – SPA entry point
- package.json, package-lock.json – dependency manifest
- vite.config.js, postcss.config.js, tailwind.config.js – build & styling config
- public/scene.glb – static 3D asset
- src/ – all React code and CSS
Inside src:
- main.jsx – bootstraps React into index.html
- App.jsx/App.css – root component and global styles
- Preloader/ – preloading animation and wrapper
- components/ – feature modules: Navbar, Landing, About, Events, TimeLine, Sponsers, Footer
- assets/ – images and subfolders by feature
- content/ – hardcoded content data (cEvents.jsx, cTimeLine.jsx)
- index.css – Tailwind base imports

##### README Insights
- Uses Vite’s HMR for fast development loops via plugin-react or plugin-react-swc.
- Styling by Tailwind CSS, PostCSS; animations by Framer Motion and GSAP; UI kits by Material-UI; swipe via react-swipeable-views.

- source code → build step
- build output → browser
- browser → user interaction → component updates
- Build Tools (gray)
- UI Components (blue)
- Assets & Content (green)
- Animation Libraries (orange)
- Hosting/CDN (purple)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Dev & Build Pipeline
    subgraph "Dev & Build Pipeline"
        direction TB
        Vite["Vite Dev Server<br/>(vite.config.js)"]:::build
        PostCSS["PostCSS & Tailwind Processor<br/>(postcss.config.js & tailwind.config.js)"]:::build
        Babel["React Refresh Plugin<br/>(plugin-react)"]:::build
        ESLint["ESLint<br/>(.eslintrc.cjs)"]:::build
        PackageJSON["Dependencies<br/>(package.json & package-lock.json)"]:::build
        Vite -->|uses| Babel
        Vite -->|uses| PostCSS
        Vite -->|validates| ESLint
        PackageJSON -->|provides deps| Vite
    end

    %% Application Bundling
    BuildOutput["Bundle (JS/CSS)"]:::build
    Vite -->|builds| BuildOutput
    PostCSS -->|processes CSS| BuildOutput

    %% Deployment/Hosting
    subgraph "Deployment / Hosting"
        direction TB
        CDN["Static Host / CDN"]:::hosting
    end
    BuildOutput -->|deploy| CDN

    %% Client Runtime
    subgraph "Client Runtime (Browser)" 
        direction TB
        HTML["SPA Entry Point<br/>(index.html)"]:::ui
        MainJS["React Bootstrap<br/>(src/main.jsx)"]:::ui
        AppComp["App Component<br/>(src/App.jsx & App.css)"]:::ui
        Styles["Global Styles<br/>(src/index.css)"]:::ui

        %% Feature Modules
        subgraph "UI Components" 
            direction TB
            PreloaderModule["Preloader Module"]:::ui
            NavbarModule["Navbar Module"]:::ui
            LandingModule["Landing Module"]:::ui
            AboutModule["About Module"]:::ui
            EventsModule["Events Module"]:::ui
            TimeLineModule["TimeLine Module"]:::ui
            SponsersModule["Sponsers Module"]:::ui
            FooterModule["Footer Module"]:::ui
        end

        %% Assets & Content
        subgraph "Assets & Content" 
            direction TB
            Static3D["3D Asset (scene.glb)"]:::assets
            ImageAssets["Image/Media Assets<br/>(src/assets/)"]:::assets
            ContentStore["Content Data<br/>(src/content/)"]:::assets
        end

        %% Animation Libraries
        subgraph "Animation Engines" 
            direction TB
            Framer["Framer Motion"]:::anim
            GSAP["GSAP"]:::anim
            Swipe["React Swipeable Views"]:::anim
            MUI["Material-UI"]:::anim
        end

        HTML -->|loads| MainJS
        MainJS -->|mounts| AppComp
        AppComp -->|imports| Styles
        AppComp -->|renders| PreloaderModule
        AppComp -->|renders| NavbarModule
        AppComp -->|renders| LandingModule
        AppComp -->|renders| AboutModule
        AppComp -->|renders| EventsModule
        AppComp -->|renders| TimeLineModule
        AppComp -->|renders| SponsersModule
        AppComp -->|renders| FooterModule

        PreloaderModule -->|uses| Styles
        NavbarModule -->|uses| ImageAssets
        LandingModule -->|uses| ImageAssets
        AboutModule -->|uses| ContentStore
        EventsModule -->|uses| ContentStore
        TimeLineModule -->|uses| ContentStore
        SponsersModule -->|uses| ImageAssets
        FooterModule -->|uses| Styles

        PreloaderModule -->|animates with| Framer
        LandingModule -->|animates with| GSAP
        EventsModule -->|swipe with| Swipe
        NavbarModule -->|UI kit| MUI
        FooterModule -->|UI kit| MUI

        AppComp -->|fetches| Static3D
    end

    CDN -->|serves| HTML

    %% Click Events
    click Vite "https://github.com/duisternis/r-dexpo24/blob/main/vite.config.js"
    click PostCSS "https://github.com/duisternis/r-dexpo24/blob/main/postcss.config.js"
    click PostCSS "https://github.com/duisternis/r-dexpo24/blob/main/tailwind.config.js"
    click HTML "https://github.com/duisternis/r-dexpo24/blob/main/index.html"
    click PackageJSON "https://github.com/duisternis/r-dexpo24/blob/main/package.json"
    click PackageJSON "https://github.com/duisternis/r-dexpo24/blob/main/package-lock.json"
    click MainJS "https://github.com/duisternis/r-dexpo24/blob/main/src/main.jsx"
    click AppComp "https://github.com/duisternis/r-dexpo24/blob/main/src/App.jsx"
    click Styles "https://github.com/duisternis/r-dexpo24/blob/main/src/index.css"
    click PreloaderModule "https://github.com/duisternis/r-dexpo24/blob/main/src/Preloader/Preloader.jsx"
    click NavbarModule "https://github.com/duisternis/r-dexpo24/blob/main/src/components/Navbar/Main.jsx"
    click LandingModule "https://github.com/duisternis/r-dexpo24/blob/main/src/components/Landing/Main.jsx"
    click AboutModule "https://github.com/duisternis/r-dexpo24/blob/main/src/components/About/Main.jsx"
    click EventsModule "https://github.com/duisternis/r-dexpo24/blob/main/src/components/Events/Main.jsx"
    click TimeLineModule "https://github.com/duisternis/r-dexpo24/blob/main/src/components/TimeLine/Main.jsx"
    click SponsersModule "https://github.com/duisternis/r-dexpo24/blob/main/src/components/Sponsers/Main.jsx"
    click FooterModule "https://github.com/duisternis/r-dexpo24/blob/main/src/components/Footer/Main.jsx"
    click Static3D "https://github.com/duisternis/r-dexpo24/blob/main/public/scene.glb"
    click ImageAssets "https://github.com/duisternis/r-dexpo24/tree/main/src/assets/events/"
    click ContentStore "https://github.com/duisternis/r-dexpo24/blob/main/src/content/cEvents.jsx"

    %% Styles
    classDef build fill:#d3d3d3,stroke:#888,stroke-width:1px
    classDef ui fill:#cce5ff,stroke:#339,stroke-width:1px
    classDef assets fill:#d4edda,stroke:#3a3,stroke-width:1px
    classDef anim fill:#ffe5b4,stroke:#e68a00,stroke-width:1px
    classDef hosting fill:#e3d4f1,stroke:#5a1ea1,stroke-width:1px
```
