How aalorro/boxters works
Boxters is a browser-based hex word puzzle. The player traces adjacent tiles to submit words; the game applies mode rules and objectives, scores the level, and saves progress locally with optional Firebase leaderboard and profile sync. The graph preserves the five modes, board sharing, profile transfer, and presentation/audio capabilities described in the README. Some connections rely on README or source-index references because relevant main.js sections were not excerpted; those excerpts do not establish every runtime call.
Main entry points: main.js Game controller · levels.js Level generation · renderer.js Canvas renderer · hex.js Hex geometry
Components 20
Game flow
- Game controller
js/main.js - Pointer input
js/input.js - Word tracing
js/tracer.js
Board and rules
- Board state
js/board.js - Level generation
js/levels.js - Hex geometry
js/hex.js - Word dictionary
js/dictionary.js - Board word list
js/common-words.js - Mode objectives
js/objectives.js - Scoring and stars
js/scoring.js - Modes and settings
js/constants.js
Player experience
- Canvas renderer
js/renderer.js - Visual effects
js/particles.js - Sound effects
js/audio.js
Progress and services
- Browser storage
- Leaderboard and sync
js/firebase.js - Firebase Firestore
- Shared board link
js/main.js - Profile transfer
js/main.js
Other components
- Player
Connections 25
- Player → Pointer input: traces tiles
README.md - Pointer input → Game controller: emits gestures
js/input.js - Game controller → Word tracing: manages tracing
js/main.js - Game controller → Level generation: loads levels
js/main.js - Level generation → Board state: builds boards
js/levels.js - Level generation → Hex geometry: uses coordinates
js/levels.js - Level generation → Word dictionary: checks solvability
js/levels.js - Level generation → Board word list: uses word list
js/levels.js - Board state → Hex geometry: uses neighbors
js/board.js - Game controller → Mode objectives: tracks objectives
js/main.js - Game controller → Scoring and stars: calculates scores
js/main.js - Game controller → Canvas renderer: updates display
js/main.js - Canvas renderer → Hex geometry: maps board cells
js/renderer.js - Game controller → Visual effects: triggers effects
js/main.js - Game controller → Sound effects: plays sounds
js/main.js - Canvas renderer → Modes and settings: uses visual settings
js/renderer.js - Visual effects → Modes and settings: uses colors
js/particles.js - Game controller → Modes and settings: uses game states
js/main.js - Game controller → Browser storage: persists progress
README.md - Game controller → Leaderboard and sync: syncs profile
js/main.js - Leaderboard and sync → Firebase Firestore: reads and writes
js/firebase.js - Game controller → Shared board link: creates shared boards
README.md - Player → Shared board link: shares board
README.md - Game controller → Profile transfer: exports and imports
README.md - Player → Profile transfer: transfers progress
README.md