Requirements
Server configuration contract and release compatibility
The server exposes key-only GET /api/v1/config for effective attribution visibility with a one-hour private TTL. A compatible SDK implementation must cache per key, default visible without fresh valid config, and allow only HTTPS links to upweight.dev. This documentation does not claim that config caching or the attribution footer is included in the currently published binary; SDK delivery requires a separate verified release. See SDK HTTP API.
Creation at the Free retained-post cap returns HTTP 403 feedback_limit_reached. A compatible client should show a friendly board-full message, not an owner billing upsell; older clients may show a generic error. Existing votes/comments remain available and no automatic charge occurs.
Use iOS 16+ and the Upweight product from package version 0.1.1. Xcode 27 / Swift 6.4 is the tested toolchain, not a proven minimum; older toolchains remain unverified.
Add the package
In Xcode, choose File → Add Package Dependencies and enter:
https://github.com/Dev-Lab-Phuket/upweight-swift-binarySelect version 0.1.1 and add the Upweight product to your app target. The public package distributes a binary framework. Release metadata and the package manifest were reviewed on 2026-10-17.
Configure Upweight
Create and copy a publishable SDK key. Replace the placeholders below and call configureUpweight() once when your app starts. The key is public in your app; never put RevenueCat secret credentials in the client.
import Upweight
@MainActor
func configureUpweight() {
Upweight.configure(key: "YOUR_UPWEIGHT_PUBLISHABLE_KEY")
Upweight.identify(appUserID: "YOUR_STABLE_APP_USER_ID")
}Identify the customer
Use the host app’s stable user ID for Upweight.identify(appUserID:). Use the same RevenueCat appUserID only when RevenueCat is connected. RevenueCat is optional. Switching IDs does not merge identities on the server; the publishable key does not prove the customer’s identity.
Present feedback
Present UpweightFeedbackView() from SwiftUI, for example in a sheet:
import SwiftUI
import Upweight
struct FeedbackButton: View {
@State private var showingFeedback = false
var body: some View {
Button("Feedback") { showingFeedback = true }
.sheet(isPresented: $showingFeedback) { UpweightFeedbackView() }
}
}Update and troubleshoot
Check the selected package version and target product if import Upweight fails. For connection problems, check the app’s key and user ID against the HTTP API. A revoked key breaks old binaries that still use it; release a rotated key before revoking the previous one.
Connection evidence is not a live health check. See Observe a connection and API errors. Shipped-update email is conditional; see delivery guidance.