krz/hutch

 1# StoreKit Setup For Hutch
 2
 3Hutch uses StoreKit 2 for one-time consumable tip products:
 4
 5- `net.cleberg.hutch.tip.small`
 6- `net.cleberg.hutch.tip.medium`
 7- `net.cleberg.hutch.tip.large`
 8
 9## Xcode setup
10
111. Open `Hutch.xcodeproj` in Xcode.
122. Select the `Hutch` target.
133. Open `Signing & Capabilities`.
144. Confirm the App ID for `net.cleberg.Hutch` has the In-App Purchase capability enabled in the Apple Developer portal.
155. In Xcode, choose `File > New > File... > StoreKit Configuration File`.
166. Prefer a synced StoreKit file so Xcode pulls the real products from App Store Connect.
177. Open `Product > Scheme > Edit Scheme...`.
188. Select `Run`, then the `Options` tab.
199. Set `StoreKit Configuration` to the synced `.storekit` file for local testing.
20
21## App Store Connect checks
22
231. Confirm all three products exist with the exact product IDs listed above.
242. Confirm each product has complete metadata, pricing, and availability.
253. If a product is in `Developer Action Needed`, edit the rejected detail or cancel the pending change, then resubmit it.
264. Wait up to one hour for metadata changes to propagate to sandbox.
27
28## Sandbox test checklist
29
301. On a physical device, enable Developer Mode if needed.
312. Sign in to a Sandbox Apple Account in `Settings > Developer > Sandbox Apple Account`.
323. Install a development build from Xcode or a TestFlight build.
334. Open `More > About`.
345. Verify the tip products load with names and prices.
356. Complete one purchase successfully.
367. Use `Restore / Sync Purchases` to verify StoreKit can talk to the App Store account.
378. Record this full flow for App Review when resubmitting.
38
39## Code locations
40
41- `Hutch/Views/More/TipStoreViewModel.swift`
42- `Hutch/Views/More/AboutView.swift`