# apinanaivot/ikea-3d-model-download-button architecture

> Architecture diagram of the GitHub repository apinanaivot/ikea-3d-model-download-button, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/apinanaivot/ikea-3d-model-download-button
- Repository: https://github.com/apinanaivot/ikea-3d-model-download-button

## Overview

This Tampermonkey userscript adds a localized download control to IKEA product pages, finds the 3D model URL, then fetches and saves the GLB using product details for its filename. The main flow is page setup → button discovery → URL selection or capture → download. It also supports manual button selection and observes dynamically loaded page content. The map is based on the README and the single indexed source file; these components therefore share that implementation path.

Main entry points: [`ikea-3d-model-downloader.user.js`](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js) (URL selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_page_ui["Page UI"]
  node_page_setup["Page setup"]
  node_button_discovery["Button discovery"]
  node_localized_button["Localized button"]
  node_manual_mode["Manual recovery"]
end

subgraph group_model_access["Model Access"]
  node_url_capture["URL capture"]
  node_viewer_scan["Viewer scan"]
  node_url_selection["URL selection"]
end

subgraph group_download["Download"]
  node_model_fetch["GLB fetch"]
  node_filename["Filename builder"]
  node_browser_save["Browser save"]
end

node_shopper(("Shopper"))
node_ikea_page["IKEA product page"]
node_model_host["Model host"]
node_browser["Browser"]

node_shopper -->|"opens"| node_ikea_page
node_ikea_page -->|"runs script"| node_page_setup
node_page_setup -->|"starts discovery"| node_button_discovery
node_page_setup -->|"installs observers"| node_url_capture
node_button_discovery -->|"creates button"| node_localized_button
node_ikea_page -->|"exposes viewer"| node_viewer_scan
node_shopper -->|"clicks"| node_localized_button
node_shopper -->|"requests recovery"| node_manual_mode
node_manual_mode -->|"sets up button"| node_localized_button
node_localized_button -->|"requests download"| node_url_selection
node_url_selection -->|"checks captured URLs"| node_url_capture
node_url_selection -->|"checks viewers"| node_viewer_scan
node_url_selection -->|"fetches selected URL"| node_model_fetch
node_url_selection -->|"triggers model view"| node_browser_save
node_model_fetch -->|"requests model"| node_model_host
node_model_fetch -->|"passes blob"| node_filename
node_ikea_page -->|"provides title"| node_filename
node_filename -->|"sets download name"| node_browser_save
node_browser_save -->|"downloads file"| node_browser

click node_page_setup "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_button_discovery "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_localized_button "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_manual_mode "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_url_capture "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_viewer_scan "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_url_selection "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_model_fetch "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_filename "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js"
click node_browser_save "https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.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_page_setup,node_button_discovery,node_localized_button,node_manual_mode,node_browser toneBlue
class node_url_capture,node_viewer_scan,node_url_selection toneAmber
class node_model_fetch,node_filename,node_browser_save toneMint
class node_shopper,node_ikea_page,node_model_host toneIndigo
```

## Components

### Page UI

- [Page setup](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`
- [Button discovery](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`
- [Localized button](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`
- [Manual recovery](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`

### Model Access

- [URL capture](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`
- [Viewer scan](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`
- [URL selection](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`

### Download

- [GLB fetch](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`
- [Filename builder](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`
- [Browser save](https://github.com/apinanaivot/ikea-3d-model-download-button/blob/main/ikea-3d-model-downloader.user.js): `ikea-3d-model-downloader.user.js`

### Other components

- **Shopper**
- **IKEA product page**
- **Model host**
- **Browser**

## Connections

- Shopper → IKEA product page: opens (evidence: `README.md`)
- IKEA product page → Page setup: runs script (evidence: `ikea-3d-model-downloader.user.js`)
- Page setup → Button discovery: starts discovery (evidence: `ikea-3d-model-downloader.user.js`)
- Page setup → URL capture: installs observers (evidence: `ikea-3d-model-downloader.user.js`)
- Button discovery → Localized button: creates button (evidence: `ikea-3d-model-downloader.user.js`)
- IKEA product page → Viewer scan: exposes viewer (evidence: `ikea-3d-model-downloader.user.js`)
- Shopper → Localized button: clicks (evidence: `README.md`)
- Shopper → Manual recovery: requests recovery (evidence: `ikea-3d-model-downloader.user.js`)
- Manual recovery → Localized button: sets up button (evidence: `ikea-3d-model-downloader.user.js`)
- Localized button → URL selection: requests download (evidence: `ikea-3d-model-downloader.user.js`)
- URL selection → URL capture: checks captured URLs (evidence: `ikea-3d-model-downloader.user.js`)
- URL selection → Viewer scan: checks viewers (evidence: `ikea-3d-model-downloader.user.js`)
- URL selection → GLB fetch: fetches selected URL (evidence: `ikea-3d-model-downloader.user.js`)
- URL selection → Browser save: triggers model view (evidence: `ikea-3d-model-downloader.user.js`)
- GLB fetch → Model host: requests model (evidence: `ikea-3d-model-downloader.user.js`)
- GLB fetch → Filename builder: passes blob (evidence: `ikea-3d-model-downloader.user.js`)
- IKEA product page → Filename builder: provides title (evidence: `ikea-3d-model-downloader.user.js`)
- Filename builder → Browser save: sets download name (evidence: `ikea-3d-model-downloader.user.js`)
- Browser save → Browser: downloads file (evidence: `ikea-3d-model-downloader.user.js`)
