# aleksandargonovski-git/cloudio-weather-app architecture

> Architecture diagram of the GitHub repository aleksandargonovski-git/cloudio-weather-app, 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/aleksandargonovski-git/cloudio-weather-app
- Repository: https://github.com/aleksandargonovski-git/cloudio-weather-app

## Overview

WeatherApp is an Android weather-forecasting app. Users can locate or search for a city, view weather and related forecasts, and manage saved cities and display preferences. The main screen is hosted by MainActivity, with WeatherViewModel coordinating weather data and UI state; background workers support weather alerts and scheduled morning briefings. The source index identifies the main components and several dependencies, but many modules were not excerpted, so unverified integrations and flows are left out or shown as unverified.

Main entry points: [`WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt) (Weather view model), [`WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt) (App entry), [`WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt`](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt) (Weather screens), [`WeatherApp/app/src/main/java/com/weather/app/data/WeatherPreferences.kt`](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/WeatherPreferences.kt) (App preferences)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and UI"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_screen["Weather screens<br/>[WeatherScreen.kt]"]
  node_viewmodel["Weather view model"]
  node_components["Forecast cards"]
  node_darksky["Dark Sky layout<br/>[DarkSkyLayout.kt]"]
  node_themes["Theme system<br/>[WeatherAppTheme.kt]"]
  node_sound["Sound effects"]
end

subgraph group_weather["Weather data"]
  node_weatherrepo["Weather providers"]
  node_weatherapi["OpenWeather client<br/>[OpenWeatherApi.kt]"]
  node_weatherapi_service["WeatherAPI client"]
  node_weatherapi_repo["WeatherAPI repository"]
  node_openmeteo["Open-Meteo repository"]
  node_tomorrow["Tomorrow repository"]
  node_geocoding["City geocoding"]
  node_localreport["Weather report"]
end

subgraph group_background["Background alerts"]
  node_notifications["Notification manager"]
  node_alertworker["Weather alert worker"]
  node_briefingworker["Morning briefing worker"]
end

subgraph group_state["User state and surfaces"]
  node_preferences[("App preferences")]
  node_favorites[("Saved cities")]
  node_tileorder[("Tile ordering")]
  node_widget["Weather widget<br/>[WeatherWidget.kt]"]
  node_widgetdata["Widget data"]
end

node_user(("Weather user"))
node_external_weather["External weather APIs<br/>external system"]

node_user -->|"opens app"| node_activity
node_activity -->|"creates"| node_viewmodel
node_activity -->|"hosts"| node_screen
node_activity -->|"applies"| node_themes
node_activity -->|"initializes"| node_notifications
node_activity -->|"syncs schedule"| node_alertworker
node_activity -->|"syncs schedule"| node_briefingworker
node_activity -->|"reads settings"| node_preferences
node_screen -.->|"receives state"| node_viewmodel
node_screen -->|"renders cards"| node_components
node_darksky -->|"uses icons"| node_components
node_viewmodel -->|"loads weather"| node_weatherrepo
node_viewmodel -->|"loads weather"| node_weatherapi_repo
node_viewmodel -->|"loads weather"| node_openmeteo
node_viewmodel -->|"loads weather"| node_tomorrow
node_viewmodel -->|"searches cities"| node_geocoding
node_viewmodel -->|"manages cities"| node_favorites
node_viewmodel -->|"reads settings"| node_preferences
node_viewmodel -->|"manages layout"| node_tileorder
node_viewmodel -->|"generates report"| node_localreport
node_viewmodel -->|"updates"| node_widget
node_weatherrepo -->|"uses client"| node_weatherapi
node_weatherapi_repo -->|"uses service"| node_weatherapi_service
node_openmeteo -.->|"requests forecasts"| node_external_weather
node_tomorrow -.->|"requests forecasts"| node_external_weather
node_alertworker -->|"reads settings"| node_preferences
node_alertworker -->|"sends alerts"| node_notifications
node_briefingworker -->|"reads settings"| node_preferences
node_briefingworker -->|"sends briefing"| node_notifications
node_widget -->|"uses data"| node_widgetdata
node_screen -->|"plays effects"| node_sound

click node_activity "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt"
click node_screen "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt"
click node_viewmodel "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt"
click node_components "https://github.com/aleksandargonovski-git/cloudio-weather-app/tree/main/WeatherApp/app/src/main/java/com/weather/app/ui/components"
click node_darksky "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/screens/DarkSkyLayout.kt"
click node_themes "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/theme/WeatherAppTheme.kt"
click node_weatherrepo "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherRepository.kt"
click node_weatherapi "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/api/OpenWeatherApi.kt"
click node_weatherapi_service "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/api/WeatherApiService.kt"
click node_weatherapi_repo "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherApiRepository.kt"
click node_openmeteo "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/OpenMeteoRepository.kt"
click node_tomorrow "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/TomorrowRepository.kt"
click node_geocoding "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/GeocodingRepository.kt"
click node_localreport "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/LocalWeatherReportGenerator.kt"
click node_preferences "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/WeatherPreferences.kt"
click node_favorites "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/FavoritesManager.kt"
click node_tileorder "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/TileOrderManager.kt"
click node_widget "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/widget/WeatherWidget.kt"
click node_widgetdata "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/widget/WeatherWidgetData.kt"
click node_notifications "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationManager.kt"
click node_alertworker "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationWorker.kt"
click node_briefingworker "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/MorningBriefingWorker.kt"
click node_sound "https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/WeatherSoundManager.kt"

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_activity,node_screen,node_viewmodel,node_components,node_darksky,node_themes,node_sound,node_user toneBlue
class node_weatherrepo,node_weatherapi,node_weatherapi_service,node_weatherapi_repo,node_openmeteo,node_tomorrow,node_geocoding,node_localreport toneAmber
class node_notifications,node_alertworker,node_briefingworker,node_external_weather toneMint
class node_preferences,node_favorites,node_tileorder,node_widget,node_widgetdata toneRose
```

## Components

### App and UI

- [App entry](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt): `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`
- [Weather screens](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt): `WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt`
- [Weather view model](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt): `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`
- [Forecast cards](https://github.com/aleksandargonovski-git/cloudio-weather-app/tree/main/WeatherApp/app/src/main/java/com/weather/app/ui/components): `WeatherApp/app/src/main/java/com/weather/app/ui/components`
- [Dark Sky layout](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/screens/DarkSkyLayout.kt): `WeatherApp/app/src/main/java/com/weather/app/ui/screens/DarkSkyLayout.kt`
- [Theme system](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/theme/WeatherAppTheme.kt): `WeatherApp/app/src/main/java/com/weather/app/ui/theme/WeatherAppTheme.kt`
- [Sound effects](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/ui/WeatherSoundManager.kt): `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherSoundManager.kt`

### Weather data

- [Weather providers](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherRepository.kt): `WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherRepository.kt`
- [OpenWeather client](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/api/OpenWeatherApi.kt): `WeatherApp/app/src/main/java/com/weather/app/data/api/OpenWeatherApi.kt`
- [WeatherAPI client](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/api/WeatherApiService.kt): `WeatherApp/app/src/main/java/com/weather/app/data/api/WeatherApiService.kt`
- [WeatherAPI repository](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherApiRepository.kt): `WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherApiRepository.kt`
- [Open-Meteo repository](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/OpenMeteoRepository.kt): `WeatherApp/app/src/main/java/com/weather/app/data/repository/OpenMeteoRepository.kt`
- [Tomorrow repository](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/TomorrowRepository.kt): `WeatherApp/app/src/main/java/com/weather/app/data/repository/TomorrowRepository.kt`
- [City geocoding](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/GeocodingRepository.kt): `WeatherApp/app/src/main/java/com/weather/app/data/repository/GeocodingRepository.kt`
- [Weather report](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/LocalWeatherReportGenerator.kt): `WeatherApp/app/src/main/java/com/weather/app/data/LocalWeatherReportGenerator.kt`

### Background alerts

- [Notification manager](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationManager.kt): `WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationManager.kt`
- [Weather alert worker](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationWorker.kt): `WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationWorker.kt`
- [Morning briefing worker](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/MorningBriefingWorker.kt): `WeatherApp/app/src/main/java/com/weather/app/MorningBriefingWorker.kt`

### User state and surfaces

- [App preferences](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/WeatherPreferences.kt): `WeatherApp/app/src/main/java/com/weather/app/data/WeatherPreferences.kt`
- [Saved cities](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/repository/FavoritesManager.kt): `WeatherApp/app/src/main/java/com/weather/app/data/repository/FavoritesManager.kt`
- [Tile ordering](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/data/TileOrderManager.kt): `WeatherApp/app/src/main/java/com/weather/app/data/TileOrderManager.kt`
- [Weather widget](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/widget/WeatherWidget.kt): `WeatherApp/app/src/main/java/com/weather/app/widget/WeatherWidget.kt`
- [Widget data](https://github.com/aleksandargonovski-git/cloudio-weather-app/blob/main/WeatherApp/app/src/main/java/com/weather/app/widget/WeatherWidgetData.kt): `WeatherApp/app/src/main/java/com/weather/app/widget/WeatherWidgetData.kt`

### Other components

- **Weather user**
- **External weather APIs**: external system

## Connections

- Weather user → App entry: opens app (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- App entry → Weather view model: creates (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- App entry → Weather screens: hosts (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- App entry → Theme system: applies (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- App entry → Notification manager: initializes (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- App entry → Weather alert worker: syncs schedule (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- App entry → Morning briefing worker: syncs schedule (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- App entry → App preferences: reads settings (evidence: `WeatherApp/app/src/main/java/com/weather/app/MainActivity.kt`)
- Weather screens → Weather view model: receives state (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt`)
- Weather screens → Forecast cards: renders cards (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt`)
- Dark Sky layout → Forecast cards: uses icons (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/screens/DarkSkyLayout.kt`)
- Weather view model → Weather providers: loads weather (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → WeatherAPI repository: loads weather (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → Open-Meteo repository: loads weather (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → Tomorrow repository: loads weather (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → City geocoding: searches cities (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → Saved cities: manages cities (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → App preferences: reads settings (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → Tile ordering: manages layout (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → Weather report: generates report (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather view model → Weather widget: updates (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/WeatherViewModel.kt`)
- Weather providers → OpenWeather client: uses client (evidence: `WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherRepository.kt`)
- WeatherAPI repository → WeatherAPI client: uses service (evidence: `WeatherApp/app/src/main/java/com/weather/app/data/repository/WeatherApiRepository.kt`)
- Open-Meteo repository → External weather APIs: requests forecasts (evidence: `WeatherApp/app/src/main/java/com/weather/app/data/repository/OpenMeteoRepository.kt`)
- Tomorrow repository → External weather APIs: requests forecasts (evidence: `WeatherApp/app/src/main/java/com/weather/app/data/repository/TomorrowRepository.kt`)
- Weather alert worker → App preferences: reads settings (evidence: `WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationWorker.kt`)
- Weather alert worker → Notification manager: sends alerts (evidence: `WeatherApp/app/src/main/java/com/weather/app/WeatherNotificationWorker.kt`)
- Morning briefing worker → App preferences: reads settings (evidence: `WeatherApp/app/src/main/java/com/weather/app/MorningBriefingWorker.kt`)
- Morning briefing worker → Notification manager: sends briefing (evidence: `WeatherApp/app/src/main/java/com/weather/app/MorningBriefingWorker.kt`)
- Weather widget → Widget data: uses data (evidence: `WeatherApp/app/src/main/java/com/weather/app/widget/WeatherWidget.kt`)
- Weather screens → Sound effects: plays effects (evidence: `WeatherApp/app/src/main/java/com/weather/app/ui/screens/WeatherScreen.kt`)
