summaryrefslogtreecommitdiff
path: root/Docs/StoreKit.txt
diff options
context:
space:
mode:
authorChristian Cleberg <[email protected]>2026-08-02 15:29:33 -0500
committerChristian Cleberg <[email protected]>2026-08-02 15:35:23 -0500
commitfbcb4113f110a7db9cf21d18510cb59c2e90ba23 (patch)
tree5a4afda3920f88f61698329c89771bda75fb8ced /Docs/StoreKit.txt
parent04fae8d7fb3726b4d1b4c2576ece04766d2afe74 (diff)
downloadhutch-main.tar.gz
hutch-main.tar.bz2
hutch-main.zip
convert readme to nfo; convert docs to txt; relicense to 0bsdHEADmain
Diffstat (limited to 'Docs/StoreKit.txt')
-rw-r--r--Docs/StoreKit.txt42
1 files changed, 42 insertions, 0 deletions
diff --git a/Docs/StoreKit.txt b/Docs/StoreKit.txt
new file mode 100644
index 0000000..0d2eb33
--- /dev/null
+++ b/Docs/StoreKit.txt
@@ -0,0 +1,42 @@
+# StoreKit Setup For Hutch
+
+Hutch uses StoreKit 2 for one-time consumable tip products:
+
+- `net.cleberg.hutch.tip.small`
+- `net.cleberg.hutch.tip.medium`
+- `net.cleberg.hutch.tip.large`
+
+## Xcode setup
+
+1. Open `Hutch.xcodeproj` in Xcode.
+2. Select the `Hutch` target.
+3. Open `Signing & Capabilities`.
+4. Confirm the App ID for `net.cleberg.Hutch` has the In-App Purchase capability enabled in the Apple Developer portal.
+5. In Xcode, choose `File > New > File... > StoreKit Configuration File`.
+6. Prefer a synced StoreKit file so Xcode pulls the real products from App Store Connect.
+7. Open `Product > Scheme > Edit Scheme...`.
+8. Select `Run`, then the `Options` tab.
+9. Set `StoreKit Configuration` to the synced `.storekit` file for local testing.
+
+## App Store Connect checks
+
+1. Confirm all three products exist with the exact product IDs listed above.
+2. Confirm each product has complete metadata, pricing, and availability.
+3. If a product is in `Developer Action Needed`, edit the rejected detail or cancel the pending change, then resubmit it.
+4. Wait up to one hour for metadata changes to propagate to sandbox.
+
+## Sandbox test checklist
+
+1. On a physical device, enable Developer Mode if needed.
+2. Sign in to a Sandbox Apple Account in `Settings > Developer > Sandbox Apple Account`.
+3. Install a development build from Xcode or a TestFlight build.
+4. Open `More > About`.
+5. Verify the tip products load with names and prices.
+6. Complete one purchase successfully.
+7. Use `Restore / Sync Purchases` to verify StoreKit can talk to the App Store account.
+8. Record this full flow for App Review when resubmitting.
+
+## Code locations
+
+- `Hutch/Views/More/TipStoreViewModel.swift`
+- `Hutch/Views/More/AboutView.swift`