Skip to content

sujitkoji/lighthouse

Repository files navigation

L I G H T H O U S E

001 // DIGITAL LANDSCAPE ENGINE

WebGL React Three Fiber Next.js License: MIT

An immersive maritime environment crafted with WebGL & React Three Fiber.

[ LAUNCH EXPERIENCE ]   •   [ RESOURCES ]


Header


/ VISION

LightHouse is a cinematic WebGL experiment focused on atmosphere, scale, and motion.
The project simulates a stormy maritime scene where ocean dynamics, volumetric clouds, lightning, and lighting choreography work together to create a believable digital landscape — entirely inside the browser.

Every system is designed to run GPU-first, keeping React out of the render loop while maintaining declarative structure.


/ CORE SYSTEMS

[ 01. HYDROS ]

Custom Ocean Surface
Shader-driven water + caustics
[ 02. ATMOS ]

Dynamic Sky & Clouds
Volumetric + instanced motion
[ 03. SIGNAL ]

Lighthouse & Signal
Rotating beam + stochastic flashes

/ SYSTEM DESIGN NOTES

// OCEAN SIMULATION

The ocean is built using three-stdlib’s Water shader, extended via onBeforeCompile to introduce animated caustics. Wave motion is driven by time-based uniforms.

$$y = A \cdot \sin(\omega t + \phi)$$

// LIGHT & WEATHER

  • Lightning: Probabilistic point-light system with temporal decay.
  • Lighthouse beam: Spotlight with high penumbra for cinematic softness.

/ PERFORMANCE STRATEGY

IMPERATIVE UPDATESDPR CLAMPINGGLTF OPTIMIZATIONSUSPENSE PIPELINE


/ PROJECT STRUCTURE

app/
 ├─ lighthouse/
 │  ├─ scene.tsx          // Main R3F canvas
 │  ├─ ocean.tsx          // Water + shader extensions
 │  ├─ MovingClouds.tsx   // Volumetric cloud system
 │  ├─ Lightning.tsx      // Lightning flashes
 │  └─ lighthouseGLB.tsx  // Lighthouse model & beam
 │
 └─ Loader/
    └─ loader.tsx         // Cinematic loading screen

/ ARCHITECTURE

graph LR
    A[Canvas] --> B[Sky & Fog]
    A --> C[Ocean Shader]
    A --> D[Cloud System]
    A --> E[Lighthouse]
    E --> F[Rotating Beam]
    E --> G[Warm Glow]
    A --> H[Lightning System]
    style A fill:#111,stroke:#58a6ff,stroke-width:2px
    style E fill:#111,stroke:#8b949e,stroke-width:2px
Loading

/ LICENSE & USAGE

This project is a Technical Study and is intended for Educational Purposes only. 

[ 01. LOGIC ] The source code is licensed under the MIT License. You are free to explore, fork, and adapt the engine for your own experiments. [ 02. ASSETS ] The 3D models, textures, and environment maps remain the intellectual property of their respective creators. No commercial usage is permitted for the assets contained within this repository. [ 03. ATTRIBUTION ] This is a non-commercial laboratory. If the shader logic or atmospheric systems are integrated into your projects, a credit back to Sujit Koji is required to maintain the spirit of open-source authorship.


/ ARCHITECTURE AUTHORSHIP

SUJIT KOJI Creative Technologist & WebGL Architect [ PORTFOLIO ]   /   [ LINKEDIN ]

© 2026 - Open Source Creative Experiment

About

⚓ Lighthouse: A cinematic, high-fidelity digital sentinel experience. Built with Next.js and Framer Motion, featuring a noise-textured UI, real-time status HUD, and an interactive data-archived sidebar. Designed for the lost voyagers of the digital sea.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors