Skip to content

Repository files navigation

🌐 PROJECT AETHER (v2.0.0)

An interactive 3D neural-interface portfolio blending cinematic WebGL experiences with modern front-end architecture.

Build Status React Three.js Tailwind CSS Zustand Vite


📖 Overview

Project Aether is a next-generation personal portfolio designed to feel less like a conventional website and more like an immersive, futuristic operating system.

The experience combines an interactive WebGL 3D environment with a responsive, React-powered DOM interface, creating a unified digital experience built around cinematic visuals, modular interfaces, and state-driven interactions.

Project Aether serves two purposes:

  1. A personal portfolio for showcasing projects, technical skills, and professional identity.
  2. An engineering showcase demonstrating modern front-end architecture, real-time 3D rendering, interactive UI systems, and performance-conscious development.

The application is structured around a separation of concerns between the 3D rendering layer, DOM-based interface layer, and centralized application state.


✨ Core System Architecture

Project Aether is organized around three primary architectural layers.

🧠 1. State Management Engine

A centralized Zustand store coordinates application-wide UI state, module visibility, and interface transitions.

The state layer acts as the communication bridge between the interactive DOM interface and the WebGL environment.

Key principles:

  • Centralized State: Shared application state is managed through a lightweight global store.
  • Selective Subscriptions: Components subscribe only to the state they require, helping minimize unnecessary UI updates.
  • Decoupled Architecture: UI components and 3D components remain independently structured while responding to shared application state.
  • Modular Navigation: Individual experiences such as the Terminal, AI Lab, Projects, and Network interfaces can be activated through state-driven interactions.

🪐 2. WebGL 3D Experience Layer

The immersive spatial environment is powered by Three.js and React Three Fiber.

The 3D layer is responsible for rendering the visual environment independently from the DOM-based interface.

Key systems include:

  • Procedural Particle System: Mathematically generated particles rendered through buffer-based geometry techniques.
  • Procedural Geometry: Custom 3D structures forming the core visual identity of the Aether environment.
  • Lighting & Atmosphere: Dynamic lighting, environmental effects, and atmospheric depth.
  • Additive Blending: Used for selected visual elements to create a futuristic, holographic aesthetic.
  • Post-Processing: Cinematic visual effects such as bloom and other rendering enhancements where appropriate.
  • Interactive Camera: Spatial navigation and camera movement designed to create a sense of depth and immersion.

The 3D environment is designed with performance awareness in mind, balancing visual complexity with responsive interaction.


🖥️ 3. Glassmorphic HUD

The DOM layer provides the primary user interface and interaction system.

Built with React and Tailwind CSS, the HUD is positioned above the WebGL canvas and provides structured access to the portfolio's different experiences.

Core interface modules include:

  • Boot Sequence: A simulated system initialization experience.
  • Command Center: Central navigation hub for accessing portfolio modules.
  • Projects Window: Interactive presentation of technical and creative projects.
  • AI Lab: Dedicated interface for showcasing artificial intelligence and machine learning work.
  • Network Window: A futuristic contact and professional identity interface.
  • Terminal: Command-line-inspired interaction layer.

The UI is designed around a modular component architecture so individual experiences can evolve independently.


🧩 System Topology

                         ┌─────────────────────────┐
                         │      PROJECT AETHER     │
                         └────────────┬────────────┘
                                      │
                    ┌─────────────────┴─────────────────┐
                    │                                   │
                    ▼                                   ▼
           ┌──────────────────┐                ┌──────────────────┐
           │   React DOM UI   │                │  WebGL 3D Layer  │
           │                  │                │                  │
           │  Glassmorphic UI │                │  Three.js / R3F  │
           │  HUD Components  │                │  Buffer Geometry │
           │  Terminal        │◄──────────────►│  Lighting        │
           │  Project Modules │                │  Particles       │
           │  Network Matrix  │                │  Post-Processing │
           └────────┬─────────┘                └────────┬─────────┘
                    │                                   │
                    └─────────────────┬─────────────────┘
                                      │
                                      ▼
                           ┌─────────────────────┐
                           │    Zustand Store    │
                           │                     │
                           │  Global UI State    │
                           │  Module Visibility  │
                           │  UI Transitions     │
                           │  Application State  │
                           └─────────────────────┘

🛠️ Technical Stack

Category Technology Purpose
Framework React Component-based application architecture
Build Tool Vite Fast development server and production bundling
3D Engine Three.js Hardware-accelerated WebGL rendering
React 3D React Three Fiber Declarative React integration for Three.js
3D Utilities React Three Drei Reusable helpers and abstractions for R3F
State Management Zustand Lightweight global application state
Styling Tailwind CSS Utility-first responsive styling
Iconography Lucide React Consistent scalable interface icons

🏗️ Architectural Principles

Project Aether is built around several engineering principles.

Separation of Concerns

The application separates:

  • 3D rendering logic
  • DOM interface components
  • Global state management
  • Terminal interaction
  • Portfolio content

This keeps individual systems modular and easier to maintain.

Component Modularity

Each major interface and visual system is encapsulated into dedicated React components.

This makes it possible to extend the portfolio without turning the root application into a monolithic component.

Performance Awareness

The architecture is designed to avoid unnecessary coupling between the React DOM tree and the WebGL rendering loop.

Performance considerations include:

  • Buffer-based geometry for particle rendering
  • Selective state subscriptions
  • GPU-accelerated WebGL rendering
  • Modular component updates
  • Separation between visual rendering and interface logic

Performance targets should be validated through browser profiling and real-device testing as the project evolves.

Progressive Enhancement

The portfolio prioritizes a rich visual experience while maintaining a structured DOM-based interface.

Future iterations may introduce additional optimizations for lower-powered devices and mobile hardware.


🚀 Local Development

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/project-aether.git

2. Navigate to the Project

cd project-aether

3. Install Dependencies

npm install

4. Start the Development Server

npm run dev

The development server will typically be available at:

http://localhost:5173/

5. Create a Production Build

npm run build

6. Preview the Production Build

npm run preview

📁 Source Architecture

project-aether/
│
├── public/
│
├── src/
│   │
│   ├── components/
│   │   │
│   │   ├── canvas/
│   │   │   ├── AetherCanvas.jsx
│   │   │   ├── CyberSpire.jsx
│   │   │   └── DataParticles.jsx
│   │   │
│   │   ├── hud/
│   │   │   ├── BootScreen.jsx
│   │   │   ├── CommandCenter.jsx
│   │   │   ├── ProjectsWindow.jsx
│   │   │   ├── AiLabWindow.jsx
│   │   │   └── NetworkWindow.jsx
│   │   │
│   │   └── terminal/
│   │       └── TerminalWindow.jsx
│   │
│   ├── store/
│   │   └── useAetherStore.js
│   │
│   ├── App.jsx
│   └── main.jsx
│
├── package.json
├── README.md
├── vite.config.js
└── LICENSE

Note: The structure above represents the intended high-level architecture. File names and directories may evolve as the project develops.


🎯 Design Philosophy

Project Aether is built around three core principles.

01 — Immersion

The portfolio should function as a cohesive digital environment rather than a collection of disconnected static pages.

Every interaction is intended to contribute to the feeling of navigating a futuristic digital system.

02 — Engineering Rigor

Visual complexity should be supported by a maintainable and modular software architecture.

The goal is not simply to create an impressive visual experience, but to demonstrate how interactive systems can be structured, extended, and maintained.

03 — Performance First

Cinematic visuals must coexist with responsive interactions.

The project prioritizes efficient rendering techniques, component modularity, and separation between the WebGL rendering pipeline and DOM interface logic.


📈 Roadmap

Experience

  • Advanced camera path transitions
  • Interactive 3D project showcases
  • Expanded command-center interactions
  • Enhanced mobile experience (via tiered performance system)

Graphics

  • Audio-reactive visual effects
  • Custom GLSL shader environments
  • Advanced procedural animations
  • Tiered post-processing pipeline

Interaction

  • Fully interactive command-line execution
  • Voice-controlled portfolio navigation
  • Context-aware interface responses
  • Interactive AI assistant integration

Engineering

  • Automated testing (Vitest)
  • CI/CD pipeline (GitHub Actions)
  • Production deployment (Vercel)
  • WebGL performance profiling
  • Accessibility audit
  • Cross-device performance optimization

🔬 Performance & Engineering Goals

As the project evolves, performance will be evaluated across both the DOM interface and WebGL rendering pipeline.

Planned areas of evaluation include:

  • Frame-rate stability
  • GPU utilization
  • JavaScript execution time
  • React component rendering
  • WebGL draw calls
  • Memory usage
  • Initial page load
  • Asset loading performance
  • Mobile and low-powered device behavior

The goal is to maintain an immersive experience without allowing visual complexity to compromise usability or responsiveness.


🌍 Deployment

Project Aether is currently deployed via Vercel with a continuous integration pipeline.

  • CI Pipeline: GitHub Actions automatically runs the Vitest test suite and linters on every pull request and push to the main branch.
  • CD Pipeline: Vercel automatically deploys successful builds from the main branch.

👨‍💻 Architected By

Harsh Kumar Gupta

AI & Robotics Specialist / ML Engineer

Building intelligent systems, immersive digital experiences, and technology at the intersection of:

  • Artificial Intelligence
  • Machine Learning
  • Mathematics
  • Front-End Engineering
  • 3D Interactive Experiences

📄 License

This project is intended to be released under the MIT License.

See the LICENSE file for details.


⭐ Project Status

Project Aether — V1.0 Foundation

An evolving experiment in combining modern web engineering, real-time 3D graphics, and immersive interface design into a single portfolio experience.

The interface is the portfolio. The architecture is the story.

About

Project Aether is a next-generation personal portfolio designed to feel less like a conventional website and more like an immersive, futuristic operating system.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages