Alexander Whitestone cf9ffc6a06
Some checks failed
CI / validate (pull_request) Failing after 16s
CI / auto-merge (pull_request) Has been skipped
feat: floating bookshelves with merged PR spine labels (#264)
Adds two floating bookshelves to the Nexus 3D scene, each holding
books whose spines display merged PR numbers and titles. Books are
built from canvas textures via the Gitea API, with fallback data if
unreachable. Both shelves gently bob in the scene.

Refs #264

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-24 01:04:36 -04:00
2026-03-23 18:50:22 +00:00

◈ The Nexus — Timmy's Sovereign Home

A Three.js environment serving as Timmy's sovereign space — like Dr. Strange's Sanctum Sanctorum, existing outside time. The Nexus is the central hub from which all worlds are accessed through portals.

Features

  • Procedural Nebula Skybox — animated stars, twinkling, layered nebula clouds
  • Batcave Terminal — 5 holographic display panels arranged in an arc showing:
    • Nexus Command (system status, harness state, agent loops)
    • Dev Queue (live Gitea issue references)
    • Metrics (uptime, commits, CPU/MEM)
    • Thought Stream (Timmy's current thoughts)
    • Agent Status (all agent states)
  • Morrowind Portal — glowing torus with animated swirl shader, ready for world connection
  • Admin Chat (Timmy Terminal) — real-time message interface, ready for Hermes WebSocket
  • Nexus Core — floating crystalline icosahedron on pedestal
  • Ambient Environment — crystal formations, floating runestones, energy particles, atmospheric fog
  • WASD + Mouse Navigation — first-person exploration of the space
  • Post-Processing — Unreal Bloom + SMAA antialiasing

Architecture

the-nexus/
├── index.html    # Entry point with HUD overlay, chat panel, loading screen
├── style.css     # Nexus design system (dark space theme, holographic panels)
└── app.js        # Three.js scene, shaders, controls, game loop

Running Locally

npx serve . -l 3000
# Open http://localhost:3000

Roadmap

  • Wire chat to Hermes WebSocket (/api/world/ws)
  • Pull live data into terminal panels from Timmy's actual state
  • Portal walk-through interaction to load destination worlds
  • Timmy's avatar (lizard wizard body he designs himself)
  • Connect to AlexanderWhitestone.com as public entry point
  • Integrate existing Replit timmy-tower world code

Part of The Timmy Foundation

Description
Timmy's Sovereign Home — Three.js environment with Batcave terminal, portal architecture, and admin chat. The central hub from which all worlds are accessed.
Readme 29 MiB
Languages
Python 72.1%
JavaScript 15.1%
HTML 5.4%
Shell 4.2%
CSS 3%
Other 0.1%