How vungotuong/thianhiennguyen works
This is a browser-based, bilingual island-adventure game. The player starts or resumes a voyage, enters their name, visits islands, completes story and puzzle encounters, collects compass fragments, and progresses toward a final island and ending. A shared game store tracks progress and achievements and autosaves it. The tree also shows specialized 3D island scenes, a prediction challenge, and a waterfall experience. The README is only a Vite template; relationships for unsampled components are included only where the source index or excerpts support them.
Main entry points: GameShell.jsx Game shell · IslandPage.jsx Island encounter · useGame.js Game selectors · TitleScreen.jsx Title screen
Components 27
App flow
- Game shell
src/components/layout/GameShell.jsx - Title screen
src/pages/TitleScreen.jsx - Identity and greeting
src/pages/NameEntryPage.jsx - Identity check
src/pages/VerifyIdentityPage.jsx - World map
src/pages/WorldMapPage.jsx - Island encounter
src/pages/IslandPage.jsx - Final island page
src/pages/FinalIslandPage.jsx - Ending page
src/pages/EndingPage.jsx
Progress systems
- Game state
src/store/gameStore.js - Game selectors
src/hooks/useGame.js - Save system
src/utils/saveSystem.js - Island progression
src/utils/islandLogic.js - Achievement checks
src/utils/achievementEngine.js
Island experiences
- Island content
src/data/islands.js - Island 3D scenes
src/components/world3d - Prediction challenge
src/components/world3d/island4/Island4Scene.jsx - Prediction logic
src/utils/predictionEngine.js - Waterfall experience
src/components/waterfall/WaterfallExperience.jsx
Puzzles and rewards
- Puzzle engine
src/components/puzzle/PuzzleEngine.jsx - Puzzle types
src/components/puzzle/types - Story dialogue
src/components/dialog/DialogBox.jsx - Fragment reveal
src/components/inventory/FragmentRevealModal.jsx - Game content data
src/data
World presentation
- Shared interface
src/components/ui - Heads-up display
src/components/layout/HUD.jsx - Achievement toast
src/components/achievements/AchievementToast.jsx
Other components
- Player
Connections 34
- Player → Game shell: starts voyage
src/components/layout/GameShell.jsx - Game shell → Title screen: routes scene
src/components/layout/GameShell.jsx - Game shell → Identity and greeting: routes scene
src/components/layout/GameShell.jsx - Game shell → Identity check: routes scene
src/components/layout/GameShell.jsx - Game shell → World map: routes scene
src/components/layout/GameShell.jsx - Game shell → Island encounter: routes scene
src/components/layout/GameShell.jsx - Game shell → Final island page: routes scene
src/components/layout/GameShell.jsx - Game shell → Ending page: routes scene
src/components/layout/GameShell.jsx - Title screen → Game selectors: reads and updates
src/pages/TitleScreen.jsx - Title screen → Save system: loads save
src/pages/TitleScreen.jsx - Game shell → Game selectors: selects scene
src/components/layout/GameShell.jsx - Game selectors → Game state: selects state
src/hooks/useGame.js - Game selectors → Island content: reads island data
src/hooks/useGame.js - Game state → Island progression: derives unlocks
src/store/gameStore.js - Game state → Achievement checks: checks unlocks
src/store/gameStore.js - Game state → Save system: autosaves state
src/store/gameStore.js - Island encounter → Game selectors: reads progress
src/pages/IslandPage.jsx - Island encounter → Island content: selects island
- Island encounter → Story dialogue: renders dialogue
src/pages/IslandPage.jsx - Island encounter → Puzzle engine: renders puzzles
src/pages/IslandPage.jsx - Island encounter → Island 3D scenes: renders scenes
src/pages/IslandPage.jsx - Island encounter → Fragment reveal: reveals fragments
src/pages/IslandPage.jsx - Puzzle engine → Puzzle types: dispatches type
src/components/puzzle/PuzzleEngine.jsx - Puzzle engine → Game content data: reads registry
src/components/puzzle/PuzzleEngine.jsx - Island 3D scenes → Prediction challenge: includes challenge
src/components/world3d/island4/Island4Scene.jsx - Prediction challenge → Prediction logic: gets predictions
src/components/world3d/island4/Island4Scene.jsx - Prediction challenge → Game content data: reads prediction data
src/components/world3d/island4/Island4Scene.jsx - Game shell → Waterfall experience: renders experience
src/components/layout/GameShell.jsx - Game shell → Heads-up display: renders HUD
src/components/layout/GameShell.jsx - Game shell → Achievement toast: renders toast
src/components/layout/GameShell.jsx - Achievement toast → Game selectors: reads toast queue
- Fragment reveal → Game selectors: reads fragments
src/components/inventory/FragmentRevealModal.jsx - Puzzle engine → Shared interface: uses panel
src/components/puzzle/PuzzleEngine.jsx - Title screen → Shared interface: uses controls
src/pages/TitleScreen.jsx