Skip to main content

​
What is Breeze?

Breeze is a native iOS application for monitoring air quality, built with Swift and SwiftUI. It provides real-time air quality data for any location worldwide, helping users make informed decisions about their outdoor activities and health.
Breeze uses the US AQI (Air Quality Index) standard to measure and display air quality levels, making it easy to understand air quality conditions at a glance.

​
Key Features

Breeze offers comprehensive environmental monitoring with these powerful features:
  • Real-time Air Quality: View US AQI index for any location worldwide
  • Pollutant Details: Track PM2.5, PM10, NO₂, SO₂, O₃, and CO levels with individual readings and status indicators
  • Pollen/Allergy Tracker: Monitor grass, tree, and weed pollen levels (requires Google Pollen API)
  • Climate Trends: See historical temperature data for your location
  • City Search: Search and select cities with autocomplete functionality
  • Location Services: Use current location for instant air quality data
  • Dark Mode: Automatic dark mode support that adapts to your system preferences

​
Architecture Overview

Breeze follows a clean, modular architecture built with modern Swift patterns: 
BreezeApp/
├── App/                    # App entry point and main views
├── Models/                 # Data models for air quality, pollen, and climate
├── Services/               # API services for data fetching
├── ViewModels/            # State management with DashboardViewModel
├── Views/
│   ├── Dashboard/         # Main dashboard views and AQI card
│   ├── Search/            # City search interface
│   ├── Environmental/     # Pollen and climate views
│   └── Components/        # Reusable UI components
├── Extensions/            # Swift extensions for theming
└── Resources/             # Assets and resources

​
Core Technologies

  • SwiftUI: Modern declarative UI framework
  • Async/await: For efficient API calls and data fetching
  • Actor pattern: Thread-safe service implementations
  • @StateObject/@ObservedObject: Reactive state management
  • @AppStorage: Persistent user preferences

​
API Integration

Breeze integrates with multiple APIs to provide comprehensive environmental data:
  • Open-Meteo Air Quality API: Real-time air quality and pollutant data
  • Open-Meteo Geocoding API: City search and location services
  • Google Pollen API (optional): Pollen and allergy information
  • Open-Meteo Historical Weather API: Climate trends and temperature history
The app works without the Google Pollen API key, but pollen data will not be available. All other features function normally.

​
Understanding AQI Levels

Breeze displays air quality using the US AQI standard with the following categories:
AQI RangeStatusDescription
0-25Excellent ✨Air quality is pristine
26-50Good 😊Air quality is great
51-75Moderate 😐Acceptable for most people
76-100Slightly High 😕Getting iffy for sensitive groups
101-150Unhealthy for Sensitive Groups 😷Sensitive groups should be cautious
151-200Unhealthy 😨Everyone may feel effects
201-300Very Unhealthy 🚨Serious health concerns
301+Hazardous ☠️Emergency conditions

​
Next Steps

Get started with Breeze:

Requirements

Check system requirements and dependencies

Installation

Install and set up Breeze on your machine

Build docs developers (and LLMs) love

Get started for freeTalk to us