Breathable Air Quality Widget

September 23, 2024

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!

September 26, 2021

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!

September 22, 2021

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

September 22, 2021

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

August 15, 2021

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!)  

July 26, 2021

- Three new emoji sets, two created by Breathable user Elizabeth! (Have a fun emoji set you'd like to share with other users? Email a screenshot to support@karbon.agency.) - Fix for an incorrect AQI range description in the Customize Emoji view - Curling of non-curled quotes throughout the app - Several accessibility improvements

July 25, 2021

Thank you so much for supporting Breathable! We’re looking forward to announcing our first donation to climate change initiatives at the end of our first month of sales. In the mean time, here’s what’s new in version 1.3: Help Center - Collects a few common issues and solutions in one place—right in the app—including a rare issue where Breathable doesn’t immediately show up in the system widget list (and how to solve it!) - Added a force reload button for rare cases where a widget might not update after a UI change - Additional links to FAQs, emailing support, and our privacy policy API Keys: - Required and recommended text will now only be highlighted if keys haven’t been entered/verified for those fields

July 20, 2021

Completely overhauled the coordinates configuration view and functionality: • When valid coordinates are entered, Breathable will now also provide a location description (for example: "Cupertino, CA") which will help you visually verify your coordinates are correct • You can now search coordinates by typing in any part of a location—postal code, place name, or partial or full address • Completely removed the optional ZipCodeAPI service from the app, as its no longer needed API Keys: • You can now verify your API keys to ensure they're entered correctly and work • Fixed a rare case where API keys might not be properly synced to iCloud • Prevented a possible crash when entering an API key with bad characters • Improved tap targets in various areas of the Widget UI and Customize Emoji views • Improved how pop-up menus work in Widget UI form • Many future-looking improvements throughout the app for our friends living on the cutting edge of technology • Replaced straight quotes with curly quotes throughout the app

July 7, 2021

• Customize Emoji Scale! Choose from one of several pre-made, sometimes-goofy sets, or pick your own emoji for each value on the AQI scale • Added a slider to the Widget UI preview so you can change the sample index and see what your widget will look like at each value • Some visual cleanup in Widget UI settings to improve readability

June 29, 2021