mit platform SPM compatible Tests codebeat badge

🔔 UpgradeAlert

Easily update your app

Table of Contents


  • đŸ–Ĩ macOS app does not auto update by default, unless user has set this specifically in app-store.
  • 📲 iOS auto update by default, but a few might have turned it off.
  • 🕸 Users might be stuck on old OS. that we no longer support. In that case we need to "soft-brick" the app
  • đŸĒĻ Supporting 6+ month old app versions in your backend
  • đŸĨļ Supporting multiple versions of your app you will result in bloated app code that is hard to iterate on
  • đŸ¤Ŧ Users will stop complaining about issues that are already fixed in the last update
  • đŸĨĩ Users will stop giving bad reviews because of errors with old software
  • đŸ”Ĩ Avoid crashes by staying compatible with the latest device API changes and platform updates
  • 🚨 Getting urgent security updates out to as many users as possible as quickly as possible


  • When the current app version is outdated. The user is prompted with a link to AppStore where the user can update
  • Two different alerts can be prompted. One where there is an option to update later and one where the user required to update
  • You can customize alert title, message and button text

Setting isRequired = true bricks the app until it's updated


For iOS:


For macOS:



import UpgradeAlert

guard Bundle.isBeta else { Swift.print("App is beta or simulator, skip checking for update"); return }
UpgradeAlert.config = UAConfig( // Config the alert
   isRequired: false, // Require users to update
   alertTitle: "Update required", // alert title
   alertMessage: { version in "Version: \(version) is out!" }, // alert msg
   laterButtonTitle: "Later", // skip button title
   updateButtonTitle: "Update Now" // go to appstore btn
UpgradeAlert.checkForUpdates { outcome in // check apple endpoint if there is a new update
   if case .err(let err) = outcome {
      Swift.print("Err: \(err.localizedDescription)")
   } else { // opportunity to track user action here with GA etc
      swift.print("Outcome: \(String(describing: outcome))") // notNow, notNeeded, appStoreOpened

For debugging

// UA prompt alert test. so we can see how it looks etc.
UpgradeAlert.showAlert(appInfo: .init(version: "1.0.1", trackViewUrl: ""))


Q: What is an Upgrade-Wall?
A: Upgrade-Wall or Update-Wall is a system/service that prevents mobile app users from using the app who are still using the older versions of the app.

Q: Why do we need Upgrade-Wall?
A: A required upgrade may be required when there are breaking changes in the backend API which will result in an app crash or when there are security issues in older apps and a new version of the app is released and you may want to require users to update to the newly released version. Also in cases where you want to encourage users to update your app to the newly released versions because you have launched a new cool feature and want users to explore and use it. In these scenarios, Upgrade-Wall is necessary to have in place.

Q: How to Implement Upgrade-Wall?
A: Upgrade-Wall can be implemented with two strategies, hard and soft Upgrade-Walls. A Hard Upgrade-Wall completely restricts the users from using the app and requires them to update the app. A Soft Upgrade-Wall offers greater flexibility to users, generally giving users the freedom to either update the app or skip the update to a later time. Both the strategies can be implemented by showing a popup/alert to users. When the user opens the app, Hard Upgrade-Wall will show a non-dismissible popup with only an update button. Users cannot skip the popup and will have only one option to update the app. On pressing the update button the app should open the play store or AppStore of the app from where the user can update the app to the latest version. Soft Upgrade-Wall will show a dismissible popup to the user with options to either update the app or skip. Users can skip and continue using the app. An example of Hard Upgrade-Wall and Soft Upgrade-Wall. You can skip the pain of building an Upgrade-Wall yourself and use solutions which are already there.


  • For macOS applicationDidBecomeActive will be called after dismissing the UpgradeAlert, make sure you init UpgradeAlert from another method or else it will create an inescapable loop. This does not apply for iOS.



This project is licensed under the terms of the MIT license. See the LICENSE file.


  • Swift Tools 5.6.0
View More Packages from this Author


  • None
Last updated: Sun Jun 02 2024 08:05:29 GMT-0900 (Hawaii-Aleutian Daylight Time)