How ravin06/astra-f1 works
APEX / Grand Circuit is a local, single-player browser racing game. The player selects a circuit and race setup, configures a car or driver, then drives using keyboard, gamepad, or touch controls. The race runtime simulates the player and AI, validates laps, and records results; graphics, HUD, and synthesized audio present the session. Garage settings, presets, and progress persist in browser storage. README capabilities include multiple race modes, weather, replay, customization, and records. The graph follows the sampled runtime wiring; unsampled feature details are represented by their known implementing modules where supported.
Main entry points: main.js Game Coordinator · data.js Game Catalog · race.js Race Session · graphics.js 3D Renderer
Components 15
Player Experience
- Game Coordinator
src/main.js - Menus and HUD
src/ui.js - Control Input
src/input.js - Synthesized Audio
src/audio.js
Race Runtime
- Race Session
src/race.js - Driving and AI Physics
src/physics.js
Circuits and Presentation
- Track Geometry
src/track.js - Circuit Layouts
src/circuits.js - 3D Renderer
src/graphics.js - Formula Car Models
src/formula-car.js - Circuit Scenery
src/circuit-scenery.js
Profile and Saves
- Game Catalog
src/data.js - Profile and Presets
src/persistence.js - Browser Storage
Other components
- Player
Connections 21
- Player → Menus and HUD: uses menus
README.md - Menus and HUD → Game Coordinator: dispatches actions
src/ui.js - Game Coordinator → Control Input: reads controls
src/main.js - Game Coordinator → Race Session: starts and updates
src/main.js - Game Coordinator → 3D Renderer: builds and renders
src/main.js - Game Coordinator → Synthesized Audio: plays cues
src/main.js - Game Coordinator → Menus and HUD: updates display
src/main.js - Game Coordinator → Profile and Presets: loads and saves
src/main.js - Game Coordinator → Track Geometry: selects circuit
src/main.js - Game Coordinator → Game Catalog: reads configuration
src/main.js - Race Session → Driving and AI Physics: steps karts
src/race.js - Race Session → Track Geometry: queries track
src/race.js - Race Session → Game Catalog: uses vehicle stats
src/race.js - Driving and AI Physics → Track Geometry: samples surface
src/physics.js - Game Catalog → Circuit Layouts: exports layouts
src/data.js - 3D Renderer → Formula Car Models: creates car models
src/graphics.js - 3D Renderer → Circuit Scenery: adds scenery
src/graphics.js - 3D Renderer → Game Catalog: reads vehicles
src/graphics.js - Menus and HUD → Game Catalog: reads catalog
src/ui.js - Profile and Presets → Game Catalog: sanitizes profile
src/persistence.js - Profile and Presets → Browser Storage: reads and writes
src/persistence.js