# exuupery/island architecture

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

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

## Overview

Island is a Windows desktop overlay: users interact with a compact, always-on-top pill that expands into tools and controls, while status events appear as transient cards. The README documents substantial capabilities but the supplied tree contains no application source, so component paths and internal call relationships cannot be established. The graph therefore maps documented product areas, not implementation modules; its edges are limited to relationships described in the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_overlay["Overlay experience"]
  node_island["Island overlay"]
  node_live_status["Live status"]
  node_event_cards["Event cards"]
  node_characters["Animated characters"]
end

subgraph group_workspace["Panel workspace"]
  node_clipboard["Clipboard history"]
  node_shelf["File shelf"]
  node_text_tools["Text tools"]
  node_ai_chat["AI chat"]
  node_command_bar["Command bar"]
  node_notes_reminders["Notes and reminders"]
end

subgraph group_system["System features"]
  node_controls["System controls"]
  node_capture_tools["Capture and OCR"]
  node_preferences["Appearance settings"]
end

subgraph group_integrations["Integrations"]
  node_weather["Weather forecast"]
  node_met_norway["MET Norway"]
  node_windows["Windows services"]
  node_ai_service["AI service"]
end

node_user(("Windows user"))

node_user -->|"interacts with"| node_island
node_island -->|"shows activity"| node_live_status
node_island -->|"shows events"| node_event_cards
node_user -->|"opens tools"| node_clipboard
node_user -->|"drops files"| node_shelf
node_user -->|"uses tools"| node_text_tools
node_user -->|"asks questions"| node_ai_chat
node_user -->|"opens commands"| node_command_bar
node_user -->|"creates reminders"| node_notes_reminders
node_user -->|"changes settings"| node_controls
node_user -->|"captures screen"| node_capture_tools
node_user -->|"adjusts appearance"| node_preferences
node_user -->|"views forecast"| node_weather
node_weather -->|"gets forecast"| node_met_norway
node_controls -->|"controls devices"| node_windows
node_capture_tools -->|"uses recognition"| node_windows
node_ai_chat -.->|"uses AI"| node_ai_service
node_text_tools -.->|"requests AI actions"| node_ai_service
node_island -->|"offers character view"| node_characters

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_island,node_live_status,node_event_cards,node_characters,node_user toneBlue
class node_clipboard,node_shelf,node_text_tools,node_ai_chat,node_command_bar,node_notes_reminders toneAmber
class node_controls,node_capture_tools,node_preferences toneMint
class node_weather,node_met_norway,node_windows,node_ai_service toneRose
```

## Components

### Overlay experience

- **Island overlay**
- **Live status**
- **Event cards**
- **Animated characters**

### Panel workspace

- **Clipboard history**
- **File shelf**
- **Text tools**
- **AI chat**
- **Command bar**
- **Notes and reminders**

### System features

- **System controls**
- **Capture and OCR**
- **Appearance settings**

### Integrations

- **Weather forecast**
- **MET Norway**
- **Windows services**
- **AI service**

### Other components

- **Windows user**

## Connections

- Windows user → Island overlay: interacts with (evidence: `README.md`)
- Island overlay → Live status: shows activity (evidence: `README.md`)
- Island overlay → Event cards: shows events (evidence: `README.md`)
- Windows user → Clipboard history: opens tools (evidence: `README.md`)
- Windows user → File shelf: drops files (evidence: `README.md`)
- Windows user → Text tools: uses tools (evidence: `README.md`)
- Windows user → AI chat: asks questions (evidence: `README.md`)
- Windows user → Command bar: opens commands (evidence: `README.md`)
- Windows user → Notes and reminders: creates reminders (evidence: `README.md`)
- Windows user → System controls: changes settings (evidence: `README.md`)
- Windows user → Capture and OCR: captures screen (evidence: `README.md`)
- Windows user → Appearance settings: adjusts appearance (evidence: `README.md`)
- Windows user → Weather forecast: views forecast (evidence: `README.md`)
- Weather forecast → MET Norway: gets forecast (evidence: `README.md`)
- System controls → Windows services: controls devices (evidence: `README.md`)
- Capture and OCR → Windows services: uses recognition (evidence: `README.md`)
- AI chat → AI service: uses AI
- Text tools → AI service: requests AI actions
- Island overlay → Animated characters: offers character view (evidence: `README.md`)