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

Installation

Add ShareKit to your project using Swift Package Manager.

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

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 modally using .sheet
Medium and large detents are enabled
Background interaction is disabled
Interactive dismissal is prevented to ensure callback delivery

These defaults are intentional and mirror common system share behaviour.

Why Not `ShareLink`?

ShareLink is excellent for simple cases, but it does not allow:

Excluding activity types
Injecting custom UIActivity subclasses
Accessing the full completion result
Controlling presentation behaviour

ShareKit exists specifically for those gaps.

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