How ahmed-kabeer-dev/reef-muncher works
Reef Muncher is a browser-based marine-themed game with accounts, habitat conditions, puzzle-driven runs, and player statistics. The main gameplay flow is the play page coordinating a run controller and canvas engine; the server prepares puzzle/condition data, checks bites, and records completed runs. Separate pages expose habitats, career stats, and leaderboard data. The excerpts and source index support the main internal calls, but do not show the client API’s endpoint wiring, so those connections are omitted.
Main entry points: page.js Play page · engine.js Canvas engine · puzzleManager.js Puzzle manager · conditions.js Habitat conditions
Components 27
Player experience
- Play page
app/play/page.js - Account pages
app/login/page.js - Habitats page
app/habitats/page.js - Career page
app/career/page.js - Leaderboard page
app/leaderboard/page.js - Client API
lib/client/api.js
Game runtime
- Run controller
lib/game/runController.js - Canvas engine
lib/game/engine.js - Hazards
lib/game/hazards.js - Game rules
lib/game/rules.js - Event bus
lib/events/eventBus.js - Game overlays
components/ResultOverlay.js
Server services
- Auth routes
app/api/auth - Run routes
app/api/run - Stats routes
app/api/leaderboard/route.js - Habitat route
app/api/habitats/route.js - Session auth
lib/server/auth.js - Puzzle manager
lib/server/puzzleManager.js - Run service
lib/server/runService.js - Habitat conditions
lib/server/conditions.js - Career statistics
lib/server/stats.js - SQLite store
lib/db/index.js
External data
- Fish puzzle API
lib/services/fishClient.js - Marine data API
lib/services/marineClient.js - Sunrise API
lib/services/sunClient.js - HTTP helpers
lib/services/http.js
Other components
- Player
Connections 36
- Player → Play page: plays
- Player → Account pages: manages account
- Play page → Run controller: coordinates
app/play/page.js - Play page → Canvas engine: controls
app/play/page.js - Play page → Client API: requests data
app/play/page.js - Play page → Game overlays: renders
app/play/page.js - Run controller → Canvas engine: starts run
lib/game/runController.js - Run controller → Event bus: publishes events
lib/game/runController.js - Run controller → Game rules: builds difficulty
lib/game/runController.js - Canvas engine → Hazards: delegates hazards
lib/game/engine.js - Canvas engine → Game rules: uses rules
lib/game/engine.js - Canvas engine → Event bus: publishes events
lib/game/engine.js - Auth routes → Session auth: authenticates
app/api/auth/login/route.js - Session auth → SQLite store: reads and writes sessions
lib/server/auth.js - Run routes → Session auth: authenticates
app/api/run/finish/route.js - Run routes → Puzzle manager: starts puzzles
app/api/run/start/route.js - Run routes → Run service: finishes runs
app/api/run/finish/route.js - Puzzle manager → Fish puzzle API: fetches puzzles
lib/server/puzzleManager.js - Puzzle manager → Habitat conditions: loads conditions
lib/server/puzzleManager.js - Puzzle manager → SQLite store: stores answers
lib/server/puzzleManager.js - Run service → SQLite store: saves results
lib/server/runService.js - Run service → Puzzle manager: releases run
lib/server/runService.js - Stats routes → Session auth: authenticates
app/api/leaderboard/route.js - Stats routes → Career statistics: builds rankings
app/api/leaderboard/route.js - Career page → Client API: requests career data
- Leaderboard page → Client API: requests rankings
- Habitats page → Client API: requests habitats
app/habitats/page.js - Habitat route → Session auth: authenticates
app/api/habitats/route.js - Habitat route → Habitat conditions: loads conditions
app/api/habitats/route.js - Habitat conditions → Marine data API: fetches sea data
lib/server/conditions.js - Habitat conditions → Sunrise API: fetches sun data
lib/server/conditions.js - Habitat conditions → Game rules: classifies conditions
lib/server/conditions.js - Career statistics → SQLite store: reads run history
lib/server/stats.js - Fish puzzle API → HTTP helpers: fetches responses
lib/services/fishClient.js - Marine data API → HTTP helpers: fetches responses
lib/services/marineClient.js - Sunrise API → HTTP helpers: fetches responses
lib/services/sunClient.js