# coloredrunes/8bitweather architecture

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

- Interactive diagram: https://gitdiagram.com/coloredrunes/8bitweather
- Repository: https://github.com/coloredrunes/8bitweather

## Overview

8 Bit Weather is a JavaFX desktop weather app. A user enters a city in the main menu; the app polls for weather, turns results into drawing state, and displays animated current and forecast conditions in a compact window. The graph also captures app startup, tray support, and the documented window controls. Source excerpts and the source index support the main wiring; weather-service request details and some UI behavior were not sampled, so those links are omitted where unverified.

Main entry points: [`src/engine/App.java`](https://github.com/coloredrunes/8bitweather/blob/master/src/engine/App.java) (App runtime), [`src/weather/WeatherPoller.java`](https://github.com/coloredrunes/8bitweather/blob/master/src/weather/WeatherPoller.java) (Weather poller), [`src/mainmenu/MainMenuController.java`](https://github.com/coloredrunes/8bitweather/blob/master/src/mainmenu/MainMenuController.java) (City menu), [`src/animator/weatheranimator/AnimationHandler.java`](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/AnimationHandler.java) (Animation handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App lifecycle"]
  node_main["Java launcher<br/>[Main.java]"]
  node_app_runtime["App runtime<br/>[App.java]"]
  node_context["Shared context"]
  node_tray["System tray<br/>[SystemFxTray.java]"]
end

subgraph group_weather["Weather data"]
  node_poller["Weather poller<br/>[WeatherPoller.java]"]
  node_client["Weather client<br/>[WeatherClient.java]"]
  node_data["Weather data<br/>[WeatherData.java]"]
end

subgraph group_presentation["Weather display"]
  node_menu["City menu"]
  node_weather_window["Weather window"]
  node_dashboard["Dashboard controller"]
  node_canvas["Weather canvas"]
end

subgraph group_animation["Animation runtime"]
  node_draw_state["Drawing state"]
  node_anim_handler["Animation handler"]
  node_anim_content["Animation frames<br/>[ContentsAnim.java]"]
  node_menu_anim["Menu animation"]
end

node_user(("User"))
node_weather_api{{"Weather service"}}
node_version_service{{"Version endpoint"}}

node_user -->|"enters city"| node_menu
node_main -->|"launches"| node_app_runtime
node_app_runtime -->|"starts"| node_tray
node_app_runtime -->|"creates"| node_context
node_app_runtime -->|"creates"| node_weather_window
node_app_runtime -->|"creates"| node_menu
node_app_runtime -->|"creates"| node_poller
node_app_runtime -->|"checks version"| node_version_service
node_menu -->|"starts polling"| node_poller
node_menu -->|"starts display"| node_weather_window
node_menu -->|"creates"| node_menu_anim
node_weather_window -->|"creates"| node_dashboard
node_dashboard -->|"starts views"| node_canvas
node_poller -->|"fetches data"| node_client
node_poller -->|"builds states"| node_draw_state
node_poller -->|"receives results"| node_data
node_poller -->|"updates animation"| node_anim_handler
node_client -->|"returns data"| node_data
node_draw_state -->|"interprets conditions"| node_data
node_canvas -->|"uses handler"| node_anim_handler
node_canvas -->|"renders state"| node_draw_state
node_anim_handler -->|"advances frames"| node_anim_content
node_anim_handler -->|"selects effects"| node_draw_state

click node_main "https://github.com/coloredrunes/8bitweather/blob/master/src/Main.java"
click node_app_runtime "https://github.com/coloredrunes/8bitweather/blob/master/src/engine/App.java"
click node_context "https://github.com/coloredrunes/8bitweather/blob/master/src/engine/ApplicationContext.java"
click node_tray "https://github.com/coloredrunes/8bitweather/blob/master/src/engine/SystemFxTray.java"
click node_menu "https://github.com/coloredrunes/8bitweather/blob/master/src/mainmenu/MainMenuController.java"
click node_weather_window "https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherWindowController.java"
click node_dashboard "https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherDashboardController.java"
click node_canvas "https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherCanvasView.java"
click node_poller "https://github.com/coloredrunes/8bitweather/blob/master/src/weather/WeatherPoller.java"
click node_client "https://github.com/coloredrunes/8bitweather/blob/master/src/weather/WeatherClient.java"
click node_data "https://github.com/coloredrunes/8bitweather/blob/master/src/weather/WeatherData.java"
click node_draw_state "https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherDrawingState.java"
click node_anim_handler "https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/AnimationHandler.java"
click node_anim_content "https://github.com/coloredrunes/8bitweather/blob/master/src/animator/ContentsAnim.java"
click node_menu_anim "https://github.com/coloredrunes/8bitweather/blob/master/src/animator/mainmenu/AnimationConveyor.java"

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_app_runtime,node_context,node_tray,node_user toneBlue
class node_poller,node_client,node_data toneAmber
class node_menu,node_weather_window,node_dashboard,node_canvas toneMint
class node_draw_state,node_anim_handler,node_anim_content,node_menu_anim toneRose
class node_weather_api,node_version_service toneIndigo
```

## Components

### App lifecycle

- [Java launcher](https://github.com/coloredrunes/8bitweather/blob/master/src/Main.java): `src/Main.java`
- [App runtime](https://github.com/coloredrunes/8bitweather/blob/master/src/engine/App.java): `src/engine/App.java`
- [Shared context](https://github.com/coloredrunes/8bitweather/blob/master/src/engine/ApplicationContext.java): `src/engine/ApplicationContext.java`
- [System tray](https://github.com/coloredrunes/8bitweather/blob/master/src/engine/SystemFxTray.java): `src/engine/SystemFxTray.java`

### Weather data

- [Weather poller](https://github.com/coloredrunes/8bitweather/blob/master/src/weather/WeatherPoller.java): `src/weather/WeatherPoller.java`
- [Weather client](https://github.com/coloredrunes/8bitweather/blob/master/src/weather/WeatherClient.java): `src/weather/WeatherClient.java`
- [Weather data](https://github.com/coloredrunes/8bitweather/blob/master/src/weather/WeatherData.java): `src/weather/WeatherData.java`

### Weather display

- [City menu](https://github.com/coloredrunes/8bitweather/blob/master/src/mainmenu/MainMenuController.java): `src/mainmenu/MainMenuController.java`
- [Weather window](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherWindowController.java): `src/animator/weatheranimator/WeatherWindowController.java`
- [Dashboard controller](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherDashboardController.java): `src/animator/weatheranimator/WeatherDashboardController.java`
- [Weather canvas](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherCanvasView.java): `src/animator/weatheranimator/WeatherCanvasView.java`

### Animation runtime

- [Drawing state](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/WeatherDrawingState.java): `src/animator/weatheranimator/WeatherDrawingState.java`
- [Animation handler](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/weatheranimator/AnimationHandler.java): `src/animator/weatheranimator/AnimationHandler.java`
- [Animation frames](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/ContentsAnim.java): `src/animator/ContentsAnim.java`
- [Menu animation](https://github.com/coloredrunes/8bitweather/blob/master/src/animator/mainmenu/AnimationConveyor.java): `src/animator/mainmenu/AnimationConveyor.java`

### Other components

- **User**
- **Weather service**
- **Version endpoint**

## Connections

- User → City menu: enters city (evidence: `src/mainmenu/MainMenuController.java`)
- Java launcher → App runtime: launches (evidence: `src/Main.java`)
- App runtime → System tray: starts (evidence: `src/engine/App.java`)
- App runtime → Shared context: creates (evidence: `src/engine/App.java`)
- App runtime → Weather window: creates (evidence: `src/engine/App.java`)
- App runtime → City menu: creates (evidence: `src/engine/App.java`)
- App runtime → Weather poller: creates (evidence: `src/engine/App.java`)
- App runtime → Version endpoint: checks version (evidence: `src/engine/App.java`)
- City menu → Weather poller: starts polling (evidence: `src/mainmenu/MainMenuController.java`)
- City menu → Weather window: starts display (evidence: `src/mainmenu/MainMenuController.java`)
- City menu → Menu animation: creates (evidence: `src/mainmenu/MainMenuController.java`)
- Weather window → Dashboard controller: creates (evidence: `src/animator/weatheranimator/WeatherWindowController.java`)
- Dashboard controller → Weather canvas: starts views (evidence: `src/animator/weatheranimator/WeatherDashboardController.java`)
- Weather poller → Weather client: fetches data (evidence: `src/weather/WeatherPoller.java`)
- Weather poller → Drawing state: builds states (evidence: `src/weather/WeatherPoller.java`)
- Weather poller → Weather data: receives results (evidence: `src/weather/WeatherPoller.java`)
- Weather poller → Animation handler: updates animation (evidence: `src/weather/WeatherPoller.java`)
- Weather client → Weather data: returns data (evidence: `src/weather/WeatherClient.java`)
- Drawing state → Weather data: interprets conditions (evidence: `src/animator/weatheranimator/WeatherDrawingState.java`)
- Weather canvas → Animation handler: uses handler (evidence: `src/animator/weatheranimator/WeatherCanvasView.java`)
- Weather canvas → Drawing state: renders state (evidence: `src/animator/weatheranimator/WeatherCanvasView.java`)
- Animation handler → Animation frames: advances frames (evidence: `src/animator/weatheranimator/AnimationHandler.java`)
- Animation handler → Drawing state: selects effects (evidence: `src/animator/weatheranimator/AnimationHandler.java`)
