# anyel1to/matrix-live-radar architecture

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

- Interactive diagram: https://gitdiagram.com/anyel1to/matrix-live-radar
- Repository: https://github.com/anyel1to/matrix-live-radar

## Overview

MATRIX LIVE RADAR is a client-side, single-file aircraft and weather map. The browser opens the app, which displays a dark base map, polls public ADS-B data for aircraft markers and details, and can show a RainViewer precipitation overlay. The README documents these capabilities and relationships; no source excerpts were available, so internal call ownership and finer implementation details cannot be verified.

Main entry points: [`index.html`](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html) (Live radar app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Radar application"]
  node_app["Live radar app<br/>[index.html]"]
  node_map["Dark map<br/>[index.html]"]
  node_refresh["Auto-refresh status<br/>[index.html]"]
end

subgraph group_aircraft["Aircraft tracking"]
  node_tracking["Aircraft tracking<br/>[index.html]"]
  node_adsb["adsb.lol feed"]
  node_markers["Aircraft markers<br/>[index.html]"]
  node_details["Aircraft detail panel<br/>[index.html]"]
end

subgraph group_weather["Weather radar"]
  node_weather["Weather overlay<br/>[index.html]"]
  node_rainviewer["RainViewer tiles"]
end

subgraph group_providers["External map services"]
  node_carto["CARTO Dark tiles"]
  node_osm["OpenStreetMap tiles"]
end

node_browser(("Browser user"))

node_browser -->|"opens"| node_app
node_app -->|"displays"| node_map
node_app -->|"runs"| node_tracking
node_app -->|"updates"| node_refresh
node_tracking -->|"polls every 8s"| node_adsb
node_tracking -->|"updates positions"| node_markers
node_markers -->|"selects plane"| node_details
node_app -->|"toggles"| node_weather
node_weather -->|"loads tiles"| node_rainviewer
node_map -->|"uses tiles"| node_carto
node_map -->|"uses tiles"| node_osm

click node_app "https://github.com/anyel1to/matrix-live-radar/blob/main/index.html"
click node_map "https://github.com/anyel1to/matrix-live-radar/blob/main/index.html"
click node_refresh "https://github.com/anyel1to/matrix-live-radar/blob/main/index.html"
click node_tracking "https://github.com/anyel1to/matrix-live-radar/blob/main/index.html"
click node_markers "https://github.com/anyel1to/matrix-live-radar/blob/main/index.html"
click node_details "https://github.com/anyel1to/matrix-live-radar/blob/main/index.html"
click node_weather "https://github.com/anyel1to/matrix-live-radar/blob/main/index.html"

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_app,node_map,node_refresh,node_browser toneBlue
class node_tracking,node_adsb,node_markers,node_details toneAmber
class node_weather,node_rainviewer toneMint
class node_carto,node_osm toneRose
```

## Components

### Radar application

- [Live radar app](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html): `index.html`
- [Dark map](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html): `index.html`
- [Auto-refresh status](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html): `index.html`

### Aircraft tracking

- [Aircraft tracking](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html): `index.html`
- **adsb.lol feed**
- [Aircraft markers](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html): `index.html`
- [Aircraft detail panel](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html): `index.html`

### Weather radar

- [Weather overlay](https://github.com/anyel1to/matrix-live-radar/blob/main/index.html): `index.html`
- **RainViewer tiles**

### External map services

- **CARTO Dark tiles**
- **OpenStreetMap tiles**

### Other components

- **Browser user**

## Connections

- Browser user → Live radar app: opens (evidence: `README.md`)
- Live radar app → Dark map: displays (evidence: `README.md`)
- Live radar app → Aircraft tracking: runs (evidence: `README.md`)
- Live radar app → Auto-refresh status: updates (evidence: `README.md`)
- Aircraft tracking → adsb.lol feed: polls every 8s (evidence: `README.md`)
- Aircraft tracking → Aircraft markers: updates positions (evidence: `README.md`)
- Aircraft markers → Aircraft detail panel: selects plane (evidence: `README.md`)
- Live radar app → Weather overlay: toggles (evidence: `README.md`)
- Weather overlay → RainViewer tiles: loads tiles (evidence: `README.md`)
- Dark map → CARTO Dark tiles: uses tiles (evidence: `README.md`)
- Dark map → OpenStreetMap tiles: uses tiles (evidence: `README.md`)