Developer SDK · iOS & Android

Put a Reward Map
In Your App Today

Embed location-based drops, YayCoin rewards, and giveaway maps with one import. Production-ready UI, no backend to build, scales to millions of users.

Available as a Pro & Enterprise add-on · from $500/mo

import YaystackSDK
 
@main
struct MyApp: App {
init() {
Yaystack.initialize(token: "biz_xxx")
}
 
var body: some Scene {
WindowGroup {
YaystackMapView() // drop-in map
}
}
}
Yaystack SDK in action


Ship rewards, not infrastructure.
Building a geo-targeted rewards system takes months. Maps, eligibility, cooldowns, video upload, fraud. The Yaystack SDK hands you all of it in one import. Focus on what makes your app unique.
What You Get

A Complete Rewards Stack in One Import

Drop-In Map
One view, zero setup. Pins, callouts, locations, and the claim flow, all rendered for you.
Attach to Your Map
Already have an MKMapView or Google Map? Use the adapter. Your map stays, SDK powers the pins.
YayCoin Economy
Give users a loyalty currency they can spend on rewards. Balance updates automatically on every action.
Claims & Gift Cards
Paginated claim history with QR codes and gift-card PINs, ready to present in your rewards tab.
Theming
Match your brand. Colors, fonts, map style, corner radius, material blur. All configurable.
Account Linking
Let users connect their Yaystack profile with phone + OTP. Claims sync across apps automatically.
React-to-Claim
Users record a short reaction video to unlock a giveaway. Camera flow and upload handled for you.
Eligibility Handled
Distance, cooldown, expiration, entry caps, coin cost. The SDK checks everything before claim.
QR Redemption
Each claim has a scannable code. Your staff validates in-store with the Yaystack dashboard.
Install

One Package. Both Platforms.

Zero external dependencies. Native on both sides.

iOS SDK
iOS 16+ · Swift 5.9+ · SPM
Dependencies
None
Min Target
iOS 16.0
Android SDK
Android 8+ · Kotlin · Gradle
Dependencies
None
Min Target
API 26
How It Works

Four Steps to a Reward Experience

100 ft.
$5

Free Coffee Drop

Claim a free coffee on us.

00:00
Details

Your Business

1 · Drop the Map Into Your App

Add YaystackMapView anywhere in your SwiftUI or Compose layout. The SDK handles location permissions, pin rendering, the claim sheet, and distance checks automatically.

  • SwiftUI / UIKit / Compose / Views, all supported
  • Inline sheet or full modal callout styles
  • Map, pins, claim flow, and coin drops out of the box
import YaystackSDK
import MapKit
 
class MyMapVC: UIViewController {
let mapView = MKMapView()
let adapter = YaystackMapAdapter()
 
override func viewDidLoad() {
super.viewDidLoad()
view.addSubview(mapView)
adapter.attach(to: mapView)
}
}

2 · Or Attach to Your Existing Map

Already have your own map? Use YaystackMapAdapter to attach the SDK to your existing MKMapView. Your map stays. The SDK adds pins, claim sheets, and coin drops on top. All delegates are forwarded.

  • Works with UIKit and SwiftUI MapKit
  • Your delegates keep working, nothing is lost
  • Choose inline or sheet callout style per map
var theme = YaystackTheme()
theme.accentColor = .brown
theme.claimButtonColor = .brown
theme.headlineFont = .system(size: 18, weight: .bold)
theme.mapType = .standard
 
Yaystack.initialize(
token: "biz_xxx",
accountLinkingEnabled: true,
theme: theme
)

3 · Make It Yours

Customize every color, font, corner radius, and map style to match your brand. Users see your app, not ours.

  • Accent, claim button, directions, error, success colors
  • Headline / body / caption / button fonts
  • Standard, satellite, or hybrid map · material or solid cards
  • Update the theme at runtime, no re-init required
// After your auth succeeds
Yaystack.setUser(id: "user_456")
 
// Show claimed rewards
NavigationView {
YaystackClaimsListView()
}
 
// Read coin balance anywhere
let balance = Yaystack.shared.coinBalance

4 · Hand Users Their Rewards

Set the user ID once after sign-in. The SDK tracks claims, coin balance, gift cards, and expiration dates, presented in a ready-made rewards view or readable properties.

  • Paginated claims list with QR codes & gift-card PINs
  • Live coin balance · automatic updates on every action
  • Cooldowns & eligibility enforced server-side
  • Claim flow incl. react-to-claim video capture
Scale

Built for One User or Ten Million

The same SDK powers a single coffee shop and a national chain. Your infrastructure cost doesn't change as you grow. Ours scales for you.

< 1 day
Ship time
From install to live claim. Add the package, set your token, ship to TestFlight.
0
Servers to run
No backend, no auth stack, no geo queries. The SDK talks to our infrastructure.
Unlimited
Users
Scale from 10 beta testers to millions of MAUs. Same SDK, same API key.
Global
CDN & regions
Low-latency worldwide. Drops and claims served from the nearest edge.
Paired with the Dashboard

The SDK Renders. The Dashboard Controls.

Launch drops, configure recurring campaigns, set coin names, enforce cooldowns, all from the Yaystack business dashboard. The SDK reacts in real time.

Configure Recurring Drops
Schedule drops weekly, biweekly, or monthly. Your SDK users see fresh rewards without you shipping anything.
Brand Your Currency
Rename YayCoin to Stars, Points, Rewards. Upload a custom coin icon. The SDK uses it everywhere.
Tune Cooldowns
Set days between claims per API key. Fraud and abuse become a flag, not a rewrite.
Track Every Claim
Real-time analytics by giveaway, user, region. Export reports, debug at the claim level.
No Backend Burden
No auth stack, no geo queries, no storage for claim history. It's hosted, scaled, and secured.
Versioned Forever
Every SDK request is versioned. Breaking changes never reach production users unannounced.

Start Building Today

Get an API key, drop in the SDK, and ship a rewards experience your users actually open the app for.