# canxerian/lusion-reverse-engineered architecture

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

- Interactive diagram: https://gitdiagram.com/canxerian/lusion-reverse-engineered
- Repository: https://github.com/canxerian/lusion-reverse-engineered

## Overview

##### Project type and purpose
- This is a single-page, front-end-only 3D immersive website built with JavaScript and WebGL (Three.js under the hood).
- It re-implements https://lusion.co purely in the browser to learn how to build interactive 3D web experiences.

##### File structure
- Top-level files
– index.html, index.css : the host page and styling
– main.js & main-realtime-cubemap.js : entry points for different rendering flows
– package.json & vite.config.js : Node/npm dependencies and dev/build config
- src/ directory (modular JS code)
– scene3d.js: orchestrates Three.js renderer, camera, scene graph
– homeScene.js, physicsSandbox.js, projectTiles.js, ikTest.js : self-contained “scene” modules
– videoPanel*.js, animatedLine.js, animatedTube.js : feature modules for animations & video
– shaders/: custom GLSL fragments & verts
– utils/: helpers for animation, nurbs, loading, paging, debug GUI
- assets/ vs _source_assets/
– assets/: production-ready glTF, HDRI, JSON, video
– _source_assets/: original Blender and cache files (not shipped)

##### README for insights
- Confirms “reverse engineered” static site, no back end
- Uses npm start → starts a Vite dev server for HMR & bundling

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Build Layer
    subgraph "Development & Build Layer"
        direction TB
        NodeJS["Node.js + npm"]:::build
        Vite["Vite Dev Server & Bundler"]:::build
        Package["package.json"]:::build
        Config["vite.config.js"]:::build
    end

    %% Delivery Layer
    subgraph "Delivery Layer"
        direction TB
        HTML["index.html"]:::build
        CSS["index.css"]:::build
        Assets["Production Assets (assets/)"]:::asset
    end

    %% Client Layer
    subgraph "Client (Browser)"
        direction TB
        subgraph "Entry Points"
            direction TB
            Main["main.js"]:::entry
            Realtime["main-realtime-cubemap.js"]:::entry
        end

        subgraph "Core Engine & Orchestration"
            direction TB
            SceneMgr["Scene Manager (scene3d.js)"]:::core
            ThreeJS["Three.js Renderer & WebGL"]:::core
            AssetLoader["Asset Loader"]:::core
        end

        subgraph "Scene Modules"
            direction TB
            Home["homeScene.js"]:::feature
            Physics["physicsSandbox.js"]:::feature
            ProjectTiles["projectTiles.js"]:::feature
            IK["ikTest.js"]:::feature

            subgraph "Project Tiles Components"
                direction TB
                TileComp1["ProjectTile.js"]:::feature
                TileComp2["TileMeshMaterial.js"]:::feature
            end
        end

        subgraph "Animation & Feature Modules"
            direction TB
            AnimLine["animatedLine.js"]:::feature
            AnimTube["animatedTube.js"]:::feature
            VP_Old["videoPanel.old.js"]:::feature
            VP_Bones["videoPanelBones.js"]:::feature
            VP_Wiggle["videoPanelWiggleBones.js"]:::feature
            VP_Shader["videoPanelShader.js"]:::feature
            Paging["paging.js"]:::feature
            DebugGUI["debugGui.js"]:::feature
        end

        subgraph "Utility Modules"
            direction TB
            LoadGroup["loadingGroup.js"]:::util
            Accel["accelerateValue.js"]:::util
            Nurbs["nurbsUtils.js"]:::util
            AnimUtils["animationUtils.js"]:::util
            Utils["utils.js"]:::util
        end

        subgraph "Shader Pipeline"
            direction TB
            Common["common.glsl"]:::shader
            LoadMeshFrag["loadingMeshFrag.glsl"]:::shader
            LoadMeshVert["loadingMeshVert.glsl"]:::shader
            TileFrag["projectTileFrag.glsl"]:::shader
            TileVert["projectTileVert.glsl"]:::shader
            VPFrag["videoPanelFrag.glsl"]:::shader
            VPVert["videoPanelVert.glsl"]:::shader
        end

        SourceAssets["_source_assets/"]:::asset
    end

    %% Connections
    NodeJS -->|runs| Vite
    Package -->|defines deps| Vite
    Config -->|configures| Vite

    Vite -->|serves| HTML
    Vite -->|serves| CSS
    Vite -->|serves| Assets

    HTML -->|loads bundle| Main
    HTML -->|loads bundle| Realtime

    Main -->|imports| SceneMgr
    Realtime -->|imports| SceneMgr

    SceneMgr -->|initializes| ThreeJS
    SceneMgr -->|calls| Home
    SceneMgr -->|calls| Physics
    SceneMgr -->|calls| ProjectTiles
    SceneMgr -->|calls| IK

    ProjectTiles -->|uses| TileComp1
    ProjectTiles -->|uses| TileComp2

    SceneMgr -->|uses| AssetLoader
    AssetLoader -->|loads| Assets
    AssetLoader -->|loads| LoadMeshFrag
    AssetLoader -->|loads| LoadMeshVert
    AssetLoader -->|loads| TileFrag
    AssetLoader -->|loads| TileVert
    AssetLoader -->|loads| VPFrag
    AssetLoader -->|loads| VPVert

    SceneMgr -->|imports| LoadGroup
    SceneMgr -->|imports| Accel
    SceneMgr -->|imports| Nurbs
    SceneMgr -->|imports| AnimUtils
    SceneMgr -->|imports| Utils

    Home -->|uses shader| Common
    Physics -->|uses shader| Common

    AnimLine -->|drives| ThreeJS
    AnimTube -->|drives| ThreeJS
    VP_Old -->|drives| ThreeJS
    VP_Bones -->|drives| ThreeJS
    VP_Wiggle -->|drives| ThreeJS
    VP_Shader -->|drives| ThreeJS
    Paging -->|controls| SceneMgr
    DebugGUI -->|controls| SceneMgr

    SourceAssets -->|for editing| Assets

    %% Click Events
    click Config "https://github.com/canxerian/lusion-reverse-engineered/blob/main/vite.config.js"
    click Package "https://github.com/canxerian/lusion-reverse-engineered/blob/main/package.json"
    click HTML "https://github.com/canxerian/lusion-reverse-engineered/blob/main/index.html"
    click CSS "https://github.com/canxerian/lusion-reverse-engineered/blob/main/index.css"
    click Assets "https://github.com/canxerian/lusion-reverse-engineered/tree/main/assets/"
    click Main "https://github.com/canxerian/lusion-reverse-engineered/blob/main/main.js"
    click Realtime "https://github.com/canxerian/lusion-reverse-engineered/blob/main/main-realtime-cubemap.js"
    click SceneMgr "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/scene3d.js"
    click Home "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/homeScene.js"
    click Physics "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/physicsSandbox.js"
    click ProjectTiles "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/projectTiles.js"
    click IK "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/ikTest.js"
    click TileComp1 "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/projectTiles/ProjectTile.js"
    click TileComp2 "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/projectTiles/TileMeshMaterial.js"
    click AnimLine "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/animatedLine.js"
    click AnimTube "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/animatedTube.js"
    click VP_Old "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/videoPanel.old.js"
    click VP_Bones "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/videoPanelBones.js"
    click VP_Wiggle "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/videoPanelWiggleBones.js"
    click VP_Shader "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/videoPanelShader.js"
    click Paging "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/paging.js"
    click DebugGUI "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/debugGui.js"
    click LoadGroup "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/loadingGroup.js"
    click Accel "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/accelerateValue.js"
    click Nurbs "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/utils/nurbsUtils.js"
    click AnimUtils "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/utils/animationUtils.js"
    click Utils "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/utils/utils.js"
    click Common "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/shaders/common.glsl"
    click LoadMeshFrag "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/shaders/loadingMeshFrag.glsl"
    click LoadMeshVert "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/shaders/loadingMeshVert.glsl"
    click TileFrag "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/shaders/projectTileFrag.glsl"
    click TileVert "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/shaders/projectTileVert.glsl"
    click VPFrag "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/shaders/videoPanelFrag.glsl"
    click VPVert "https://github.com/canxerian/lusion-reverse-engineered/blob/main/src/shaders/videoPanelVert.glsl"
    click SourceAssets "https://github.com/canxerian/lusion-reverse-engineered/tree/main/_source_assets/"

    %% Styles
    classDef build fill:#D6EAF8,stroke:#1B4F72,color:#1B4F72
    classDef entry fill:#EBF5FB,stroke:#1A5276,color:#1A5276
    classDef core fill:#D5F5E3,stroke:#145A32,color:#145A32
    classDef feature fill:#FCF3CF,stroke:#7D6608,color:#7D6608
    classDef asset fill:#FDEBD0,stroke:#7E5109,color:#7E5109
    classDef util fill:#FADBD8,stroke:#78281F,color:#78281F
    classDef shader fill:#E8DAEF,stroke:#6C3483,color:#6C3483
```
