# aninosez/isaac-spindown architecture

> Architecture diagram of the GitHub repository aninosez/isaac-spindown, 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/aninosez/isaac-spindown
- Repository: https://github.com/aninosez/isaac-spindown

## Overview

Isaac’s Items Spindown is a browser-based calculator: users search by item name or ID, select an item, then step down or back through the item-ID chain and view upcoming items and the next Quality 4 result. The sampled app excerpt shows the chain logic, search, rendering, and dice controls; the README documents the page and pedestal, and the item dataset. Icons use an external item-image CDN. The graph omits the data-refresh script because it is maintenance tooling, not runtime product behavior.

Main entry points: [`items.js`](https://github.com/aninosez/isaac-spindown/blob/main/items.js) (Item data), [`app.js`](https://github.com/aninosez/isaac-spindown/blob/main/app.js) (Pedestal rendering), [`index.html`](https://github.com/aninosez/isaac-spindown/blob/main/index.html) (Web page), [`style.css`](https://github.com/aninosez/isaac-spindown/blob/main/style.css) (Page styling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Item interaction"]
  node_app["App and controls<br/>[app.js]"]
  node_search["Item search<br/>[app.js]"]
  node_selection["Item selection<br/>[app.js]"]
  node_dice["Dice controls<br/>[app.js]"]
  node_render["Pedestal rendering<br/>[app.js]"]
end

subgraph group_calculation["Spindown results"]
  node_chain["Spindown chain<br/>[app.js]"]
  node_spinback["Spin-back chain<br/>[app.js]"]
  node_q4["Quality 4 lookup<br/>[app.js]"]
  node_upcoming["Upcoming items<br/>[app.js]"]
end

subgraph group_assets["Page and data"]
  node_page["Web page<br/>[index.html]"]
  node_styles["Page styling<br/>[style.css]"]
  node_itemdata[("Item data<br/>[items.js]")]
end

node_user(("Player"))
node_cdn["Item icon CDN"]

node_user -->|"opens"| node_page
node_page -->|"runs"| node_app
node_page -.->|"styles"| node_styles
node_app -->|"reads"| node_itemdata
node_user -->|"enters query"| node_search
node_search -->|"searches"| node_itemdata
node_search -->|"selects match"| node_selection
node_user -->|"selects item"| node_selection
node_selection -->|"updates view"| node_render
node_user -->|"clicks dice"| node_dice
node_dice -->|"rolls down"| node_chain
node_dice -->|"rolls back"| node_spinback
node_chain -->|"checks IDs"| node_itemdata
node_spinback -->|"checks IDs"| node_itemdata
node_render -->|"finds next"| node_q4
node_q4 -->|"reads quality"| node_itemdata
node_render -->|"shows chain"| node_upcoming
node_upcoming -->|"gets next items"| node_chain
node_render -->|"loads icons"| node_cdn

click node_page "https://github.com/aninosez/isaac-spindown/blob/main/index.html"
click node_styles "https://github.com/aninosez/isaac-spindown/blob/main/style.css"
click node_app "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_search "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_selection "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_dice "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_chain "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_spinback "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_q4 "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_upcoming "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_render "https://github.com/aninosez/isaac-spindown/blob/main/app.js"
click node_itemdata "https://github.com/aninosez/isaac-spindown/blob/main/items.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_app,node_search,node_selection,node_dice,node_render toneBlue
class node_chain,node_spinback,node_q4,node_upcoming toneAmber
class node_page,node_styles,node_itemdata toneMint
class node_user,node_cdn toneIndigo
```

## Components

### Item interaction

- [App and controls](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`
- [Item search](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`
- [Item selection](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`
- [Dice controls](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`
- [Pedestal rendering](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`

### Spindown results

- [Spindown chain](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`
- [Spin-back chain](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`
- [Quality 4 lookup](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`
- [Upcoming items](https://github.com/aninosez/isaac-spindown/blob/main/app.js): `app.js`

### Page and data

- [Web page](https://github.com/aninosez/isaac-spindown/blob/main/index.html): `index.html`
- [Page styling](https://github.com/aninosez/isaac-spindown/blob/main/style.css): `style.css`
- [Item data](https://github.com/aninosez/isaac-spindown/blob/main/items.js): `items.js`

### Other components

- **Player**
- **Item icon CDN**

## Connections

- Player → Web page: opens (evidence: `README.md`)
- Web page → App and controls: runs (evidence: `README.md`)
- Web page → Page styling: styles
- App and controls → Item data: reads (evidence: `app.js`)
- Player → Item search: enters query (evidence: `README.md`)
- Item search → Item data: searches (evidence: `app.js`)
- Item search → Item selection: selects match (evidence: `app.js`)
- Player → Item selection: selects item (evidence: `README.md`)
- Item selection → Pedestal rendering: updates view (evidence: `app.js`)
- Player → Dice controls: clicks dice (evidence: `README.md`)
- Dice controls → Spindown chain: rolls down (evidence: `app.js`)
- Dice controls → Spin-back chain: rolls back (evidence: `app.js`)
- Spindown chain → Item data: checks IDs (evidence: `app.js`)
- Spin-back chain → Item data: checks IDs (evidence: `app.js`)
- Pedestal rendering → Quality 4 lookup: finds next (evidence: `app.js`)
- Quality 4 lookup → Item data: reads quality (evidence: `app.js`)
- Pedestal rendering → Upcoming items: shows chain (evidence: `app.js`)
- Upcoming items → Spindown chain: gets next items (evidence: `app.js`)
- Pedestal rendering → Item icon CDN: loads icons (evidence: `app.js`)
