Breathe Easy with Breeze
A native iOS app for monitoring real-time air quality, pollutants, pollen levels, and climate trends worldwide. Built with Swift and SwiftUI.
Quick start
Get Breeze running on your iOS device in minutes
1
Clone the repository
Clone the Breeze iOS repository from GitHub and navigate to the project directory.
2
Open in Xcode
Open the Xcode project and select your target device.
Requires Xcode 15.0+ and iOS 16.0+
3
Configure API keys (optional)
For pollen data, add your Google Pollen API key as an environment variable in Xcode. The app works without this key, but pollen tracking will be unavailable.
How to add environment variables in Xcode
How to add environment variables in Xcode
- Go to Product → Scheme → Edit Scheme
- Under Run → Arguments → Environment Variables
- Add:
GOOGLE_POLLEN_API_KEY = your_api_key_here
4
Build and run
Press
Cmd + R to build and run the app on your selected device or simulator.Core features
Everything you need to monitor air quality and environmental health
Real-time air quality
View US AQI index for any location worldwide with color-coded health status
Pollutant tracking
Track PM2.5, PM10, NO₂, SO₂, O₃, and CO levels with detailed breakdowns
Pollen monitoring
Monitor grass, tree, and weed pollen levels for allergy management
Climate trends
See historical temperature data and climate patterns for your location
Location search
Search cities worldwide with autocomplete or use your current location
Dark mode
Full dark mode support for comfortable viewing any time
Architecture
Built with modern Swift patterns and clean architecture
MVVM pattern
Clean separation of concerns with ViewModels managing state
Service layer
Actor-based services for safe concurrent API calls
SwiftUI views
Declarative UI with reusable components and modifiers
Data models
Codable structs for type-safe JSON decoding
API reference
External APIs and internal services powering Breeze
Air quality service
Fetch real-time AQI and pollutant data from Open-Meteo
Geocoding service
Search cities and resolve coordinates with Open-Meteo Geocoding API
Pollen service
Get pollen forecasts from Google Pollen API
Climate service
Historical weather data from Open-Meteo Archive API
Resources
Additional resources to help you get the most out of Breeze
Ready to build?
Explore the full documentation to learn how Breeze is built and how you can customize it for your needs.
Explore the architecture