# dpagett-cloud/tdf-micro-visions architecture

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

- Interactive diagram: https://gitdiagram.com/dpagett-cloud/tdf-micro-visions
- Repository: https://github.com/dpagett-cloud/tdf-micro-visions

## Overview

TDF Microvisions is a static browser-based hub for games, auxiliary tools, and a 21-track music collection. The principal user journey starts at the landing page, branches into a game or utility, or opens the music index to browse and play tracks; song details are available through a reusable page. The README documents these capabilities, but most page implementations were not sampled, so documented links are shown with README evidence rather than inferred internal calls.

Main entry points: [`index.html`](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/index.html) (Landing dashboard), [`music.html`](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/music.html) (Music index), [`song.html`](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/song.html) (Song detail page), [`ohms-law/index.html`](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/ohms-law/index.html) (Ohm's Law calculator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Hub and status"]
  node_home["Landing dashboard<br/>[index.html]"]
end

subgraph group_games["Games"]
  node_game_suite["Combat games<br/>[alien-bomber.html]"]
  node_city_bomber["City Bomber<br/>[city-bomber.html]"]
  node_go["Go<br/>[Go.html]"]
  node_arkanoid["Arkanoid<br/>[Arkanoid.html]"]
  node_snake["Snake<br/>[snake.html]"]
  node_pong["Pong<br/>[Qpong.html]"]
  node_tetris["Tetris<br/>[Tetris.html]"]
  node_davaxian["Davaxian<br/>[Davaxian.html]"]
  node_stop_clock["Stop The Clock"]
  node_davecraft["DaveCraft sandbox<br/>[davecraft.html]"]
  node_davecraft_manual["DaveCraft manual<br/>[readme.html]"]
end

subgraph group_utilities["Auxiliary tools"]
  node_heart["Heart model"]
  node_hourglass["Hourglass timer<br/>[hourglass.html]"]
  node_ohms["Ohm's Law calculator<br/>[index.html]"]
  node_ohms_logic["Calculation logic<br/>[script.js]"]
end

subgraph group_music["Music catalog"]
  node_music_index["Music index<br/>[music.html]"]
  node_song_page["Song detail page<br/>[song.html]"]
  node_catalog["Song catalog<br/>[songs-data.js]"]
  node_song_assets["Track assets"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_home -->|"links to"| node_game_suite
node_home -->|"links to"| node_city_bomber
node_home -->|"links to"| node_go
node_home -->|"links to"| node_arkanoid
node_home -->|"links to"| node_snake
node_home -->|"links to"| node_pong
node_home -->|"links to"| node_tetris
node_home -->|"links to"| node_davaxian
node_home -->|"links to"| node_stop_clock
node_home -->|"links to"| node_davecraft
node_home -->|"links to"| node_davecraft_manual
node_home -->|"links to"| node_heart
node_home -->|"links to"| node_hourglass
node_home -->|"links to"| node_ohms
node_ohms -->|"runs calculations"| node_ohms_logic
node_home -->|"links to"| node_music_index
node_visitor -->|"browses tracks"| node_music_index
node_music_index -->|"uses catalog"| node_catalog
node_music_index -->|"opens details"| node_song_page
node_song_page -->|"selects track data"| node_catalog
node_music_index -->|"plays audio"| node_song_assets
node_song_page -->|"shows media"| node_song_assets

click node_home "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/index.html"
click node_game_suite "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/alien-bomber.html"
click node_city_bomber "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/city-bomber.html"
click node_go "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Go.html"
click node_arkanoid "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Arkanoid.html"
click node_snake "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/snake.html"
click node_pong "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Qpong.html"
click node_tetris "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Tetris.html"
click node_davaxian "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Davaxian.html"
click node_stop_clock "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/stop-the-clock.html"
click node_davecraft "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/DaveCraft/davecraft.html"
click node_davecraft_manual "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/DaveCraft/readme.html"
click node_heart "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/3D%20Heart%20Simulation%20-%20Final.html"
click node_hourglass "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/hourglass.html"
click node_ohms "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/ohms-law/index.html"
click node_ohms_logic "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/ohms-law/script.js"
click node_music_index "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/music.html"
click node_song_page "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/song.html"
click node_catalog "https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/mySongs/songs-data.js"
click node_song_assets "https://github.com/dpagett-cloud/tdf-micro-visions/tree/main/mySongs"

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_home toneBlue
class node_game_suite,node_city_bomber,node_go,node_arkanoid,node_snake,node_pong,node_tetris,node_davaxian,node_stop_clock,node_davecraft,node_davecraft_manual toneAmber
class node_heart,node_hourglass,node_ohms,node_ohms_logic toneMint
class node_music_index,node_song_page,node_catalog,node_song_assets toneRose
class node_visitor toneIndigo
```

## Components

### Hub and status

- [Landing dashboard](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/index.html): `index.html`

### Games

- [Combat games](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/alien-bomber.html): `alien-bomber.html`
- [City Bomber](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/city-bomber.html): `city-bomber.html`
- [Go](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Go.html): `Go.html`
- [Arkanoid](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Arkanoid.html): `Arkanoid.html`
- [Snake](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/snake.html): `snake.html`
- [Pong](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Qpong.html): `Qpong.html`
- [Tetris](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Tetris.html): `Tetris.html`
- [Davaxian](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/Davaxian.html): `Davaxian.html`
- [Stop The Clock](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/stop-the-clock.html): `stop-the-clock.html`
- [DaveCraft sandbox](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/DaveCraft/davecraft.html): `DaveCraft/davecraft.html`
- [DaveCraft manual](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/DaveCraft/readme.html): `DaveCraft/readme.html`

### Auxiliary tools

- [Heart model](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/3D%20Heart%20Simulation%20-%20Final.html): `3D Heart Simulation - Final.html`
- [Hourglass timer](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/hourglass.html): `hourglass.html`
- [Ohm's Law calculator](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/ohms-law/index.html): `ohms-law/index.html`
- [Calculation logic](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/ohms-law/script.js): `ohms-law/script.js`

### Music catalog

- [Music index](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/music.html): `music.html`
- [Song detail page](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/song.html): `song.html`
- [Song catalog](https://github.com/dpagett-cloud/tdf-micro-visions/blob/main/mySongs/songs-data.js): `mySongs/songs-data.js`
- [Track assets](https://github.com/dpagett-cloud/tdf-micro-visions/tree/main/mySongs): `mySongs`

### Other components

- **Visitor**

## Connections

- Visitor → Landing dashboard: opens (evidence: `README.md`)
- Landing dashboard → Combat games: links to (evidence: `README.md`)
- Landing dashboard → City Bomber: links to (evidence: `README.md`)
- Landing dashboard → Go: links to (evidence: `README.md`)
- Landing dashboard → Arkanoid: links to (evidence: `README.md`)
- Landing dashboard → Snake: links to (evidence: `README.md`)
- Landing dashboard → Pong: links to (evidence: `README.md`)
- Landing dashboard → Tetris: links to (evidence: `README.md`)
- Landing dashboard → Davaxian: links to (evidence: `README.md`)
- Landing dashboard → Stop The Clock: links to (evidence: `README.md`)
- Landing dashboard → DaveCraft sandbox: links to (evidence: `README.md`)
- Landing dashboard → DaveCraft manual: links to (evidence: `README.md`)
- Landing dashboard → Heart model: links to (evidence: `README.md`)
- Landing dashboard → Hourglass timer: links to (evidence: `README.md`)
- Landing dashboard → Ohm's Law calculator: links to (evidence: `README.md`)
- Ohm's Law calculator → Calculation logic: runs calculations (evidence: `README.md`)
- Landing dashboard → Music index: links to (evidence: `README.md`)
- Visitor → Music index: browses tracks (evidence: `README.md`)
- Music index → Song catalog: uses catalog (evidence: `README.md`)
- Music index → Song detail page: opens details (evidence: `README.md`)
- Song detail page → Song catalog: selects track data (evidence: `README.md`)
- Music index → Track assets: plays audio (evidence: `README.md`)
- Song detail page → Track assets: shows media (evidence: `README.md`)
