Swiftpack.co - gh123man/SwiftUI-Refresher as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by gh123man.
gh123man/SwiftUI-Refresher 1.1.7
A native, customizable SwiftUI refresh control
⭐ïļ 70
🕓 4 days ago
.package(url: "https://github.com/gh123man/SwiftUI-Refresher.git", from: "1.1.7")


A customizable, native Swift UI refresh control for iOS 14+


  • the native SwiftUI refresh control only works on iOS 15+
  • the native UIKit refresh control works with ugly wrappers, but has buggy behavior with navigation views
  • I needed a refresh control that could accomodate an overlay (such as appearing on top of a static image)
  • This one is very customizable

See it in action

If you want to see it in a real app, check out dateit

Also works well with ScrollViewLoader


First add the package to your project.

import Refresher 

struct DetailsView: View {
    @State var refreshed = 0

    var body: some View {
        ScrollView {
            Text("Refreshed: \(refreshed)")
        .refresher { // Called when pulled to refresh
            await Task.sleep(seconds: 2)
            refreshed += 1


  • async/await compatible - even on iOS 14
  • completion callback also supported for DispatchQueue operations
  • .default and .system styles (see below for details)
  • customizable refresh spinner (see below for example)

Examples and usage

See: Examples for a full sample project with multiple implementations

Navigation view


Refresher plays nice with both Navigation views and navigation subviews.


Detail view with overlay

Refresher supports an overlay mode to show a refresh indicator over fixed position content

.refresher(overlay: true)


System style

Refresher's default animation is designed to be more flexible than the system animation style. If you want Refresher to behave more like they system refresh control, you can change the style:

.refresher(style: .system) { done in



Refresher can take a custom spinner view. Your custom view will get a binding instances of the refresher state that contains useful properties for managing animations and translations. Here is a custom spinner that shows an emoji:

public struct EmojiRefreshView: View {
    @Binding var state: RefresherState
    @State private var angle: Double = 0.0
    @State private var isAnimating = false
    var foreverAnimation: Animation {
        Animation.linear(duration: 1.0)
            .repeatForever(autoreverses: false)
    public var body: some View {
        VStack {
            switch state.mode {
            case .notRefreshing:
                    .onAppear {
                        isAnimating = false
            case .pulling:
                    .rotationEffect(.degrees(360 * state.dragPosition))
            case .refreshing:
                    .rotationEffect(.degrees(self.isAnimating ? 360.0 : 0.0))
                        .onAppear {
                            withAnimation(foreverAnimation) {
                                isAnimating = true

Add the custom refresherView:

.refresher(refreshView: EmojiRefreshView.init ) { done in


Completion handler

If you prefer to call a completion to stop the refresher:

.refresher(style: .system) { done in
    DispatchQueue.main.asyncAfter(deadline: .now() + .seconds(1)) {
        refreshed += 1
        done() // Call done to stop the refresher


Stars: 70
Last commit: 5 days ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Release Notes

5 days ago

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics