Getting started

PurchaseKit enables in-app purchases for Hotwire Native apps built with Rails.

It normalizes Apple and Google webhooks into a unified format, handles the complexity of subscription management, and provides drop-in bridge components for native purchases.

How it works

1. Your Rails app renders an HTML paywall
2. Hotwire Native displays it in your iOS/Android app
3. User taps subscribe, triggering StoreKit/Play Billing
4. Apple/Google send webhooks to PurchaseKit
5. PurchaseKit normalizes the data and forwards to your Rails app
6. Your app creates a subscription record and redirects the user

Quick start

1. Rails setup - Choose your integration:
   • Setup with Pay - Automatic Pay::Subscription creation (recommended)
   • Standalone setup - Custom subscription handling via callbacks
2. Native setup - Add the package to your Hotwire Native app:
   • iOS setup - Swift package for StoreKit
   • Android setup - Kotlin library for Google Play Billing
3. Store configuration - Create products and configure webhooks:
   • App Store Connect - For iOS apps
   • Google Play Console - For Android apps
4. Testing - Test locally before going live:
   • iOS testing - StoreKit Configuration files
   • Android testing - License testers

Reference

• Webhook payload - Normalized payload format and event types

Prerequisites

• A Rails application with Hotwire Native
• An Apple Developer account (for iOS)
• A Google Play Developer account (for Android)

Support

If you run into issues, check the testing guides for iOS or Android, or reach out at joe@purchasekit.com.