https://github.com/franciscobarrios/airawarekmp
AirAware is an open-source, cross-platform air quality monitoring application built using Kotlin Multiplatform (KMP). It provides real-time Air Quality Index (AQI) data by fetching information from aqicn.com and displays it alongside weather details such as temperature and atmospheric pressure.
https://github.com/franciscobarrios/airawarekmp
airquality android aqi aqicn-api desktop ios kmp kotlin multiplatform
Last synced: about 2 months ago
JSON representation
AirAware is an open-source, cross-platform air quality monitoring application built using Kotlin Multiplatform (KMP). It provides real-time Air Quality Index (AQI) data by fetching information from aqicn.com and displays it alongside weather details such as temperature and atmospheric pressure.
- Host: GitHub
- URL: https://github.com/franciscobarrios/airawarekmp
- Owner: franciscobarrios
- Created: 2025-02-06T01:54:15.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-03-04T15:50:02.000Z (2 months ago)
- Last Synced: 2025-03-04T16:41:03.504Z (2 months ago)
- Topics: airquality, android, aqi, aqicn-api, desktop, ios, kmp, kotlin, multiplatform
- Language: Kotlin
- Homepage: https://franciscobarrios.github.io/AirAware-Info/
- Size: 229 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AirAware – Technical Overview
AirAware is an open-source, cross-platform air quality monitoring application built using Kotlin Multiplatform (KMP). It provides real-time Air Quality Index (AQI) data by fetching information from aqicn.com and displays it alongside weather details such as temperature and atmospheric pressure.
## Platforms & Architecture:
- Supported Platforms: Android, iOS, Windows, macOS, and Linux
- Core Logic: Written in Kotlin Multiplatform (KMP) to share business logic across all platforms.
- Networking & Data Handling: Uses Ktor for API requests and Serialization for data parsing.
- Location Services: Retrieves the user's location via platform-specific implementations to
determine the nearest air quality sensor.
## UI Frameworks:
- Android & Desktop (Windows/macOS/Linux): Jetpack Compose (Compose Multiplatform)
- iOS: SwiftUI with Kotlin/Native integration
## Key Features:
- Real-Time AQI Data: Pulls air quality data from aqicn.com based on the user’s location.
- Color-Coded AQI Indicators: Visual representation of AQI severity.
- Basic Weather Information: Displays temperature and atmospheric pressure.
- 7-Day Air Quality Forecast: Provides a week-long prediction of AQI trends.
- Cross-Platform Synchronization: Ensures consistent data retrieval and UI experience across
devices.