# versobit/weatherdoge architecture

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

- Interactive diagram: https://gitdiagram.com/versobit/weatherdoge
- Repository: https://github.com/versobit/weatherdoge

## Overview

Weather Doge is an Android weather app with a customizable home-screen widget. The main workflow is to obtain a fixed or device location, fetch weather data, cache it, and present animated conditions; the widget has a parallel background refresh path. Settings configure units, location and presentation, while build flavors select location providers. The README also documents multiple weather sources and snowfall. These latter capabilities are retained, but their internal links are limited where source was not sampled.

Main entry points: [`WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java) (Weather screen), [`WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java`](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java) (Widget worker), [`WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherUtil.java`](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherUtil.java) (Weather sources), [`LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java`](https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java) (Particle system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Weather experience"]
  node_main["Weather screen<br/>[MainActivity.java]"]
  node_options["Preferences"]
  node_units["Unit locale<br/>[UnitLocale.java]"]
  node_appstate["App state<br/>[WeatherDoge.java]"]
end

subgraph group_location["Location services"]
  node_locationapi["Location API<br/>[DogeLocationApi.kt]"]
  node_locationreceiver["Location receiver"]
  node_apistatus["API status<br/>[ApiStatus.kt]"]
  node_provider["FOSS provider"]
  node_playprovider["Play provider"]
  node_selector["Provider selector"]
end

subgraph group_weather["Weather data"]
  node_weatherutil["Weather sources<br/>[WeatherUtil.java]"]
  node_cache[("Weather cache<br/>[Cache.java]")]
  node_weatherapi(("Weather services"))
end

subgraph group_widget["Widget refresh"]
  node_widgetprovider["Widget provider"]
  node_refreshreceiver["Refresh receiver"]
  node_worker["Widget worker<br/>[WidgetWorker.java]"]
end

subgraph group_particles["Particle effects"]
  node_particlesystem["Particle system"]
  node_particle["Particle motion<br/>[Particle.java]"]
  node_initializer["Particle initializers"]
  node_modifier["Particle modifiers"]
end

node_user(("App user"))

node_user -->|"opens"| node_main
node_main -->|"selects provider"| node_selector
node_selector -->|"returns provider"| node_provider
node_main -->|"configures"| node_locationapi
node_main -->|"requests weather"| node_weatherutil
node_main -->|"reads cache"| node_cache
node_main -->|"opens settings"| node_options
node_main -->|"formats units"| node_units
node_options -->|"configures source"| node_weatherutil
node_locationapi -->|"reports location"| node_locationreceiver
node_locationapi -->|"exposes status"| node_apistatus
node_provider -->|"delivers updates"| node_locationreceiver
node_playprovider -->|"delivers updates"| node_locationreceiver
node_weatherutil -->|"fetches forecasts"| node_weatherapi
node_weatherutil -.->|"stores results"| node_cache
node_user -.->|"views widget"| node_widgetprovider
node_widgetprovider -.->|"requests refresh"| node_refreshreceiver
node_refreshreceiver -->|"enqueues work"| node_worker
node_worker -->|"selects provider"| node_selector
node_worker -->|"configures"| node_locationapi
node_worker -->|"reads cache"| node_cache
node_worker -->|"fetches weather"| node_weatherutil
node_main -->|"emits snowfall"| node_particlesystem
node_particlesystem -->|"updates particles"| node_particle
node_particlesystem -->|"initializes particles"| node_initializer
node_particlesystem -->|"configures effects"| node_modifier
node_particle -->|"applies modifiers"| node_modifier

click node_main "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java"
click node_options "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/OptionsActivity.java"
click node_units "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/UnitLocale.java"
click node_appstate "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherDoge.java"
click node_locationapi "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/location/DogeLocationApi.kt"
click node_locationreceiver "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/location/LocationReceiver.kt"
click node_apistatus "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/location/ApiStatus.kt"
click node_provider "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/AndroidLocationApi.java"
click node_playprovider "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/play/java/com/versobit/weatherdoge/location/GoogleLocationApi.java"
click node_selector "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/FlavoredApiSelector.java"
click node_weatherutil "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherUtil.java"
click node_cache "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/Cache.java"
click node_widgetprovider "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetProvider.java"
click node_refreshreceiver "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetRefreshReceiver.kt"
click node_worker "https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java"
click node_particlesystem "https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java"
click node_particle "https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/Particle.java"
click node_initializer "https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/initializers/ParticleInitializer.java"
click node_modifier "https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/modifiers/ParticleModifier.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_options,node_units,node_appstate,node_user toneBlue
class node_locationapi,node_locationreceiver,node_apistatus,node_provider,node_playprovider,node_selector toneAmber
class node_weatherutil,node_cache,node_weatherapi toneMint
class node_widgetprovider,node_refreshreceiver,node_worker toneRose
class node_particlesystem,node_particle,node_initializer,node_modifier toneIndigo
```

## Components

### Weather experience

- [Weather screen](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`
- [Preferences](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/OptionsActivity.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/OptionsActivity.java`
- [Unit locale](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/UnitLocale.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/UnitLocale.java`
- [App state](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherDoge.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherDoge.java`

### Location services

- [Location API](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/location/DogeLocationApi.kt): `WeatherDoge/src/main/java/com/versobit/weatherdoge/location/DogeLocationApi.kt`
- [Location receiver](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/location/LocationReceiver.kt): `WeatherDoge/src/main/java/com/versobit/weatherdoge/location/LocationReceiver.kt`
- [API status](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/location/ApiStatus.kt): `WeatherDoge/src/main/java/com/versobit/weatherdoge/location/ApiStatus.kt`
- [FOSS provider](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/AndroidLocationApi.java): `WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/AndroidLocationApi.java`
- [Play provider](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/play/java/com/versobit/weatherdoge/location/GoogleLocationApi.java): `WeatherDoge/src/play/java/com/versobit/weatherdoge/location/GoogleLocationApi.java`
- [Provider selector](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/FlavoredApiSelector.java): `WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/FlavoredApiSelector.java`

### Weather data

- [Weather sources](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherUtil.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherUtil.java`
- [Weather cache](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/Cache.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/Cache.java`
- **Weather services**

### Widget refresh

- [Widget provider](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetProvider.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetProvider.java`
- [Refresh receiver](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetRefreshReceiver.kt): `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetRefreshReceiver.kt`
- [Widget worker](https://github.com/versobit/weatherdoge/blob/master/WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java): `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java`

### Particle effects

- [Particle system](https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java): `LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java`
- [Particle motion](https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/Particle.java): `LeonidsLib/src/main/java/com/plattysoft/leonids/Particle.java`
- [Particle initializers](https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/initializers/ParticleInitializer.java): `LeonidsLib/src/main/java/com/plattysoft/leonids/initializers/ParticleInitializer.java`
- [Particle modifiers](https://github.com/versobit/weatherdoge/blob/master/LeonidsLib/src/main/java/com/plattysoft/leonids/modifiers/ParticleModifier.java): `LeonidsLib/src/main/java/com/plattysoft/leonids/modifiers/ParticleModifier.java`

### Other components

- **App user**

## Connections

- App user → Weather screen: opens (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Weather screen → Provider selector: selects provider (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Provider selector → FOSS provider: returns provider (evidence: `WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/FlavoredApiSelector.java`)
- Weather screen → Location API: configures (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Weather screen → Weather sources: requests weather (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Weather screen → Weather cache: reads cache (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Weather screen → Preferences: opens settings (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Weather screen → Unit locale: formats units (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Preferences → Weather sources: configures source (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/OptionsActivity.java`)
- Location API → Location receiver: reports location (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/location/DogeLocationApi.kt`)
- Location API → API status: exposes status (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/location/DogeLocationApi.kt`)
- FOSS provider → Location receiver: delivers updates (evidence: `WeatherDoge/src/foss/java/com/versobit/weatherdoge/location/AndroidLocationApi.java`)
- Play provider → Location receiver: delivers updates (evidence: `WeatherDoge/src/play/java/com/versobit/weatherdoge/location/GoogleLocationApi.java`)
- Weather sources → Weather services: fetches forecasts (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/WeatherUtil.java`)
- Weather sources → Weather cache: stores results (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/Cache.java`)
- App user → Widget provider: views widget (evidence: `README.md`)
- Widget provider → Refresh receiver: requests refresh
- Refresh receiver → Widget worker: enqueues work (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java`)
- Widget worker → Provider selector: selects provider (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java`)
- Widget worker → Location API: configures (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java`)
- Widget worker → Weather cache: reads cache (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java`)
- Widget worker → Weather sources: fetches weather (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/WidgetWorker.java`)
- Weather screen → Particle system: emits snowfall (evidence: `WeatherDoge/src/main/java/com/versobit/weatherdoge/MainActivity.java`)
- Particle system → Particle motion: updates particles (evidence: `LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java`)
- Particle system → Particle initializers: initializes particles (evidence: `LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java`)
- Particle system → Particle modifiers: configures effects (evidence: `LeonidsLib/src/main/java/com/plattysoft/leonids/ParticleSystem.java`)
- Particle motion → Particle modifiers: applies modifiers (evidence: `LeonidsLib/src/main/java/com/plattysoft/leonids/Particle.java`)
