# oopnv70-lab/ui-lab architecture

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

- Interactive diagram: https://gitdiagram.com/oopnv70-lab/ui-lab
- Repository: https://github.com/oopnv70-lab/ui-lab

## Overview

ui-lab is an Android weather app: users grant location access or search for a city, then view current conditions, hourly and seven-day forecasts, precipitation, and air quality; they can refresh and manage saved cities. The runtime centers on the app shell and weather ViewModel, backed by network/data mapping and Compose screens. The README also describes multi-source validation as in progress, plus settings, navigation, dynamic color, and liquid-glass UI. Some links below are documented rather than verified in sampled call sites; these are dashed.

Main entry points: [`app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt) (App shell), [`app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt`](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt) (Weather repository), [`app/src/main/java/com/oopnv70/uilab/MainActivity.kt`](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/MainActivity.kt) (Main activity), [`app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherViewModel.kt`](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherViewModel.kt) (Weather state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_main["Main activity<br/>[MainActivity.kt]"]
  node_shell["App shell<br/>[LabApp.kt]"]
  node_settings[("Settings store")]
end

subgraph group_weather["Weather data"]
  node_weather_vm["Weather state"]
  node_repository["Weather repository"]
  node_real_weather["Weather model<br/>[RealWeather.kt]"]
  node_mapper["UI weather mapper"]
end

subgraph group_location["Location"]
  node_photon["Photon geocoder"]
  node_location_provider["Location provider"]
  node_permission["Permission flow"]
end

subgraph group_interface["Interface"]
  node_weather_pages["Weather pages<br/>[WeatherPages.kt]"]
  node_navigation["Pill navigation"]
  node_island["Dynamic island"]
  node_settings_page["Settings page<br/>[SettingsPage.kt]"]
  node_hidden_settings["Hidden settings"]
  node_theme["Theme colors<br/>[Color.kt]"]
  node_glass_surface["Liquid glass"]
  node_glass_view["Glass rendering<br/>[GlassView.kt]"]
  node_backdrop["Backdrop capture<br/>[BackdropCapture.kt]"]
  node_shader["Glass shader<br/>[GlassShader.kt]"]
end

node_user(("User"))
node_openmeteo{{"Open-Meteo"}}
node_metno{{"MET Norway"}}
node_nominatim{{"Nominatim"}}

node_user -->|"opens app"| node_main
node_main -->|"sets content"| node_shell
node_main -.->|"reads settings"| node_settings
node_shell -->|"observes state"| node_weather_vm
node_weather_vm -->|"requests data"| node_repository
node_repository -->|"fetches weather"| node_openmeteo
node_repository -->|"searches first"| node_nominatim
node_repository -.->|"builds models"| node_real_weather
node_weather_vm -->|"uses model"| node_real_weather
node_real_weather -->|"maps fields"| node_mapper
node_shell -.->|"shows pages"| node_weather_pages
node_shell -->|"shows navigation"| node_navigation
node_shell -->|"hosts capsule"| node_island
node_shell -->|"shows settings"| node_settings_page
node_shell -->|"hosts settings"| node_hidden_settings
node_main -.->|"requests access"| node_permission
node_permission -.->|"enables location"| node_location_provider
node_location_provider -->|"reverse geocodes"| node_photon
node_user -.->|"searches cities"| node_shell
node_repository -.->|"gets conditions"| node_metno
node_navigation -->|"renders glass"| node_glass_surface
node_glass_surface -->|"hosts view"| node_glass_view
node_glass_view -->|"captures backdrop"| node_backdrop
node_glass_view -.->|"applies shader"| node_shader
node_settings_page -->|"uses colors"| node_theme
node_shell -->|"sets theme"| node_theme

click node_main "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/MainActivity.kt"
click node_shell "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt"
click node_settings "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/settings/AppSettingsStore.kt"
click node_weather_vm "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherViewModel.kt"
click node_repository "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt"
click node_real_weather "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/data/RealWeather.kt"
click node_mapper "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/RealWeatherMapper.kt"
click node_photon "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/data/PhotonReverseGeocoder.kt"
click node_location_provider "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/location/LocationProvider.kt"
click node_permission "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/location/LocationPermissionCompose.kt"
click node_weather_pages "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherPages.kt"
click node_navigation "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/components/FloatingPillNavigationBar.kt"
click node_island "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/DynamicIslandCapsule.kt"
click node_settings_page "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/settings/SettingsPage.kt"
click node_hidden_settings "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/settings/HiddenSettingsPage.kt"
click node_theme "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/theme/Color.kt"
click node_glass_surface "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/LiquidGlassSurface.kt"
click node_glass_view "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/GlassView.kt"
click node_backdrop "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/BackdropCapture.kt"
click node_shader "https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/GlassShader.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_main,node_shell,node_settings,node_user toneBlue
class node_weather_vm,node_repository,node_real_weather,node_mapper toneAmber
class node_photon,node_location_provider,node_permission toneMint
class node_weather_pages,node_navigation,node_island,node_settings_page,node_hidden_settings,node_theme,node_glass_surface,node_glass_view,node_backdrop,node_shader toneRose
class node_openmeteo,node_metno,node_nominatim toneIndigo
```

## Components

### App shell

- [Main activity](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/MainActivity.kt): `app/src/main/java/com/oopnv70/uilab/MainActivity.kt`
- [App shell](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt): `app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`
- [Settings store](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/settings/AppSettingsStore.kt): `app/src/main/java/com/oopnv70/uilab/settings/AppSettingsStore.kt`

### Weather data

- [Weather state](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherViewModel.kt): `app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherViewModel.kt`
- [Weather repository](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt): `app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt`
- [Weather model](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/data/RealWeather.kt): `app/src/main/java/com/oopnv70/uilab/data/RealWeather.kt`
- [UI weather mapper](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/RealWeatherMapper.kt): `app/src/main/java/com/oopnv70/uilab/ui/weather/RealWeatherMapper.kt`

### Location

- [Photon geocoder](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/data/PhotonReverseGeocoder.kt): `app/src/main/java/com/oopnv70/uilab/data/PhotonReverseGeocoder.kt`
- [Location provider](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/location/LocationProvider.kt): `app/src/main/java/com/oopnv70/uilab/location/LocationProvider.kt`
- [Permission flow](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/location/LocationPermissionCompose.kt): `app/src/main/java/com/oopnv70/uilab/location/LocationPermissionCompose.kt`

### Interface

- [Weather pages](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherPages.kt): `app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherPages.kt`
- [Pill navigation](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/components/FloatingPillNavigationBar.kt): `app/src/main/java/com/oopnv70/uilab/ui/components/FloatingPillNavigationBar.kt`
- [Dynamic island](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/weather/DynamicIslandCapsule.kt): `app/src/main/java/com/oopnv70/uilab/ui/weather/DynamicIslandCapsule.kt`
- [Settings page](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/settings/SettingsPage.kt): `app/src/main/java/com/oopnv70/uilab/ui/settings/SettingsPage.kt`
- [Hidden settings](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/settings/HiddenSettingsPage.kt): `app/src/main/java/com/oopnv70/uilab/ui/settings/HiddenSettingsPage.kt`
- [Theme colors](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/ui/theme/Color.kt): `app/src/main/java/com/oopnv70/uilab/ui/theme/Color.kt`
- [Liquid glass](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/LiquidGlassSurface.kt): `app/src/main/java/com/oopnv70/uilab/glass/LiquidGlassSurface.kt`
- [Glass rendering](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/GlassView.kt): `app/src/main/java/com/oopnv70/uilab/glass/GlassView.kt`
- [Backdrop capture](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/BackdropCapture.kt): `app/src/main/java/com/oopnv70/uilab/glass/BackdropCapture.kt`
- [Glass shader](https://github.com/oopnv70-lab/ui-lab/blob/main/app/src/main/java/com/oopnv70/uilab/glass/GlassShader.kt): `app/src/main/java/com/oopnv70/uilab/glass/GlassShader.kt`

### Other components

- **User**
- **Open-Meteo**
- **MET Norway**
- **Nominatim**

## Connections

- User → Main activity: opens app (evidence: `app/src/main/java/com/oopnv70/uilab/MainActivity.kt`)
- Main activity → App shell: sets content (evidence: `app/src/main/java/com/oopnv70/uilab/MainActivity.kt`)
- Main activity → Settings store: reads settings
- App shell → Weather state: observes state (evidence: `app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`)
- Weather state → Weather repository: requests data (evidence: `app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherViewModel.kt`)
- Weather repository → Open-Meteo: fetches weather (evidence: `app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt`)
- Weather repository → Nominatim: searches first (evidence: `app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt`)
- Weather repository → Weather model: builds models (evidence: `app/src/main/java/com/oopnv70/uilab/data/WeatherRepository.kt`)
- Weather state → Weather model: uses model (evidence: `app/src/main/java/com/oopnv70/uilab/ui/weather/WeatherViewModel.kt`)
- Weather model → UI weather mapper: maps fields (evidence: `app/src/main/java/com/oopnv70/uilab/ui/weather/RealWeatherMapper.kt`)
- App shell → Weather pages: shows pages
- App shell → Pill navigation: shows navigation (evidence: `app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`)
- App shell → Dynamic island: hosts capsule (evidence: `app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`)
- App shell → Settings page: shows settings (evidence: `app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`)
- App shell → Hidden settings: hosts settings (evidence: `app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`)
- Main activity → Permission flow: requests access
- Permission flow → Location provider: enables location
- Location provider → Photon geocoder: reverse geocodes (evidence: `app/src/main/java/com/oopnv70/uilab/location/LocationProvider.kt`)
- User → App shell: searches cities
- Weather repository → MET Norway: gets conditions (evidence: `README.md`)
- Pill navigation → Liquid glass: renders glass (evidence: `app/src/main/java/com/oopnv70/uilab/ui/components/FloatingPillNavigationBar.kt`)
- Liquid glass → Glass rendering: hosts view (evidence: `app/src/main/java/com/oopnv70/uilab/glass/LiquidGlassSurface.kt`)
- Glass rendering → Backdrop capture: captures backdrop (evidence: `app/src/main/java/com/oopnv70/uilab/glass/GlassView.kt`)
- Glass rendering → Glass shader: applies shader
- Settings page → Theme colors: uses colors (evidence: `app/src/main/java/com/oopnv70/uilab/ui/settings/SettingsPage.kt`)
- App shell → Theme colors: sets theme (evidence: `app/src/main/java/com/oopnv70/uilab/ui/LabApp.kt`)
