Breeze uses strongly-typed Swift structs and enums to represent air quality, pollen, climate data, and user preferences. All models conform to Codable for seamless API integration.
Air Quality Models
AirQuality
The primary model for air quality data from the Open-Meteo API.
US Air Quality Index (0-500 scale)
Fine particulate matter ≤2.5 micrometers in µg/m³
Coarse particulate matter ≤10 micrometers in µg/m³
Carbon monoxide concentration in µg/m³
Nitrogen dioxide concentration in µg/m³
Sulfur dioxide concentration in µg/m³
Ground-level ozone concentration in µg/m³
BreezeApp/Models/AirQuality.swift
struct AirQuality: Codable {
let usAQI: Int
let pm25: Double
let pm10: Double
let carbonMonoxide: Double
let nitrogenDioxide: Double
let sulphurDioxide: Double
let ozone: Double
enum CodingKeys: String, CodingKey {
case usAQI = "us_aqi"
case pm25 = "pm2_5"
case pm10
case carbonMonoxide = "carbon_monoxide"
case nitrogenDioxide = "nitrogen_dioxide"
case sulphurDioxide = "sulphur_dioxide"
case ozone
}
}
AQIStatus
Provides human-readable status information based on AQI value.
Status label: “Excellent”, “Good”, “Moderate”, “Unhealthy”, etc.
Visual emoji representation (✨, 😊, 😷, 🚨, ☠️)
Friendly description of air quality conditions
Color theme identifier (e.g., “aqiGood”, “aqiUnhealthy”)
Array of health tips and recommendations
BreezeApp/Models/AirQuality.swift
static func from(aqi: Int) -> AQIStatus {
switch aqi {
case 0...25:
return AQIStatus(
text: "Excellent",
emoji: "✨",
description: "Air quality is pristine! Perfect day for adventures.",
color: "aqiGood",
tips: [
"Air is exceptionally clean right now",
"No air quality concerns at this level"
]
)
case 26...50:
return AQIStatus(
text: "Good",
emoji: "😊",
description: "Air quality is great. Breathe easy!",
color: "aqiGood",
tips: [
"Air quality meets health standards",
"Pollutant levels are low"
]
)
// ... additional cases for Moderate, Unhealthy, Hazardous
}
}
Pollutant Models
PollutantType
Enum representing individual air pollutants with their properties and thresholds.
BreezeApp/Models/Pollutant.swift
enum PollutantType: String, CaseIterable, Identifiable {
case pm25 = "PM2.5"
case pm10 = "PM10"
case no2 = "NO₂"
case so2 = "SO₂"
case o3 = "O₃"
case co = "CO"
var fullName: String { /* ... */ }
var description: String { /* ... */ }
var icon: String { /* SF Symbol name */ }
var goodLimit: Double { /* µg/m³ threshold */ }
var moderateLimit: Double { /* µg/m³ threshold */ }
var unit: String { return "µg/m³" }
}
Fine Particulate Matter (PM2.5) - particles ≤2.5 micrometers
- Good limit: 12 µg/m³
- Moderate limit: 35.4 µg/m³
- Icon:
wind
Coarse Particulate Matter (PM10) - particles ≤10 micrometers
- Good limit: 54 µg/m³
- Moderate limit: 154 µg/m³
- Icon:
cloud
Nitrogen Dioxide - from vehicle emissions
- Good limit: 53 µg/m³
- Moderate limit: 100 µg/m³
- Icon:
car.fill
Sulfur Dioxide - from fossil fuel combustion
- Good limit: 35 µg/m³
- Moderate limit: 75 µg/m³
- Icon:
building.2.fill
Ground-level Ozone - formed by sunlight and pollutants
- Good limit: 54 µg/m³
- Moderate limit: 70 µg/m³
- Icon:
sun.max.fill
Carbon Monoxide - from incomplete combustion
- Good limit: 4400 µg/m³
- Moderate limit: 9400 µg/m³
- Icon:
flame.fill
PollutantReading
Represents a single pollutant measurement with status calculation.
BreezeApp/Models/Pollutant.swift
struct PollutantReading: Identifiable {
let id = UUID()
let type: PollutantType
let value: Double
var status: PollutantStatus {
if value <= type.goodLimit {
return .good
} else if value <= type.moderateLimit {
return .moderate
} else {
return .unhealthy
}
}
}
Pollen Models
PollenItem
Unified model for displaying pollen types and plant-specific data.
Unique identifier (plant code or pollen type code)
Display name (e.g., “Grass”, “Tree”, “Oak”, “Birch”)
Pollen index value (0-5 scale)
Category description from API (e.g., “Low”, “Moderate”, “High”)
Whether this is a specific plant (true) or general pollen type (false)
URL to plant image (only for plant-specific items)
Pollination season description
Visual characteristics of the plant
Health tips and recommendations
BreezeApp/Models/PollenData.swift
var level: PollenLevel {
switch value {
case 0: return .none
case 1: return .low
case 2...3: return .moderate
case 4: return .high
case 5...: return .veryHigh
default: return .low
}
}
PollenLevel
Enum for pollen severity levels with color mapping.
BreezeApp/Models/PollenData.swift
enum PollenLevel: String {
case none = "None"
case low = "Low"
case moderate = "Moderate"
case high = "High"
case veryHigh = "Very High"
var colorName: String {
switch self {
case .none: return "levelNone"
case .low: return "levelLow"
case .moderate: return "levelModerate"
case .high: return "levelHigh"
case .veryHigh: return "levelExtreme"
}
}
}
Climate Models
ClimateDataPoint
Historical temperature data for climate trend visualization.
Auto-generated unique identifier
Year of measurement (e.g., 1980, 1990, 2000, 2010, 2020)
Maximum temperature in Celsius
BreezeApp/Models/ClimateData.swift
struct ClimateDataPoint: Identifiable {
let id = UUID()
let year: Int
let temperature: Double
}
Location Models
City
Model for city search results and location data.
Unique city identifier from geocoding API
Administrative region (state, province, etc.)
BreezeApp/Models/City.swift
var displayName: String {
var components = [name]
if let admin1 = admin1, !admin1.isEmpty {
components.append(admin1)
}
if let country = country, !country.isEmpty {
components.append(country)
}
return components.joined(separator: ", ")
}
var coordinate: CLLocationCoordinate2D {
CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
}
TopCity
Predefined cities for the ticker display on the landing page.
BreezeApp/Models/City.swift
struct TopCity {
let name: String
let country: String
let lat: Double
let lon: Double
static let all: [TopCity] = [
TopCity(name: "New York", country: "USA", lat: 40.7128, lon: -74.0060),
TopCity(name: "London", country: "UK", lat: 51.5074, lon: -0.1278),
TopCity(name: "Tokyo", country: "Japan", lat: 35.6762, lon: 139.6503),
// ... 7 more cities
]
}
User Preference Models
AppearanceMode
Enum for theme selection (light, dark, system).
Follow system appearance settings (default)
BreezeApp/Models/AppearanceMode.swift
enum AppearanceMode: Int, CaseIterable, Identifiable {
case system = 0
case light = 1
case dark = 2
var displayName: String {
switch self {
case .system: return "System"
case .light: return "Light"
case .dark: return "Dark"
}
}
var colorScheme: ColorScheme? {
switch self {
case .system: return nil
case .light: return .light
case .dark: return .dark
}
}
}
API Response Wrappers
AirQualityResponse
struct AirQualityResponse: Codable {
let current: AirQuality?
}
GeocodingResponse
struct GeocodingResponse: Codable {
let results: [City]?
}
PollenResponse
struct PollenResponse: Codable {
let dailyInfo: [DailyPollenInfo]?
}
ClimateArchiveResponse
struct ClimateArchiveResponse: Codable {
let daily: ClimateDaily?
}
Theme Colors
Breeze defines custom color extensions for consistent theming across the app.
Background Colors
Primary app background color (adaptive to light/dark mode)
Card and surface backgrounds with improved contrast
- Dark mode:
UIColor(white: 0.15, alpha: 1.0)
- Light mode:
UIColor(white: 0.91, alpha: 1.0)
Search bar background color
- Dark mode:
UIColor(white: 0.2, alpha: 1.0)
- Light mode:
UIColor(white: 0.92, alpha: 1.0)
AQI Status Colors
Green color for Good air quality (#34c759)
Orange color for Moderate air quality (#ff9500)
Orange-red for Unhealthy for Sensitive Groups (#ff6b00)
Red color for Unhealthy air quality (#ff3b30)
Purple color for Very Unhealthy (#af52de)
Dark red for Hazardous air quality (#8e0000)
Pollen Level Colors
Green for no pollen (#34c759)
Green for low pollen levels (#34c759)
Orange for moderate pollen levels (#ff9500)
Red for high pollen levels (#ff3b30)
Dark red for extreme pollen levels (#8e0000)
Climate Trend Colors
Gray for neutral temperature change
Green for cooling trends (#34c759)
Orange for warming trends (#ff9500)
Red for significant warming (#ff3b30)
BreezeApp/Extensions/Color+Theme.swift:3-40
extension Color {
// MARK: - Background Colors
static let appBackground = Color("Background")
static let cardBackground = Color(UIColor { traitCollection in
traitCollection.userInterfaceStyle == .dark
? UIColor(white: 0.15, alpha: 1.0)
: UIColor(white: 0.91, alpha: 1.0)
})
// MARK: - AQI Colors
static let aqiGood = Color(hex: "34c759")
static let aqiModerate = Color(hex: "ff9500")
static let aqiUnhealthySensitive = Color(hex: "ff6b00")
static let aqiUnhealthy = Color(hex: "ff3b30")
static let aqiVeryUnhealthy = Color(hex: "af52de")
static let aqiHazardous = Color(hex: "8e0000")
// MARK: - Pollen Level Colors
static let levelNone = Color(hex: "34c759")
static let levelLow = Color(hex: "34c759")
static let levelModerate = Color(hex: "ff9500")
static let levelHigh = Color(hex: "ff3b30")
static let levelExtreme = Color(hex: "8e0000")
// MARK: - Climate Colors
static let climateNeutral = Color.gray
static let climateCool = Color(hex: "34c759")
static let climateWarm = Color(hex: "ff9500")
static let climateHot = Color(hex: "ff3b30")
}
