# vamja-dev/hypercar-website architecture

> Architecture diagram of the GitHub repository vamja-dev/hypercar-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vamja-dev/hypercar-website
- Repository: https://github.com/vamja-dev/hypercar-website

## Overview

This is a browser-based exotic-car showcase with a separate 3D color customizer. The main journey is browsing brands, choosing a car, and exploring its specifications, sound, video, gallery, and 3D model; the customizer independently lets users choose a brand/model and change exterior paint color. The excerpts show the relevant UI logic and data fields, but not all page wiring; the README is empty, so uncertain links are omitted or marked unverified.

Main entry points: [`script.js`](https://github.com/vamja-dev/hypercar-website/blob/main/script.js) (Car Details), [`customizer.js`](https://github.com/vamja-dev/hypercar-website/blob/main/customizer.js) (Customizer Controls), [`index.html`](https://github.com/vamja-dev/hypercar-website/blob/main/index.html) (Showcase Page), [`customizer.html`](https://github.com/vamja-dev/hypercar-website/blob/main/customizer.html) (Customizer Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_showcase["Car Showcase"]
  node_showcase_page["Showcase Page<br/>[index.html]"]
  node_showcase_logic["Showcase Interactions<br/>[script.js]"]
  node_car_details["Car Details<br/>[script.js]"]
  node_spec_hud["Performance HUD<br/>[script.js]"]
  node_sound_player["Engine Sound Player<br/>[script.js]"]
  node_video_embed["Car Video Embed<br/>[script.js]"]
  node_gallery["Car Image Gallery<br/>[script.js]"]
  node_model_viewer["3D Model Viewer<br/>[script.js]"]
end

subgraph group_content["Car Content"]
  node_car_catalog["Brand and Car Data<br/>[data.js]"]
end

subgraph group_customizer["3D Customizer"]
  node_customizer_page["Customizer Page<br/>[customizer.html]"]
  node_customizer_logic["Customizer Controls<br/>[customizer.js]"]
end

subgraph group_assets["Media Assets"]
  node_model_assets["Car 3D Models"]
  node_sound_assets["Engine Audio Files"]
  node_image_assets["Car Images"]
  node_customizer_models["Selectable Models"]
end

node_visitor(("Visitor"))
node_external_video["YouTube"]

node_visitor -->|"opens"| node_showcase_page
node_showcase_page -.->|"hosts interactions"| node_showcase_logic
node_showcase_logic -.->|"reads catalog"| node_car_catalog
node_showcase_logic -->|"updates details"| node_car_details
node_car_details -->|"sets metrics"| node_spec_hud
node_car_details -->|"configures audio"| node_sound_player
node_sound_player -->|"plays sound"| node_sound_assets
node_car_details -->|"loads video"| node_video_embed
node_video_embed -->|"embeds video"| node_external_video
node_car_details -->|"renders gallery"| node_gallery
node_car_details -->|"loads model"| node_model_viewer
node_model_viewer -->|"loads 3D asset"| node_model_assets
node_visitor -->|"opens"| node_customizer_page
node_customizer_page -.->|"hosts controls"| node_customizer_logic
node_customizer_logic -->|"selects model"| node_customizer_models
node_customizer_logic -.->|"uses car images"| node_image_assets

click node_showcase_page "https://github.com/vamja-dev/hypercar-website/blob/main/index.html"
click node_showcase_logic "https://github.com/vamja-dev/hypercar-website/blob/main/script.js"
click node_car_catalog "https://github.com/vamja-dev/hypercar-website/blob/main/data.js"
click node_car_details "https://github.com/vamja-dev/hypercar-website/blob/main/script.js"
click node_spec_hud "https://github.com/vamja-dev/hypercar-website/blob/main/script.js"
click node_sound_player "https://github.com/vamja-dev/hypercar-website/blob/main/script.js"
click node_video_embed "https://github.com/vamja-dev/hypercar-website/blob/main/script.js"
click node_gallery "https://github.com/vamja-dev/hypercar-website/blob/main/script.js"
click node_model_viewer "https://github.com/vamja-dev/hypercar-website/blob/main/script.js"
click node_model_assets "https://github.com/vamja-dev/hypercar-website/tree/main/models"
click node_sound_assets "https://github.com/vamja-dev/hypercar-website/tree/main/mp3"
click node_image_assets "https://github.com/vamja-dev/hypercar-website/tree/main/pictures"
click node_customizer_page "https://github.com/vamja-dev/hypercar-website/blob/main/customizer.html"
click node_customizer_logic "https://github.com/vamja-dev/hypercar-website/blob/main/customizer.js"
click node_customizer_models "https://github.com/vamja-dev/hypercar-website/tree/main/models"

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_showcase_page,node_showcase_logic,node_car_details,node_spec_hud,node_sound_player,node_video_embed,node_gallery,node_model_viewer toneBlue
class node_car_catalog toneAmber
class node_customizer_page,node_customizer_logic toneMint
class node_model_assets,node_sound_assets,node_image_assets,node_customizer_models toneRose
class node_visitor,node_external_video toneIndigo
```

## Components

### Car Showcase

- [Showcase Page](https://github.com/vamja-dev/hypercar-website/blob/main/index.html): `index.html`
- [Showcase Interactions](https://github.com/vamja-dev/hypercar-website/blob/main/script.js): `script.js`
- [Car Details](https://github.com/vamja-dev/hypercar-website/blob/main/script.js): `script.js`
- [Performance HUD](https://github.com/vamja-dev/hypercar-website/blob/main/script.js): `script.js`
- [Engine Sound Player](https://github.com/vamja-dev/hypercar-website/blob/main/script.js): `script.js`
- [Car Video Embed](https://github.com/vamja-dev/hypercar-website/blob/main/script.js): `script.js`
- [Car Image Gallery](https://github.com/vamja-dev/hypercar-website/blob/main/script.js): `script.js`
- [3D Model Viewer](https://github.com/vamja-dev/hypercar-website/blob/main/script.js): `script.js`

### Car Content

- [Brand and Car Data](https://github.com/vamja-dev/hypercar-website/blob/main/data.js): `data.js`

### 3D Customizer

- [Customizer Page](https://github.com/vamja-dev/hypercar-website/blob/main/customizer.html): `customizer.html`
- [Customizer Controls](https://github.com/vamja-dev/hypercar-website/blob/main/customizer.js): `customizer.js`

### Media Assets

- [Car 3D Models](https://github.com/vamja-dev/hypercar-website/tree/main/models): `models`
- [Engine Audio Files](https://github.com/vamja-dev/hypercar-website/tree/main/mp3): `mp3`
- [Car Images](https://github.com/vamja-dev/hypercar-website/tree/main/pictures): `pictures`
- [Selectable Models](https://github.com/vamja-dev/hypercar-website/tree/main/models): `models`

### Other components

- **Visitor**
- **YouTube**

## Connections

- Visitor → Showcase Page: opens
- Showcase Page → Showcase Interactions: hosts interactions
- Showcase Interactions → Brand and Car Data: reads catalog
- Showcase Interactions → Car Details: updates details (evidence: `script.js`)
- Car Details → Performance HUD: sets metrics (evidence: `script.js`)
- Car Details → Engine Sound Player: configures audio (evidence: `script.js`)
- Engine Sound Player → Engine Audio Files: plays sound (evidence: `script.js`)
- Car Details → Car Video Embed: loads video (evidence: `script.js`)
- Car Video Embed → YouTube: embeds video (evidence: `script.js`)
- Car Details → Car Image Gallery: renders gallery (evidence: `script.js`)
- Car Details → 3D Model Viewer: loads model (evidence: `script.js`)
- 3D Model Viewer → Car 3D Models: loads 3D asset (evidence: `script.js`)
- Visitor → Customizer Page: opens
- Customizer Page → Customizer Controls: hosts controls
- Customizer Controls → Selectable Models: selects model (evidence: `customizer.js`)
- Customizer Controls → Car Images: uses car images
