Echo Solaris

Exploration narrative IA dans le système Solaris — sept mondes, une Anomalie.

Echo Solaris est une expérience narrative en React 18 + Three.js (r128) où l'IA Claude génère le fil rouge unique de chaque partie. Inspiré par Outer Wilds.

Démarrage

npm install
npm run dev          # http://localhost:5173
npm run storybook    # http://localhost:6006 — composants HUD en isolation

Build

npm run build              # build standard (Vite SPA dans dist/)
npm run build:standalone   # bundle ESM unique pour index-v-2.2.8.html

Architecture

src/
├── EchoSolaris.jsx      # Composant racine — orchestrateur
├── constants/           # PHYSICS, PLANET_DATA, PLANET_OBJECTS_MAP
├── hooks/               # useThreeScene, useKeyboard, ...
├── three/               # Géométries (ship, terrain, starfield, physique)
├── audio/               # Web Audio API (drones, sons d'impact)
├── narrative/           # API Claude (callClaude, fallbacks)
├── views/               # Vues (intro, suit, ship, system, planet, location)
├── hud/                 # HUD purs (Storybook-ready)
├── ui/                  # Effets visuels (IntroStarfield)
└── utils/               # debug logger, seededRandom, animateLerp

Debug

Active les logs structurés :

URL : ?debug=true&loglevel=trace&logcat=input,physics
Console : window.__echoDebug.enable()
          window.__echoDebug.setLevel('trace')
          window.__echoDebug.setCats(['input','physics'])

Catégories : init · three · physics · input · narrative · audio · view

Commandes en jeu

• Vue combinaison : W A S D déplacement, R/F haut/bas, SPACE jetpack, SHIFT boost
• Vue vaisseau : W S avant/arrière, A D latéral, Q E roulis, SPACE boost, SHIFT frein
• E entrer/sortir vaisseau · M carte système · D Discovery Map · J Journal · ESC sortir

Versions

Voir CHANGELOG.md.

License

MIT — voir LICENSE.