Breathable Air Quality Widget

We're working on some fun new features, but for now here's a quick maintenance release: - Help Center articles now properly respect dark or light mode system settings - Help Center email links will now, ahem, actually allow to you send an email to support (sorry about that!)

New in version 2.0: Breathable now supports Apple Watch! • A new Breathable Watch app is available • The Watch app shares configuration with the iPhone app, so your API keys, coordinates and API data preference will be automatically shared to Breathable on Apple Watch • Gauge complication support for all Watch face styles (corner, circular and bezel) • The Breathable Watch app will also show you the current value and related information if you tap the complication or launch the app directly • If you launch the Breathable Watch app without configuring the iPhone app first, the Watch app will give you information about how to proceed • Added some helpful Watch-related features to Help Center in the main app on iPhone if a Watch is connected Widget improvements: • Breathable was previously reporting the AQI data’s date as the date fetched in larger widgets, which led to user confusion: “Why is my data from 6PM today when it’s 8PM?” But sometimes API data will deliver older data if the value hasn’t changed. Instead, Breathable now reports the actual time it fetched the data, even if the data was stale. This has two benefits: First, it means you’ll always know when the last actual fetch time was, and second, this resolves a bug in the widget where you could see “Today, 8PM” past midnight into the next day. Widgets should feel more accurate, more frequently. • Both widget types now share their API data preference (done to better support Apple Watch version). Most users were likely already setting the same value for both widget types, but now the setting is shared between both. And: • Support for new widget sizes and futuristic versions of operating systems • Fixed an issue widget examples in the welcome flow wouldn’t properly animate

In this release: • Added support for more complications, including Modular and Utility! • Updated Watch app initial flow to better explain how to get help with initial setup • Added additional Watch app information to Help Center, including detailed steps for troubleshooting initial setup Still brand-new in version 2.0: Breathable now supports Apple Watch! • A new Breathable Watch app is available • The Watch app shares configuration with the iPhone app, so your API keys, coordinates and API data preference will be automatically shared to Breathable on Apple Watch • Gauge complication support for all Watch face styles (corner, circular and bezel) • The Breathable Watch app will also show you the current value and related information if you tap the complication or launch the app directly • If you launch the Breathable Watch app without configuring the iPhone app first, the Watch app will give you information about how to proceed • Added some helpful Watch-related features to Help Center in the main app on iPhone if a Watch is connected Widget improvements: • Breathable was previously reporting the AQI data’s date as the date fetched in larger widgets, which led to user confusion: “Why is my data from 6PM today when it’s 8PM?” But sometimes API data will deliver older data if the value hasn’t changed. Instead, Breathable now reports the actual time it fetched the data, even if the data was stale. This has two benefits: First, it means you’ll always know when the last actual fetch time was, and second, this resolves a bug in the widget where you could see “Today, 8PM” past midnight into the next day. Widgets should feel more accurate, more frequently. • Both widget types now share their API data preference (done to better support Apple Watch version). Most users were likely already setting the same value for both widget types, but now the setting is shared between both. And: • Support for new widget sizes and futuristic versions of operating systems • Fixed an issue widget examples in the welcome flow wouldn’t properly animate

In this release: • Fixed an issue where the “use pure black in dark mode” setting made dark mode widgets permanently pure black, even if you toggled the setting off. This fix required resetting that UI preference, but it works correctly now you can can toggle it again if you’d like! • Fixed an issue where you couldn’t clear an API key if it was invalid if iCloud syncing was enabled for Breathable Recently, in versions 2.0 and 2.1: • Breathable now supports Apple Watch! • More complications, including Modular and Utility! • More accurate widget timestamps and data fetching behavior! • Support for new widget sizes and futuristic versions of operating systems!

Hello, friends! After a very long (longer than planned) hiatus, here's a minor update to get Breathable back on track. We've received lots of feedback about AQI data not showing, and so we've updated our FAQs to make it clearer how to replace expiring API keys (this is free and quick). Additionally, we've updated the minimum required versions across all platforms to more modern releases. We also added dark mode and tintable icons for the newest iOS release. Note: Due to changes in how complications work over the years, you may need to remove/re-add the Breathable complication on your Watch faces. We apologize for the inconvenience. This initial release is only the first step in bringing Breathable into the modern era with some new features. Thanks for your support and patience!

We're excited to release Breathable 3.0, packed full of new features, fixes and improvements: - Added support for Lock Screen widgets (circular, rectangular and inline) - Added support for StandbyMode (uses the small widget style and customization options) - Added dark mode and tinted mode support for the Breathable app icon - Added full tint mode support for home screen widgets - Added a new gradient widget style, which looks especially lovely in dark mode - Added a new widget style selector to make customization easier/clearer - Added all new emoji supported by Apple since last major Breathable release - Added additional Emoji Scale sets, retired some older unused sets - Added a refresh button to the Apple Watch app to allow for manual updates directly on Watch - Added updated common issues to Help Center and improved FAQ list with new entries - Improved emoji picker category UI added haptics on taps - Improved caching and scheduling of API calls to better utilize API key limits - Improved sharing of recent AQI data between widgets on same device - Redesigned and modernized the Apple Watch app (requires watchOS 11 or later) - Redesigned and overhauled macOS app to increase font sizes and modernize app layout - Redesigned the Coordinates view for clarity and usability - Redesigned, simplified and clarified widget configuration UI - Redesigned and greatly simplified UI for API keys view Please note: This is the final release of Breathable to support iOS/iPadOS 17 and watchOS 10. Future versions of Breathable will require iOS/iPadOS 18 and watchOS 11 or later. As always, we appreciate your patience and support!

In version 3.0.1: - Fixed an embarrassing misspelling of a famous French landmark. Je suis désolé. Plus, everything that was new in 3.0: - Added support for Lock Screen widgets (circular, rectangular and inline) - Added support for StandbyMode (uses the small widget style and customization options) - Added dark mode and tinted mode support for the Breathable app icon - Added full tint mode support for home screen widgets - Added a new gradient widget style, which looks especially lovely in dark mode - Added a new widget style selector to make customization easier/clearer - Added all new emoji supported by Apple since last major Breathable release - Added additional Emoji Scale sets, retired some older unused sets - Added a refresh button to the Apple Watch app to allow for manual updates directly on Watch - Added updated common issues to Help Center and improved FAQ list with new entries - Improved emoji picker category UI added haptics on taps - Improved caching and scheduling of API calls to better utilize API key limits - Improved sharing of recent AQI data between widgets on same device - Redesigned and modernized the Apple Watch app (requires watchOS 11 or later) - Redesigned and overhauled macOS app to increase font sizes and modernize app layout - Redesigned the Coordinates view for clarity and usability - Redesigned, simplified and clarified widget configuration UI - Redesigned and greatly simplified UI for API keys view Please note: This is the final release of Breathable to support iOS/iPadOS 17, watchOS 10 and macOS 14. Future versions of Breathable will require iOS/iPadOS 18, watchOS 11 and macOS 15 or later. As always, we appreciate your patience and support!

This is a minor compatibility update as we work on larger changes to support new OSes. This update will keep you running on all platforms, but will be the final release to support OS versions prior to 26. - Updated URLs in the FAQ entry for setting up IQAir.com keys to point to correct pages

Breathable 4.0 is our biggest update yet! We've rewritten and redesigned from the ground up across every platform and added native support for Apple Vision Pro! New Services, Historical Data, and Syncing: We've added support for PurpleAir and World Air Quality Index, and Breathable now supports any combination of services rather than requiring any specific key. We've greatly improved our key validation and syncing to iCloud. And, speaking of iCloud: Breathable now syncs AQI data to iCloud and across all of your devices, greatly reducing the number of required API calls and improving data quality anywhere you use the app. We also store historical data for every request, sync that history across devices, and use it to build a whole new feature: Trends! Trends: Explore your air quality history in the new Trends tab with an interactive chart. Filter by location, recording device, or AQI source. Tap any point in the chart to view details, or drill into the All Data view for a granular look at every recording. Automatic Location: Our most requested feature is here! You can now set Breathable to automatically use your location instead of managing and providing manual coordinates. Turn this on and Breathable will properly record AQI information and provide location-accurate widget information. Spatial Features: We're so excited to bring Breathable to Apple Vision Pro! Not only are all of the app features available in native form on your headset, but we've added some special Vision Pro-specific bonuses: - AQI Sky Window widget: A larger widget that shows the current AQI in a simulated window with real sun positions, moon phase, time of day and volumetric effects - The Breathable "Trophy": Snap this little object to your desk or shelf and you'll have an AQI sensor in your physical space. And, if you turn it around and look at the back side, you might find a nice little surprise feature... - A current AQI ornament hanging off the top of the Breathable window, and the ability to split off the Trends view as well if you want to leave it in your space without seeing the rest of the app macOS, iPadOS and watchOS Overhauls: We rewrote the core of these platforms to greatly improve their look & feel and syncing engines. - Breathable on macOS now supports a native sidebar, better font sizing, updated shortcuts and system menu support, and more - On iPad, Breathable now supports native window resizing! - watchOS gets an all-new AQI fetching and syncing system, a new rectangular Trends widget, migration of all previous widgets to WidgetKit, and more Siri & Shortcuts: Now you can ask Siri, "What's the AQI in Breathable?" and Siri will give you the most recent AQI data Breathable has, and even offer to fetch fresh data if needed. On devices with screens, Siri will also display AQI details. We've also added Shortcuts support for fetching the AQI from Breathable directly. We've refined and updated nearly every aspect of the app on every platform, we couldn't possibly list every change but here are the broad strokes: - Breathable is prepared for the upcoming OS releases on all platforms - Liquid Glass support throughout, new app icon (including dark mode and transparent mode support) - Completely redesigned the Medium widget, refined the Small widget, added custom font support in widgets - API keys now properly report when they've expired or usage has gone over a limit, including showing a warning on widgets themselves - Completely rewrote the custom AQI gauge with flexibility and resizing features - Preferred source selector in Widget customization now allows for Highest or Highest PM2.5-only, for those who prefer to only worry about particles instead of O3 readings - Breathable now communicates in widgets when location sharing is turned off but needed, or API keys are invalid - Many, many more fixes and changes!