# dakshshah1045/neon-garage architecture

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

- Interactive diagram: https://gitdiagram.com/dakshshah1045/neon-garage
- Repository: https://github.com/dakshshah1045/neon-garage

## Overview

Neon Garage replaces Chrome’s New Tab with an interactive car-garage dashboard. The user enters the page, selects and customizes a vehicle or environment, uses shortcuts, and sees live clock, weather, and telemetry-style effects; preferences and garage state persist locally. The excerpts show the main application handling storage, rendering, navigation, and customization, and calling the procedural sound manager. README-described features such as diagnostics and hidden vehicles are retained, but their precise internal wiring is not established by the excerpts.

Main entry points: [`newtab/newtab.js`](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js) (Garage application), [`newtab/newtab.html`](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.html) (Garage dashboard), [`manifest.json`](https://github.com/dakshshah1045/neon-garage/blob/main/manifest.json) (New Tab override), [`newtab/sounds.js`](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/sounds.js) (Sound engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Garage experience"]
  node_manifest["New Tab override<br/>[manifest.json]"]
  node_dashboard["Garage dashboard<br/>[newtab.html]"]
  node_styles["Visual effects<br/>[newtab.css]"]
  node_effects["Weather and time<br/>[newtab.js]"]
  node_telemetry["HUD and diagnostics<br/>[newtab.html]"]
end

subgraph group_interaction["User controls"]
  node_customization["Vehicle customization<br/>[newtab.js]"]
  node_garage["Garage collection<br/>[newtab.js]"]
  node_environments["Environment selection<br/>[newtab.js]"]
  node_shortcuts["Quick links<br/>[newtab.js]"]
  node_navigation["Shortcut navigation<br/>[newtab.js]"]
end

subgraph group_runtime["Runtime services"]
  node_app["Garage application<br/>[newtab.js]"]
  node_storage[("Saved preferences<br/>[newtab.js]")]
  node_sound["Sound engine<br/>[sounds.js]"]
end

subgraph group_assets["Visual assets"]
  node_cars["Vehicle catalog<br/>[catalog.js]"]
end

node_user(("New Tab user"))
node_chrome[("Chrome storage")]
node_browser(("Browser destination"))

node_user -->|"opens new tab"| node_manifest
node_manifest -.->|"overrides with"| node_dashboard
node_dashboard -.->|"loads interface"| node_app
node_dashboard -.->|"uses styles"| node_styles
node_app -->|"loads and saves"| node_storage
node_storage -->|"reads and writes"| node_chrome
node_app -->|"handles controls"| node_customization
node_app -->|"selects vehicles"| node_garage
node_app -.->|"uses catalog"| node_cars
node_app -.->|"updates setting"| node_environments
node_app -->|"updates display"| node_effects
node_app -.->|"renders dashboard"| node_telemetry
node_app -->|"manages links"| node_shortcuts
node_shortcuts -->|"starts navigation"| node_navigation
node_navigation -.->|"redirects to"| node_browser
node_app -->|"plays effects"| node_sound
node_sound -->|"sets ambience"| node_environments

click node_manifest "https://github.com/dakshshah1045/neon-garage/blob/main/manifest.json"
click node_dashboard "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.html"
click node_styles "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.css"
click node_app "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_cars "https://github.com/dakshshah1045/neon-garage/blob/main/assets/cars/catalog.js"
click node_customization "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_garage "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_environments "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_effects "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_telemetry "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.html"
click node_shortcuts "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_navigation "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_storage "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js"
click node_sound "https://github.com/dakshshah1045/neon-garage/blob/main/newtab/sounds.js"

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_manifest,node_dashboard,node_styles,node_effects,node_telemetry,node_user,node_browser toneBlue
class node_customization,node_garage,node_environments,node_shortcuts,node_navigation,node_chrome toneAmber
class node_app,node_storage,node_sound toneMint
class node_cars toneRose
```

## Components

### Garage experience

- [New Tab override](https://github.com/dakshshah1045/neon-garage/blob/main/manifest.json): `manifest.json`
- [Garage dashboard](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.html): `newtab/newtab.html`
- [Visual effects](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.css): `newtab/newtab.css`
- [Weather and time](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`
- [HUD and diagnostics](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.html): `newtab/newtab.html`

### User controls

- [Vehicle customization](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`
- [Garage collection](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`
- [Environment selection](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`
- [Quick links](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`
- [Shortcut navigation](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`

### Runtime services

- [Garage application](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`
- [Saved preferences](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/newtab.js): `newtab/newtab.js`
- [Sound engine](https://github.com/dakshshah1045/neon-garage/blob/main/newtab/sounds.js): `newtab/sounds.js`

### Visual assets

- [Vehicle catalog](https://github.com/dakshshah1045/neon-garage/blob/main/assets/cars/catalog.js): `assets/cars/catalog.js`

### Other components

- **New Tab user**
- **Chrome storage**
- **Browser destination**

## Connections

- New Tab user → New Tab override: opens new tab (evidence: `README.md`)
- New Tab override → Garage dashboard: overrides with (evidence: `README.md`)
- Garage dashboard → Garage application: loads interface
- Garage dashboard → Visual effects: uses styles
- Garage application → Saved preferences: loads and saves (evidence: `newtab/newtab.js`)
- Saved preferences → Chrome storage: reads and writes (evidence: `newtab/newtab.js`)
- Garage application → Vehicle customization: handles controls (evidence: `newtab/newtab.js`)
- Garage application → Garage collection: selects vehicles (evidence: `newtab/newtab.js`)
- Garage application → Vehicle catalog: uses catalog
- Garage application → Environment selection: updates setting (evidence: `newtab/newtab.js`)
- Garage application → Weather and time: updates display (evidence: `newtab/newtab.js`)
- Garage application → HUD and diagnostics: renders dashboard (evidence: `README.md`)
- Garage application → Quick links: manages links (evidence: `newtab/newtab.js`)
- Quick links → Shortcut navigation: starts navigation (evidence: `newtab/newtab.js`)
- Shortcut navigation → Browser destination: redirects to (evidence: `newtab/newtab.js`)
- Garage application → Sound engine: plays effects (evidence: `newtab/newtab.js`)
- Sound engine → Environment selection: sets ambience (evidence: `newtab/newtab.js`)
