TTProgressHUD activity indicator swiftui

Activity Indicator

July 23, 2025

TTProgressHUD is a light weight HUD written in SwiftUI meant to display the progress of an ongoing task on iOS. TTProgressHUD (left) was designed to look as similar as possible to the Apple HUD (example from Podcast.app, right).

Installation

Xcode 11 and iOS 13 is required.

Swift Package Manager

Xcode: File -> Swift Packages -> Add Package Dependency
Paste https://github.com/honkmaster/TTProgressHUD

Manually

Drag TTProgressHUD.swift and TTProgressHUDConfig.swift into your project.

Usage

Use TTProgressHUD wisely! Only use it if you absolutely need to perform a task before taking the user forward. Bad use case examples: pull to refresh, infinite scrolling, sending message.

Import

Import the TTProgressHUD package:


                                              
                                                import TTProgressHUD

Instantiate and show the HUD view


                                              
                                                struct ContentView: View {

@State var hudVisible = true

@State var hudConfig = TTProgressHUDConfig()
var body: some View {

TTProgressHUD($hudVisible, config: hudConfig)

}

}

Customization

TTProgressHUD can be customized via the TTProgressHUDConfig struct. The default values were chosen so that TTProgressHUD looks as similar as possible to the Apple HUD.


                                              
                                                public init(

type: TTProgressHUDType = .loading,

title: String? = nil,

caption: String? = nil,

minSize: CGSize = CGSize(width: 100.0, height: 100.0),

cornerRadius: CGFloat = 12.0,

backgroundColor: Color = .clear,

foregroundColor: Color = Color(.systemBackground),

titleForegroundColor: Color = .primary,

captionForegroundColor: Color = .secondary,

shadowColor: Color = .clear,

shadowRadius: CGFloat = 0.0,

borderColor: Color = .clear,

borderWidth: CGFloat = 0.0,

lineWidth: CGFloat = 10.0,

imageViewSize: CGSize = CGSize(width: 100, height: 100),

imageViewForegroundColor: Color = .primary,

successImage: String = “checkmark.circle”,

warningImage: String = “exclamationmark.circle”,

errorImage: String = “xmark.circle”,

shouldAutoHide: Bool = false,

allowsTapToHide: Bool = false,

autoHideInterval: TimeInterval = 10.0,

hapticsEnabled: Bool = true

){…}

GitHub

View Github

#uiactivityindicatorview

YOU MIGHT ALSO LIKE...

August 28, 2025
SwiftUI

MijickPopups Hero

Popups Alerts Resizable Sheets Banners

August 27, 2025
SwiftUI

SwiftUI Tooltip

This package provides you with an easy way to show tooltips over any SwiftUI view, since Apple does not provide ...

August 27, 2025
SwiftUI
Uncategorized

SimpleToast for SwiftUI

SimpleToast is a simple, lightweight, flexible and easy to use library to show toasts / popup notifications inside iOS or ...

August 27, 2025
SwiftUI

SSToastMessage

Create Toast Views with Minimal Effort in SwiftUI Using SSToastMessage. SSToastMessage enables you to effortlessly add toast notifications, alerts, and ...

August 27, 2025
SwiftUI

ToastUI

A simple way to show toast in SwiftUI Getting Started • Documentation • Change Log