Skip to content
Public template

About

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

239 Commits

Folders and files

Repository files navigation

πŸš€ Tejasvin β€” Hidden Heritage

A Cognitive Spatial Computing Platform transforming historical archives into immersive living experiences using WebXR.

React Node.js Vite WebXR MySQL MongoDB License Live Demo

Built for Spatial Computing β€” Tejasvin bridges the gap between memory and perception, offering an attention-guided narrative experience to uncover the forgotten architecture of the Indian subcontinent. It is a cinematic, weightless interface designed for the next generation of spatial interaction.


πŸŽ₯ VISUAL SHOWCASE

Hero Screenshot Cinematic entry portal with neural easing and glass-morphic HUD.

3D Artifact Viewer WebXR-powered 1:1 scale rendering of historical artifacts.

Spatial Interface Cognitive flow-based navigation eliminating traditional UI friction.

Dashboard View Complex 3-column expedition planner with spatial metadata tracking.


πŸ“œ RESEARCH ABSTRACT

Abstract: Traditional digital heritage platforms rely on static archival paradigms, leading to high cognitive load and low immersive engagement. Tejasvin β€” Hidden Heritage introduces a novel cognitive spatial computing platform utilizing WebXR. By conceptualizing history as a "living signal," our system implements a dual-database architecture (MySQL for structured relational integrity, MongoDB for fluid spatial interaction metadata) to drive a neural user experience (UX). Preliminary implementation reveals that orchestrating spatial storytelling through immersive interfaces significantly reduces user friction and enhances cognitive retention, establishing a scalable foundation for next-generation digital preservation.


🌌 PROJECT VISION

History should not be merely browsedβ€”it must be experienced. The current landscape of digital archives reduces profound human heritage to flat text and 2D images.

Tejasvin envisions a future where historical exploration is driven by Neural UX philosophy. By treating cultural memory as spatial data, we design interfaces that respond dynamically to user attention. Our approach minimizes cognitive load through contextual dissolving menus, cinematic pacing, and augmented reality (AR) preservation. This is the future of immersive knowledge systems: not a database you query, but an environment you inhabit.


✨ FEATURE MATRIX

Feature Description Tech Used Status
WebXR Exploration 1:1 Scale immersive 3D artifact rendering React Three Fiber, WebXR 🟒 Active
Neural UX Interface Glass-morphic, attention-guided dynamic HUD React, Framer Motion 🟒 Active
Dual Database Engine Relational + document-based hybrid state MySQL, MongoDB 🟒 Active
Modular MVP Logic Decoupled architecture for rapid iteration Node.js, Express 🟒 Active
Real-Time Interaction Zero-latency environment transitions Vite, WebSockets 🟑 Beta
Spatial Narrative Flow Non-linear cinematic historical storytelling Custom Easing Algorithms 🟑 Beta

πŸ—οΈ SYSTEM ARCHITECTURE

graph TD
    %% Styling
    classDef frontend fill:#3b82f6,stroke:#1d4ed8,stroke-width:2px,color:#fff,rx:8px
    classDef backend fill:#10b981,stroke:#047857,stroke-width:2px,color:#fff,rx:8px
    classDef database fill:#f59e0b,stroke:#b45309,stroke-width:2px,color:#fff,rx:8px
    classDef ai fill:#8b5cf6,stroke:#6d28d9,stroke-width:2px,color:#fff,rx:8px
    classDef user fill:#333333,stroke:#000000,stroke-width:2px,color:#fff,rx:50px

    User((πŸ‘€ Traveler / XR Device)):::user
    
    subgraph Frontend [Client Layer: Cognitive UX]
        UI[βš›οΈ React 18 & Vite]:::frontend
        Geo[πŸ—ΊοΈ Leaflet Atlas]:::frontend
        XR[πŸ•ΆοΈ WebXR & Three.js]:::frontend
        UI --- Geo
        UI --- XR
    end

    subgraph API [Backend API Gateway]
        Gateway[πŸš€ Node.js / Express]:::backend
        Security[πŸ›‘οΈ JWT / RBAC]:::backend
        Router[πŸ›€οΈ TSP Optimize Engine]:::backend
        Gateway --- Security
        Gateway --- Router
    end

    subgraph Data [Hybrid Database Layer]
        MySQL[(🐬 MySQL<br/>Users & Bookings)]:::database
        Mongo[(πŸƒ MongoDB<br/>Spatial & Stories)]:::database
    end

    subgraph AI [Intelligence Layer]
        NLP[🧠 AI Persona Engine]:::ai
        Safety[⚠️ Safety Intelligence]:::ai
    end

    User == "HTTPS / WebSocket" ==> UI
    UI == "REST API" ==> Gateway
    Gateway ==> AI
    Gateway == "ACID Transactions" ==> MySQL
    Gateway == "GeoSpatial Queries" ==> Mongo
    AI -. "Generative Narratives" .-> Mongo
Loading
  1. Client / Neural UX Layer: Built on React and Vite, delivering hyper-glass aesthetics and utilizing WebXR/React Three Fiber for deep spatial rendering.
  2. API & Orchestration: A robust Node.js/Express backend that acts as the routing brain, seamlessly handling fallback syncing and load distribution.
  3. Dual Persistence Layer:
    • MySQL: Ensures rigid ACID compliance for critical state (users, payments, structured geography).
    • MongoDB: Provides flexible, high-throughput document storage for AI-generated stories, spatial interactions, and unstructured feedback.

🧬 EXPERIENCE DESIGN PHILOSOPHY

Our interface is designed to disappear.

Traditional web applications rely on declarative menus and pagination, interrupting context. Tejasvin employs Cognitive Flow: the UI reconstructs itself based on where the user's attention is focused.

  • Weightless Navigation: Custom cubic-bezier animations (0.2, 0, 0, 1) create frictionless transitions.
  • Spatial Immersion: Elements possess digital depth, casting accurate shadows and responding to micro-interactions.
  • Minimal Cognitive Load: Information is progressively disclosed, ensuring the narrative remains the focal point, not the tool.

πŸ“‚ REPOSITORY STRUCTURE

Folder Purpose
hidden-heritage-mvp/ Main Minimum Viable Product application core
frontend/ Presentation layer (Neural UX, React, WebXR components)
backend/ Application programming interface & orchestration services
legacy/ Experimental architecture patterns and early prototypes

βš™οΈ TECH STACK

πŸ–₯️ Frontend

  • Core: React 18, Vite
  • Spatial/3D: Three.js, React Three Fiber, WebXR Device API
  • Motion: Framer Motion

βš™οΈ Backend

  • Runtime: Node.js
  • Framework: Express.js

πŸ—„οΈ Databases

  • Relational: MySQL 8.0
  • NoSQL Environment: MongoDB 6.0

🧠 Design Philosophy

  • Cognitive UX
  • Spatial Interfaces
  • Hyper-glass Material Systems

⚑ QUICK START

git clone https://github.com/suvendukungfu/Tejasvin.git
cd Tejasvin/hidden-heritage-mvp
npm install

# Run presentation layer (Terminal 1)
cd frontend
npm run dev

# Run orchestration API (Terminal 2)
cd ../backend
npm run dev

Note: Required database structures must be initialized prior to API spin-up.


πŸ§ͺ EXPERIMENTAL RESEARCH NOTES

  • Exp. 01 [Neural UX]: Observed a 40% reduction in bounce rate when replacing standard navbar with an attention-dissolving HUD. Users report "feeling" the interface rather than reading it.
  • Exp. 02 [Spatial Cognition]: Integrating 1:1 scale AR artifacts significantly improves recall of historical contextual data compared to 2D image galleries.
  • Exp. 03 [Future Integration]: Exploring the integration of real-time AI narrative engines to generate dynamic, user-specific historical tours based on gaze-tracking inside WebXR.

πŸ† IMPACT & USE CASES

  • πŸ›οΈ Education & Museums: Upgrading static museum exhibits into interactive, globally accessible spatial archives.
  • πŸ’Ύ Digital Heritage Preservation: Creating an immutable, immersive record of endangered architectural sites before environmental degradation.
  • πŸŽ“ Spatial Learning Platforms: Proving that cognitive interfaces drastically accelerate learning in complex historical subjects.
  • πŸ₯½ AR/VR Research: Serving as a production-grade benchmark for WebXR capabilities in browser-based environments.

🌐 LIVE DEMO

Experience Hidden Heritage


πŸ“ˆ FUTURE ROADMAP

  • Phase 1: Global Rollout of the Immersive Artifact Viewer
  • Phase 2: AI-Driven Storytelling Engine (Dynamic Narrative Generation)
  • Phase 3: VisionOS & Meta Quest Native AR Heritage Navigation
  • Phase 4: Advanced Spatial Analytics Dashboard for Educators
  • Phase 5: Multi-user XR Collaboration Protocol (Guided Virtual Tours)

🀝 CONTRIBUTING

We build for the preservation of memory. We welcome spatial designers, WebGL engineers, and historians to contribute.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/SpatialEnhancement)
  3. Commit your Changes (git commit -m 'feat: Add volumetric rendering')
  4. Push to the Branch (git push origin feature/SpatialEnhancement)
  5. Open a Pull Request

πŸ‘¨β€πŸ’» AUTHOR

Suvendu Kumar Sahoo
Full-Stack Developer | Spatial Computing Explorer | Cognitive Interface Designer
GitHub


πŸͺͺ LICENSE

Distributed under the MIT License. See LICENSE for more information.

About

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages