# javierv578/verakartt architecture

> Architecture diagram of the GitHub repository javierv578/verakartt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/javierv578/verakartt
- Repository: https://github.com/javierv578/verakartt

## Overview

VERA KART is a browser-based 3D kart racer. The player selects a character and track seed, races against AI on a generated circuit, and sees lap, race, and results UI; online rooms add remote racers. The main loop is the runtime orchestrator, with dedicated modules for input, track and kart simulation, rendering effects, audio, HUD, and networking. The README is empty, so capabilities are taken from source comments and excerpts; links to unsampled modules are omitted where their callers are not evidenced.

Main entry points: [`js/main.js`](https://github.com/javierv578/verakartt/blob/main/js/main.js) (Game loop), [`service-worker.js`](https://github.com/javierv578/verakartt/blob/main/service-worker.js) (Offline cache), [`js/net.js`](https://github.com/javierv578/verakartt/blob/main/js/net.js) (Room networking), [`js/track.js`](https://github.com/javierv578/verakartt/blob/main/js/track.js) (Procedural track)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["Race runtime"]
  node_main["Game loop<br/>[main.js]"]
  node_controls["Controls<br/>[controls.js]"]
  node_kart["Kart physics<br/>[kart.js]"]
end

subgraph group_world["Generated world"]
  node_track["Procedural track<br/>[track.js]"]
  node_scenery["Track scenery<br/>[scenery.js]"]
  node_sky["Procedural sky<br/>[sky.js]"]
  node_kartmodel["Kart model<br/>[kart.glb]"]
  node_charactermodel["Character model<br/>[cangri.glb]"]
end

subgraph group_presentation["Race presentation"]
  node_hud["Race HUD<br/>[hud.js]"]
  node_effects["Particles<br/>[effects.js]"]
  node_audio["Sound effects<br/>[audio.js]"]
  node_styles["Game styles<br/>[style.css]"]
end

subgraph group_multiplayer["Online play"]
  node_net["Room networking<br/>[net.js]"]
  node_remote["Remote kart<br/>[kart.js]"]
end

subgraph group_offline["Offline delivery"]
  node_worker["Offline cache<br/>[service-worker.js]"]
  node_app["Game page<br/>[index.html]"]
end

node_player(("Player"))
node_socket(("Socket.io server"))

node_player -->|"starts race"| node_main
node_main -->|"reads input"| node_controls
node_main -->|"builds track"| node_track
node_main -->|"updates karts"| node_kart
node_main -->|"updates HUD"| node_hud
node_main -->|"emits particles"| node_effects
node_main -->|"controls audio"| node_audio
node_main -->|"checks rivals"| node_net
node_main -->|"creates scenery"| node_scenery
node_main -->|"creates sky"| node_sky
node_kart -->|"queries track"| node_track
node_scenery -->|"uses track"| node_track
node_net -->|"creates remote karts"| node_remote
node_net -->|"exchanges race state"| node_socket
node_main -->|"loads model"| node_kartmodel
node_main -->|"loads model"| node_charactermodel
node_worker -->|"caches page"| node_app
node_worker -->|"precaches styles"| node_styles
node_worker -->|"precaches scripts"| node_main
node_worker -->|"precaches scripts"| node_kart
node_worker -->|"precaches scripts"| node_track
node_worker -->|"precaches scripts"| node_controls
node_worker -->|"precaches scripts"| node_hud
node_worker -->|"precaches scripts"| node_sky
node_worker -->|"precaches scripts"| node_scenery
node_worker -->|"precaches scripts"| node_effects
node_worker -->|"precaches scripts"| node_audio
node_worker -->|"precaches scripts"| node_net

click node_main "https://github.com/javierv578/verakartt/blob/main/js/main.js"
click node_controls "https://github.com/javierv578/verakartt/blob/main/js/controls.js"
click node_kart "https://github.com/javierv578/verakartt/blob/main/js/kart.js"
click node_track "https://github.com/javierv578/verakartt/blob/main/js/track.js"
click node_scenery "https://github.com/javierv578/verakartt/blob/main/js/scenery.js"
click node_sky "https://github.com/javierv578/verakartt/blob/main/js/sky.js"
click node_hud "https://github.com/javierv578/verakartt/blob/main/js/hud.js"
click node_effects "https://github.com/javierv578/verakartt/blob/main/js/effects.js"
click node_audio "https://github.com/javierv578/verakartt/blob/main/js/audio.js"
click node_net "https://github.com/javierv578/verakartt/blob/main/js/net.js"
click node_remote "https://github.com/javierv578/verakartt/blob/main/js/kart.js"
click node_worker "https://github.com/javierv578/verakartt/blob/main/service-worker.js"
click node_app "https://github.com/javierv578/verakartt/blob/main/index.html"
click node_kartmodel "https://github.com/javierv578/verakartt/blob/main/kart.glb"
click node_charactermodel "https://github.com/javierv578/verakartt/blob/main/cangri.glb"
click node_styles "https://github.com/javierv578/verakartt/blob/main/css/style.css"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_controls,node_kart toneBlue
class node_track,node_scenery,node_sky,node_kartmodel,node_charactermodel toneAmber
class node_hud,node_effects,node_audio,node_styles,node_socket toneMint
class node_net,node_remote toneRose
class node_worker,node_app,node_player toneIndigo
```

## Components

### Race runtime

- [Game loop](https://github.com/javierv578/verakartt/blob/main/js/main.js): `js/main.js`
- [Controls](https://github.com/javierv578/verakartt/blob/main/js/controls.js): `js/controls.js`
- [Kart physics](https://github.com/javierv578/verakartt/blob/main/js/kart.js): `js/kart.js`

### Generated world

- [Procedural track](https://github.com/javierv578/verakartt/blob/main/js/track.js): `js/track.js`
- [Track scenery](https://github.com/javierv578/verakartt/blob/main/js/scenery.js): `js/scenery.js`
- [Procedural sky](https://github.com/javierv578/verakartt/blob/main/js/sky.js): `js/sky.js`
- [Kart model](https://github.com/javierv578/verakartt/blob/main/kart.glb): `kart.glb`
- [Character model](https://github.com/javierv578/verakartt/blob/main/cangri.glb): `cangri.glb`

### Race presentation

- [Race HUD](https://github.com/javierv578/verakartt/blob/main/js/hud.js): `js/hud.js`
- [Particles](https://github.com/javierv578/verakartt/blob/main/js/effects.js): `js/effects.js`
- [Sound effects](https://github.com/javierv578/verakartt/blob/main/js/audio.js): `js/audio.js`
- [Game styles](https://github.com/javierv578/verakartt/blob/main/css/style.css): `css/style.css`

### Online play

- [Room networking](https://github.com/javierv578/verakartt/blob/main/js/net.js): `js/net.js`
- [Remote kart](https://github.com/javierv578/verakartt/blob/main/js/kart.js): `js/kart.js`

### Offline delivery

- [Offline cache](https://github.com/javierv578/verakartt/blob/main/service-worker.js): `service-worker.js`
- [Game page](https://github.com/javierv578/verakartt/blob/main/index.html): `index.html`

### Other components

- **Player**
- **Socket.io server**

## Connections

- Player → Game loop: starts race (evidence: `js/main.js`)
- Game loop → Controls: reads input (evidence: `js/main.js`)
- Game loop → Procedural track: builds track (evidence: `js/main.js`)
- Game loop → Kart physics: updates karts (evidence: `js/main.js`)
- Game loop → Race HUD: updates HUD (evidence: `js/main.js`)
- Game loop → Particles: emits particles (evidence: `js/main.js`)
- Game loop → Sound effects: controls audio (evidence: `js/main.js`)
- Game loop → Room networking: checks rivals (evidence: `js/main.js`)
- Game loop → Track scenery: creates scenery (evidence: `js/main.js`)
- Game loop → Procedural sky: creates sky (evidence: `js/main.js`)
- Kart physics → Procedural track: queries track (evidence: `js/kart.js`)
- Track scenery → Procedural track: uses track (evidence: `js/scenery.js`)
- Room networking → Remote kart: creates remote karts (evidence: `js/net.js`)
- Room networking → Socket.io server: exchanges race state (evidence: `js/net.js`)
- Game loop → Kart model: loads model (evidence: `js/main.js`)
- Game loop → Character model: loads model (evidence: `js/main.js`)
- Offline cache → Game page: caches page (evidence: `service-worker.js`)
- Offline cache → Game styles: precaches styles (evidence: `service-worker.js`)
- Offline cache → Game loop: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Kart physics: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Procedural track: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Controls: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Race HUD: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Procedural sky: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Track scenery: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Particles: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Sound effects: precaches scripts (evidence: `service-worker.js`)
- Offline cache → Room networking: precaches scripts (evidence: `service-worker.js`)
