# ynater/dynamic-island-ynater architecture

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

- Interactive diagram: https://gitdiagram.com/ynater/dynamic-island-ynater
- Repository: https://github.com/ynater/dynamic-island-ynater

## Overview

Ynater is a Windows desktop Dynamic Island widget. Users interact with its always-on-top island to view system and online information, manage notes and clipboard history, and adjust convenience settings. Electron’s main process provides desktop integration and handles selected network requests; the interface and much of its feature logic live in HTML/JavaScript. The excerpts show some IPC handlers and UI behavior, but not the current index.html or the complete runtime wiring, so unverified connections are omitted or marked dashed.

Main entry points: [`main.js`](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js) (Electron main), [`index.html`](https://github.com/ynater/dynamic-island-ynater/blob/main/index.html) (Island UI), [`renderer.js`](https://github.com/ynater/dynamic-island-ynater/blob/main/renderer.js) (Visual effects), [`colors.js`](https://github.com/ynater/dynamic-island-ynater/blob/main/colors.js) (Themes and skins)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop runtime"]
  node_main["Electron main<br/>[main.js]"]
  node_preload["Preload bridge<br/>[preload.js]"]
end

subgraph group_interface["Island interface"]
  node_island_ui["Island UI<br/>[index.html]"]
  node_visuals["Visual effects<br/>[renderer.js]"]
  node_appearance["Themes and skins<br/>[colors.js]"]
  node_system["System monitor<br/>[main.js]"]
end

subgraph group_productivity["Productivity tools"]
  node_notes["Notes and goals<br/>[colors.js]"]
  node_clipboard["Clipboard history<br/>[main.js]"]
  node_convenience["Convenience controls<br/>[main.js]"]
end

subgraph group_services["Online services"]
  node_weather["Weather and geocoding<br/>[main.js]"]
  node_finance["Market rates<br/>[main.js]"]
  node_translation["Text translation<br/>[main.js]"]
end

node_user(("Windows user"))
node_open_meteo(("Open-Meteo"))
node_market_apis(("Rate providers"))
node_translation_api(("MyMemory API"))

node_user -.->|"uses"| node_island_ui
node_island_ui -.->|"manages"| node_notes
node_island_ui -.->|"searches and pins"| node_clipboard
node_island_ui -.->|"customizes"| node_appearance
node_island_ui -.->|"controls"| node_convenience
node_main -->|"tracks and sends"| node_clipboard
node_main -->|"handles requests"| node_weather
node_main -->|"requests data"| node_open_meteo
node_main -->|"fetches rates"| node_finance
node_main -->|"requests prices"| node_market_apis
node_main -->|"handles requests"| node_translation
node_main -->|"requests translation"| node_translation_api
node_island_ui -.->|"requests weather"| node_weather
node_island_ui -.->|"requests translation"| node_translation
node_user -.->|"views monitoring"| node_system
node_user -.->|"interacts"| node_visuals

click node_main "https://github.com/ynater/dynamic-island-ynater/blob/main/main.js"
click node_preload "https://github.com/ynater/dynamic-island-ynater/blob/main/preload.js"
click node_island_ui "https://github.com/ynater/dynamic-island-ynater/blob/main/index.html"
click node_visuals "https://github.com/ynater/dynamic-island-ynater/blob/main/renderer.js"
click node_appearance "https://github.com/ynater/dynamic-island-ynater/blob/main/colors.js"
click node_system "https://github.com/ynater/dynamic-island-ynater/blob/main/main.js"
click node_notes "https://github.com/ynater/dynamic-island-ynater/blob/main/colors.js"
click node_clipboard "https://github.com/ynater/dynamic-island-ynater/blob/main/main.js"
click node_convenience "https://github.com/ynater/dynamic-island-ynater/blob/main/main.js"
click node_weather "https://github.com/ynater/dynamic-island-ynater/blob/main/main.js"
click node_finance "https://github.com/ynater/dynamic-island-ynater/blob/main/main.js"
click node_translation "https://github.com/ynater/dynamic-island-ynater/blob/main/main.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_main,node_preload,node_user toneBlue
class node_island_ui,node_visuals,node_appearance,node_system toneAmber
class node_notes,node_clipboard,node_convenience,node_translation_api toneMint
class node_weather,node_finance,node_translation toneRose
class node_open_meteo,node_market_apis toneIndigo
```

## Components

### Desktop runtime

- [Electron main](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js): `main.js`
- [Preload bridge](https://github.com/ynater/dynamic-island-ynater/blob/main/preload.js): `preload.js`

### Island interface

- [Island UI](https://github.com/ynater/dynamic-island-ynater/blob/main/index.html): `index.html`
- [Visual effects](https://github.com/ynater/dynamic-island-ynater/blob/main/renderer.js): `renderer.js`
- [Themes and skins](https://github.com/ynater/dynamic-island-ynater/blob/main/colors.js): `colors.js`
- [System monitor](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js): `main.js`

### Productivity tools

- [Notes and goals](https://github.com/ynater/dynamic-island-ynater/blob/main/colors.js): `colors.js`
- [Clipboard history](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js): `main.js`
- [Convenience controls](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js): `main.js`

### Online services

- [Weather and geocoding](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js): `main.js`
- [Market rates](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js): `main.js`
- [Text translation](https://github.com/ynater/dynamic-island-ynater/blob/main/main.js): `main.js`

### Other components

- **Windows user**
- **Open-Meteo**
- **Rate providers**
- **MyMemory API**

## Connections

- Windows user → Island UI: uses (evidence: `README.md`)
- Island UI → Notes and goals: manages (evidence: `README.md`)
- Island UI → Clipboard history: searches and pins (evidence: `README.md`)
- Island UI → Themes and skins: customizes (evidence: `README.md`)
- Island UI → Convenience controls: controls (evidence: `README.md`)
- Electron main → Clipboard history: tracks and sends (evidence: `main.js`)
- Electron main → Weather and geocoding: handles requests (evidence: `main.js`)
- Electron main → Open-Meteo: requests data (evidence: `main.js`)
- Electron main → Market rates: fetches rates (evidence: `main.js`)
- Electron main → Rate providers: requests prices (evidence: `main.js`)
- Electron main → Text translation: handles requests (evidence: `main.js`)
- Electron main → MyMemory API: requests translation (evidence: `main.js`)
- Island UI → Weather and geocoding: requests weather
- Island UI → Text translation: requests translation
- Windows user → System monitor: views monitoring (evidence: `README.md`)
- Windows user → Visual effects: interacts (evidence: `README.md`)
