# ByronNote/MinimalistWeather

一款基于 Kotlin、Jetpack Compose 与 Clean Architecture 构建的现代 Android 天气应用，支持动态天气场景、全球城市搜索、空气质量、24 小时与 7 日预报，数据来自 Open-Meteo。

Repository: https://github.com/ByronNote/MinimalistWeather
Canonical: https://ross.abutalabs.com/products/minimalistweather
Homepage: https://zhuanlan.zhihu.com/baron
Language: Kotlin
License Family: other
Topics: weather, android, clean-architecture, compose-first, android-weather
Last push: 2026-08-16T16:30:11+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 35, longevity 100
- inputs: {"age_days": 3800, "days_push": 17, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2435, forks 559 (observed 2026-08-28T04:06:51.378818+00:00)

## What it is
MinimalistWeather is a modern Android weather app built with Kotlin and Jetpack Compose following multi-module Clean Architecture. It provides current conditions, 24-hour and 7-day forecasts, air quality, dynamic weather scenes, and global city search powered by the Open-Meteo APIs with no API key required.

## Use cases
- check current weather and hourly forecasts on android
- view 7-day weather forecast with air quality index
- search cities worldwide and save favorite locations
- build a compose-first android app with clean architecture as a reference
- get weather updates automatically in the background
- see dynamic weather animations that change with conditions

## When to choose
- you want a free, open-source android weather app with no API key setup
- you need a real-world reference project for Kotlin, Compose, and Clean Architecture patterns
- you want dynamic weather visuals, air quality data, and multi-city management in one app

## When to avoid
- you need an iOS, desktop, or web weather application
- you require weather data sources other than Open-Meteo
- you need a stable production app with a formal license and long-term support guarantees

## Facets
- artifact type: application
- maturity: active
- function: http-client, serialization, caching, ui-components, state-management, developer-tools
- domain: weather, android-tools, mobile-development, cross-platform
- platform: jvm
- tags: jetpack-compose, clean-architecture, open-meteo, weather-app, kotlin, material-3, hilt, udf, android

## Member repositories
- ByronNote/MinimalistWeather (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:51.378818+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:31:01.830740+00:00, confidence not recorded.
  - readme: https://github.com/ByronNote/MinimalistWeather (fetched 2026-08-28T04:06:51.378818+00:00, sha 4e0cb5e7011f)
- Data as of 2026-08-30T08:39:29.467469+00:00.