Contents

markbattistella/sharekit

A lightweight Swift package that brings full-control sharing to SwiftUI by wrapping UIActivityViewController in a clean, composable API.

Overview

A lightweight Swift package that brings full-control sharing to SwiftUI by wrapping UIActivityViewController in a clean, composable API.

ShareKit is designed as a more flexible alternative to SwiftUI’s ShareLink, allowing you to:

  • Provide custom activity items
  • Exclude specific system share actions
  • Inject custom UIActivity instances
  • Receive detailed completion callbacks
  • Present a fully configured share sheet from SwiftUI

Requirements

  • iOS 17+
  • Swift 6.0+

Installation

Add ShareKit to your project using Swift Package Manager.

.package(url: "https://github.com/markbattistella/ShareKit.git", from: "26.2.21")

Then import it where needed:

import ShareKit

Core Concepts

Shareable

Shareable defines what gets shared.

public protocol Shareable {
    var activityItems: [Any] { get }
    var applicationActivities: [UIActivity]? { get }
    var excludedActivityTypes: [UIActivity.ActivityType]? { get }
}

Default implementations mean you only need to supply what you care about.

Callback

A completion handler that mirrors UIActivityViewController:

public typealias Callback = (
    _ activityType: UIActivity.ActivityType?,
    _ completed: Bool,
    _ returnedItems: [Any]?,
    _ error: Error?
) -> Void

Usage

1. Create a Shareable

struct ArticleShare: Shareable {
    let url: URL

    var activityItems: [Any] {
        [url]
    }

    var excludedActivityTypes: [UIActivity.ActivityType]? {
        [.assignToContact]
    }
}

2. Present with UIShareLink

UIShareLink(
    "Share Article",
    content: ArticleShare(url: articleURL)
) { activity, completed, _, error in
    if completed {
        print("Shared via \(activity?.rawValue ?? "unknown")")
    }
}

Using a Custom Label

UIShareLink(
    content: ArticleShare(url: articleURL),
    callback: { _, completed, _, _ in
        if completed {
            print("Done")
        }
    }
) {
    Label("Share", systemImage: "square.and.arrow.up")
}

Behaviour Notes

  • The share sheet is presented as a UIActivityViewController from the active key window's

topmost UIKit view controller.

  • This direct UIKit presentation avoids scene-hosting failures seen with some share extensions

when UIActivityViewController is wrapped in a SwiftUI .sheet.

  • SwiftUI updates while the sheet is open are ignored so duplicate share sheets are not stacked.
  • UIKit owns dismissal and calls the completion callback with the selected activity, completion

state, returned items, and error.

Because presentation is intentionally delegated to UIKit, ShareKit does not configure SwiftUI sheet detents, drag indicators, background interaction, or interactive-dismissal settings.

Contributing

Contributions are more than welcome. If you find a bug or have an idea for an enhancement, please open an issue or provide a pull request.

Please follow the code style present in the current code base when making contributions.

[!Note] Any pull requests need to have the title in the following format, otherwise it will be rejected.

YYYY-mm-dd - {title}
eg. 2023-08-24 - Updated README file

I like to track the day from logged request to completion, allowing sorting, and extraction of data. It helps me know how long things have been pending and provides structure.

Licence

ShareKit is released under the MIT license. See LICENCE for details.

Package Metadata

Repository: markbattistella/sharekit

Default branch: main

README: README.md