@superwall/cli 2.0.0 → 2.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/README.md +3 -2
  2. package/dist/{apple-CkKlHBZ9.js → apple-BHbX0jbn.js} +13 -13
  3. package/dist/auth.d.ts +1 -1
  4. package/dist/auth.js +3 -3
  5. package/dist/{billing-XCZU_T46.js → billing-4zhIBFRQ.js} +3 -3
  6. package/dist/{bind-drne__Ys.js → bind-CHLHmxgA.js} +4 -4
  7. package/dist/{build-Gpdq5QXP.js → build-5PQeSnNN.js} +6 -6
  8. package/dist/{client-DP6Rc0t_.js → client-BIvOmWPC.js} +7 -3
  9. package/dist/{create-BBrtgUgS.js → create-BSNIFsnN.js} +6 -6
  10. package/dist/{create-Cwc3SRWJ.js → create-VK-pNfN7.js} +23 -23
  11. package/dist/create-oj3zXvHZ.js +19 -0
  12. package/dist/{doctor-C9ldpPFC.js → doctor-9JS96QkX.js} +6 -6
  13. package/dist/{drivers-DNrx4LWA.js → drivers-BamBJ10Y.js} +3 -3
  14. package/dist/entry.js +20 -21
  15. package/dist/{environment-DF1qKlny.js → environment-eV7LEnSN.js} +15 -2
  16. package/dist/{existing-78LWSsqS.js → existing-C8dSYHGk.js} +2 -2
  17. package/dist/{held-Cy8Wl4D1.js → held-BMisHn8F.js} +6 -6
  18. package/dist/held-DeJW2gUk.js +16 -0
  19. package/dist/{integrate-DcJhpXy8.js → integrate-VWtTNPCr.js} +22 -22
  20. package/dist/login-2JHCG6c1.js +16 -0
  21. package/dist/{login-D0lh3_JI.js → login-BimbukE5.js} +5 -5
  22. package/dist/{login-B2TsCE2H.js → login-BmwG14LC.js} +1 -1
  23. package/dist/{lookup-D-nmmAbw.js → lookup-k9EeOiZr.js} +2 -2
  24. package/dist/{migrate-Cfec564E.js → migrate-C86h6jeF.js} +22 -22
  25. package/dist/{notification-url-YDbq6FMA.js → notification-url-BVaTgWZ5.js} +2 -2
  26. package/dist/{open-Ba2vBl1_.js → open-0tDCQOXC.js} +10 -10
  27. package/dist/{org-D0g_q3mv.js → org-DUwdrKPV.js} +2 -2
  28. package/dist/{paths-DxSLdpOI.js → paths-BCbjCLP5.js} +1 -1
  29. package/dist/{playbook-DIeb7hne.js → playbook-oov9yV0q.js} +10 -10
  30. package/dist/{promote-COD4fYdz.js → promote-DPGPamkE.js} +16 -16
  31. package/dist/push-Chp21y3a.js +22 -0
  32. package/dist/{push-CncywhkQ.js → push-Cz4lJ8Qd.js} +27 -14
  33. package/dist/{registry-DSrosOYs.js → registry-CTczUigi.js} +525 -179
  34. package/dist/{resources-Dqr01Dep.js → resources-B1qKDVXd.js} +18 -6
  35. package/dist/{run-C9qg_QlC.js → run-DTPsVmFw.js} +2 -2
  36. package/dist/scan-B1SkkUi7.js +4 -0
  37. package/dist/{scan-DLrsrFS9.js → scan-Bb48xZqB.js} +1 -1
  38. package/dist/{scope-V336uz8j.js → scope-B6UYGuwn.js} +4 -4
  39. package/dist/{selection-Rdw-ZUoG.js → selection-BbNk9r1q.js} +10 -4
  40. package/dist/server-CwrZ-I1r.js +22 -0
  41. package/dist/{server-D0tGG8C4.js → server-EYBMKAG1.js} +10 -8
  42. package/dist/{session-D_nEWKXT.js → session-Crg9X-FI.js} +41 -13
  43. package/dist/session-DItGa4z0.js +6 -0
  44. package/dist/{session-CFAmMhem.js → session-xG9E8J2N.js} +1 -1
  45. package/dist/skills/superwall-framework/SKILL.md +43 -7
  46. package/dist/skills/superwall-framework/references/cli.md +1 -0
  47. package/dist/skills/superwall-framework/references/examples.md +1 -0
  48. package/dist/skills/superwall-framework/references/layout.md +34 -1
  49. package/dist/skills/superwall-framework/references/migrate-from-editor.md +16 -3
  50. package/dist/{skills-BvFOa4y6.js → skills-BdMKE2uO.js} +5 -4
  51. package/dist/{skills-DMG4bpKk.js → skills-Dg3k6TRC.js} +8 -8
  52. package/dist/{spinner-CneRK5rk.js → spinner-Ba3XhlMb.js} +3 -3
  53. package/dist/{storage-s2Dnz-yl.js → storage-DIkYajce.js} +1 -1
  54. package/dist/{storekit-yY_kS2iR.js → storekit-C2UzIIMs.js} +3 -3
  55. package/dist/storekit-DHNxDDpA.js +16 -0
  56. package/dist/{telemetry-DtG92m5O.js → telemetry-CVP8O6Y3.js} +1 -1
  57. package/dist/{token-DzRh7dI1.js → token-IWv2httm.js} +1 -1
  58. package/dist/tools-skills/animate-onboarding/SKILL.md +467 -0
  59. package/dist/tools-skills/animate-onboarding/references/engine.md +494 -0
  60. package/dist/tools-skills/animate-onboarding/references/framework/Question.tsx +71 -0
  61. package/dist/tools-skills/animate-onboarding/references/framework/README.md +40 -0
  62. package/dist/tools-skills/animate-onboarding/references/framework/answers.ts +19 -0
  63. package/dist/tools-skills/animate-onboarding/references/framework/flow.ts +80 -0
  64. package/dist/tools-skills/animate-onboarding/references/framework/handoffs.ts +869 -0
  65. package/dist/tools-skills/animate-onboarding/references/framework/layout.tsx +113 -0
  66. package/dist/tools-skills/animate-onboarding/references/framework/motion.css +559 -0
  67. package/dist/tools-skills/animate-onboarding/references/framework/useStoryRouter.ts +48 -0
  68. package/dist/tools-skills/animate-onboarding/references/handoffs.md +375 -0
  69. package/dist/tools-skills/animate-onboarding/references/imageReady.ts +92 -0
  70. package/dist/tools-skills/animate-onboarding/references/morphFrame.ts +356 -0
  71. package/dist/tools-skills/animate-onboarding/references/performance.md +41 -0
  72. package/dist/tools-skills/animate-onboarding/references/web-runtime/README.md +17 -0
  73. package/dist/tools-skills/animate-onboarding/references/web-runtime/handoffs.ts +858 -0
  74. package/dist/tools-skills/animate-onboarding/references/web-runtime/story-motion.css +301 -0
  75. package/dist/tools-skills/mobile-design/SKILL.md +447 -0
  76. package/dist/tools-skills/mobile-design/references/responsive.md +162 -0
  77. package/dist/tools-skills/onboarding-questions/SKILL.md +231 -0
  78. package/dist/tools-skills/onboarding-questions/references/arpu-questions.md +139 -0
  79. package/dist/tools-skills/onboarding-questions/references/craft.md +142 -0
  80. package/dist/tools-skills/onboarding-questions/references/example-reflective.md +117 -0
  81. package/dist/tools-skills/superwall/SKILL.md +263 -0
  82. package/dist/tools-skills/superwall/references/api.md +303 -0
  83. package/dist/tools-skills/superwall/references/asa.md +166 -0
  84. package/dist/tools-skills/superwall/references/asc.md +95 -0
  85. package/dist/tools-skills/superwall/references/dashboard-links.md +57 -0
  86. package/dist/tools-skills/superwall/references/data-analytics.md +896 -0
  87. package/dist/tools-skills/superwall/references/docs.md +51 -0
  88. package/dist/tools-skills/superwall/references/sdk-integration.md +104 -0
  89. package/dist/tools-skills/superwall/references/sdk-source.md +18 -0
  90. package/dist/tools-skills/superwall/workflows/dashboard/playbook.md +76 -0
  91. package/dist/tools-skills/superwall/workflows/dashboard/setup.md +100 -0
  92. package/dist/tools-skills/superwall/workflows/integrate/android.md +292 -0
  93. package/dist/tools-skills/superwall/workflows/integrate/expo.md +272 -0
  94. package/dist/tools-skills/superwall/workflows/integrate/flutter.md +285 -0
  95. package/dist/tools-skills/superwall/workflows/integrate/ios.md +314 -0
  96. package/dist/tools-skills/superwall/workflows/integrate/playbook.md +83 -0
  97. package/dist/tools-skills/superwall/workflows/integrate/react-native.md +246 -0
  98. package/dist/tools-skills/superwall/workflows/migrate/adapty.md +229 -0
  99. package/dist/tools-skills/superwall/workflows/migrate/playbook.md +78 -0
  100. package/dist/tools-skills/superwall/workflows/migrate/qonversion.md +227 -0
  101. package/dist/tools-skills/superwall/workflows/migrate/revenuecat.md +414 -0
  102. package/dist/tools-skills/superwall/workflows/placements/android.md +175 -0
  103. package/dist/tools-skills/superwall/workflows/placements/expo.md +161 -0
  104. package/dist/tools-skills/superwall/workflows/placements/flutter.md +139 -0
  105. package/dist/tools-skills/superwall/workflows/placements/ios.md +165 -0
  106. package/dist/tools-skills/superwall/workflows/placements/playbook.md +69 -0
  107. package/dist/tools-skills/superwall/workflows/placements/react-native.md +145 -0
  108. package/dist/tools-skills/superwall/workflows/placements/strategy.md +222 -0
  109. package/dist/tools-skills/superwall/workflows/review/android.md +120 -0
  110. package/dist/tools-skills/superwall/workflows/review/expo.md +100 -0
  111. package/dist/tools-skills/superwall/workflows/review/flutter.md +99 -0
  112. package/dist/tools-skills/superwall/workflows/review/ios.md +108 -0
  113. package/dist/tools-skills/superwall/workflows/review/playbook.md +70 -0
  114. package/dist/tools-skills/superwall/workflows/review/react-native.md +100 -0
  115. package/dist/tools-skills/superwall-editor/SKILL.md +113 -0
  116. package/dist/tools-skills/superwall-editor/references/cli.md +135 -0
  117. package/dist/tools-skills/superwall-editor/references/design.md +51 -0
  118. package/dist/tools-skills/superwall-editor/references/native-elements.md +171 -0
  119. package/dist/tools-skills/superwall-editor/references/workflow.md +65 -0
  120. package/dist/tools-skills/superwall-editor/scripts/sw-editor.sh +662 -0
  121. package/dist/tools-skills/wwdc/SKILL.md +22 -0
  122. package/dist/tools-skills/wwdc/references/docs.md +52 -0
  123. package/dist/tools-skills/wwdc/scripts/wwdc.sh +266 -0
  124. package/dist/tools.d.ts +4 -2
  125. package/dist/tools.js +561 -161
  126. package/dist/{upgrade-Bt4Ouw1y.js → upgrade-1t3aQUxh.js} +1 -1
  127. package/dist/{upgrade-Cqy5orjb.js → upgrade-DLf0LJDh.js} +2 -2
  128. package/package.json +2 -2
  129. package/dist/create-Yvf2gStM.js +0 -19
  130. package/dist/held-Ddw1XSsr.js +0 -16
  131. package/dist/kinds-GFXB3sYu.js +0 -11
  132. package/dist/login-BoBe8Psl.js +0 -16
  133. package/dist/push-CtD4FZQV.js +0 -22
  134. package/dist/scan-Cv5uOwVY.js +0 -4
  135. package/dist/send-BxD9yf6F.js +0 -150
  136. package/dist/server-z1LH94R_.js +0 -22
  137. package/dist/session-1AV_Bs_d.js +0 -6
  138. package/dist/storekit-DafAnGkM.js +0 -16
  139. /package/dist/{devtools-ByZ6XYnn.js → devtools-pBl_vt03.js} +0 -0
  140. /package/dist/{reports-DdPq4blM.js → reports-D_qbl7_u.js} +0 -0
  141. /package/dist/{screenshot-file-0UETadF8.js → screenshot-file-tVBfUEIi.js} +0 -0
  142. /package/dist/{storage-DYvmIOHa.d.ts → storage-CerJ5KLP.d.ts} +0 -0
@@ -0,0 +1,222 @@
1
+ # Superwall placement strategy - the playbook
2
+
3
+ This is the framework-agnostic strategy guide: **where** to put placements and
4
+ **why**. Read this first, then read your framework's reference (`ios.md`, `android.md`, `expo.md`, `react-native.md`, `flutter.md`) for the exact API. The API is the
5
+ easy part. Deciding what to instrument and which actions should remain remotely
6
+ gateable is the craft that makes an app's monetization flexible.
7
+
8
+ Most of section 1 (register everything, gate remotely) is stated in the Superwall
9
+ docs. Sections 2-4 and 6 are **recommended practice** - craft distilled from how
10
+ well-instrumented apps are built, not verbatim doc rules. They're written as
11
+ imperatives because they're what you should do, not because a doc mandates them.
12
+
13
+ ## 1. The mental model
14
+
15
+ **Register every potentially-monetizable moment. The campaign decides what
16
+ happens.** A placement is a named event you fire at a boundary; whether it shows a
17
+ paywall, gates a feature, enters a holdout, or does nothing is decided remotely in
18
+ the dashboard - evaluated on-device, no network delay. The docs are explicit:
19
+ _"we strongly recommend registering all core functionality in order to remotely
20
+ configure which features you want to gate - without an app update."_ And more
21
+ broadly: _"Register. Everything."_ - even analytics events with no feature block,
22
+ so you can retroactively attach a paywall almost anywhere.
23
+
24
+ Why this matters:
25
+
26
+ - **Placements are free experimentation surface.** An unassigned placement does
27
+ nothing until you route it in a campaign. Registering it costs ~nothing at
28
+ runtime. So instrument generously now; decide monetization later, remotely.
29
+ - **Everything you don't register is frozen.** To monetize a moment you never
30
+ instrumented, you must ship an app update and wait for adoption. Every
31
+ un-registered premium moment is a monetization lever you can't pull.
32
+ - **The dashboard is where decisions live and change.** Show/hide a paywall,
33
+ gate/un-gate a feature, target an audience, pause for a free weekend, run an
34
+ A/B test - all without a release. That only works if the placement already
35
+ exists in the binary.
36
+
37
+ ### Keep intentionally remote gates inside the registration callback
38
+
39
+ When a placement is intentionally responsible for deciding access, do not wrap it
40
+ in a hand-rolled `if subscribed { … } else { showPaywall() }`.
41
+
42
+ ```
43
+ // WRONG - freezes your monetization logic into this app release
44
+ if (user.hasActiveSubscription) {
45
+ startWorkout();
46
+ } else {
47
+ presentPaywall();
48
+ }
49
+
50
+ // RIGHT - the campaign decides; subscribed users are filtered automatically
51
+ register(placement: "start_workout") {
52
+ startWorkout();
53
+ }
54
+ ```
55
+
56
+ Why that split gate is a trap:
57
+
58
+ - **Subscribed/entitled users are filtered automatically.** When you register a
59
+ placement, Superwall evaluates subscription state itself: an entitled user's
60
+ `feature` closure runs immediately with no paywall. You do not need - and must
61
+ not add - your own check for this.
62
+ - **A code check hard-codes the decision.** "Gated vs non-gated," "who sees it,"
63
+ "show it at all" become properties of a shipped binary instead of dashboard
64
+ settings. You lose remote configuration, A/B testing, holdouts, and the free
65
+ weekend - the entire reason to use Superwall.
66
+ - **It double-gates.** Your `if` plus the paywall's own gating means even a
67
+ Non-Gated experiment can't let users through. It silently breaks experiments.
68
+
69
+ **Do not turn this into a ban on subscription-state reads.** Superwall documents
70
+ subscription status and entitlements for app state and UI, and an app may have
71
+ deliberate access rules outside a placement. Flag a code-side check only when the
72
+ same action is meant to be remotely gated and the check demonstrably prevents the
73
+ campaign or feature callback from controlling it. For paywall-specific UI, use
74
+ `getPresentationResult` to see what would happen without presenting.
75
+
76
+ ## 2. Common placement candidates
77
+
78
+ Use these as prompts, not requirements. Select the moments that fit the app's real
79
+ product and monetization model, named for the moment rather than the button.
80
+
81
+ | Placement | Fires when | Why it's core |
82
+ | ------------------------------ | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
83
+ | `onboarding_complete` | User finishes onboarding | A common high-intent moment when the app has a meaningful onboarding flow. |
84
+ | one per premium feature gate | User taps a paid feature (`unlock_export`, `start_workout`, `remove_watermark`) | The direct "I want this paid thing" signal. `verb_noun`. One per distinct feature, not one per button that reaches it. |
85
+ | a limit/quota-reached moment | Free allowance exhausted (`hit_export_limit`, `scan_limit_reached`) | Catches users at peak demonstrated need. Distinct from the feature gate - the user already used it free and wants more. |
86
+ | `upgrade_tapped` | User taps an explicit "Go Pro" / upgrade entry in settings or a banner | Self-selected high intent. Route to your fullest paywall. |
87
+ | `app_launch` / `session_start` | Cold launch / new session (both are auto-registered standard placements) | Broad-reach surface for win-back or a hard gate on relaunch. Usually left **campaign-off** until you deliberately want it - powerful but blunt. |
88
+ | a win-back / discount surface | User declines, churns, or hits a re-engagement point | Where you route a discounted offer. Often driven by standard placements like `paywall_decline` or `transaction_abandon`. |
89
+ | a non-purchase screen | Version check fails, rating or notification ask, announcement (`update_required`, `rate_app`, `whats_new`) | Placements are not only for paywalls. Any screen the team wants to change without a release is a surface behind a placement; the campaign decides whether it shows at all. |
90
+
91
+ The `app_launch`/`session_start` and win-back rows may remain unrouted until
92
+ there is a deliberate reason to present.
93
+ That is valid: instrumentation can exist before campaign strategy.
94
+
95
+ Superwall also **auto-registers** standard placements you can route without any
96
+ code: `app_install`, `app_launch`, `session_start`, `deepLink_open`,
97
+ `survey_response`, `paywall_decline`, `transaction_abandon`, and more. Prefer
98
+ these for lifecycle moments instead of inventing your own.
99
+
100
+ ## 3. App-type playbook
101
+
102
+ Map the app to its type, then instrument that type's premium surface. Names below
103
+ are examples - keep your app's real feature vocabulary.
104
+
105
+ | App type | The paid surface | Placements (moment that fires them) |
106
+ | -------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
107
+ | Photo/video editor | Export, save, watermark removal, premium filters/tools | `unlock_export` (tap export/save), `remove_watermark` (tap watermark toggle), `unlock_premium_filter` (select locked filter), `hit_export_limit` (free export quota hit) |
108
+ | Fitness | Workout start, plan unlock, history/stats | `start_workout` (tap a locked workout), `unlock_plan` (choose a premium plan), `view_workout_history` (open stats/history), `onboarding_complete` |
109
+ | Productivity/utility | Nth document/scan/task, advanced features, cross-device sync | `hit_document_limit` (create Nth doc), `unlock_advanced_feature` (tap a pro tool), `enable_sync` (toggle cross-device sync), `scan_limit_reached` |
110
+ | Content/media | Premium article/episode, offline download | `unlock_premium_content` (tap a locked article/episode), `download_offline` (tap download), `session_start` (metered-paywall relaunch) |
111
+ | Dating/social | Likes limit, see-who-liked, boosts | `likes_limit_reached` (out of free likes), `see_who_liked` (tap the blurred list), `unlock_boost` (tap boost), `unlock_super_like` |
112
+ | AI apps | Generation quota, premium models | `generation_limit_reached` (free generations used up), `unlock_premium_model` (select a locked model), `unlock_faster_generation`, `onboarding_complete` |
113
+
114
+ For each: pick the 3-6 moments that actually correspond to money, name them for
115
+ the moment, and register at the point of intent (the tap/attempt), not on a
116
+ timer or a screen you happen to have.
117
+
118
+ ## 4. The audit method (for reviews)
119
+
120
+ When reviewing an existing app's placements, work in this order. Don't start from
121
+ the placements that exist - start from the money.
122
+
123
+ 1. **Enumerate the premium surface first.** List what is actually paid or
124
+ intended to be paid: every gated feature, every quota, every "Pro" affordance,
125
+ the upgrade entries, the end of onboarding. This is the ground truth to
126
+ measure against - build it before looking at code.
127
+ 2. **Map each paid surface → placement.** For every item in step 1, find the
128
+ `register`/`registerPlacement` call that covers it (use the grep in your
129
+ framework reference).
130
+ 3. **Then flag the four failure modes:**
131
+ - **Surface with no placement** → missed revenue. A paid feature you can never
132
+ attach a paywall to without an app update. The highest-value finding.
133
+ - **Expected presenter with no campaign** → presentation gap. Cross-check the
134
+ registered names that are supposed to show or gate now against `superwall
135
+ campaigns list --project <id> --app <id> --json`. Analytics-only, future, and intentionally paused
136
+ placements may be unrouted without being noise.
137
+ - **Conflicting code-side entitlement check** → grep for
138
+ subscription/entitlement reads at call sites (`subscriptionStatus`,
139
+ `hasActiveSubscription`, `getEntitlements`, `CustomerInfo`, `isPro`). Any that
140
+ gate the same action that Superwall is intended to control may belong inside
141
+ `feature`. Reads that drive UI/app state or deliberate non-placement access
142
+ rules are valid and must not be reported from grep alone.
143
+ - **Naming drift / typos** → `Start_Workout` vs `start_workout`, `unlockExport`
144
+ vs `unlock_export`, singular/plural drift. A typo means the campaign silently
145
+ never matches. Also flag campaign placements that nothing in code registers.
146
+
147
+ Report findings as: surface → expected placement → status (present / missing /
148
+ unrouted-but-expected / conflicting gate / misnamed). Keep analytics/future
149
+ instrumentation out of the issue list.
150
+
151
+ ## 5. Gate depth: hard gate vs soft gate
152
+
153
+ Every placement is either a **hard gate** or a **soft/non-gated** surface. This is
154
+ set per-paywall in the dashboard (editor → General → Feature Gating), _not_ in
155
+ code - the same `register` call serves both. But you decide the _intent_ when you
156
+ place it, so know which you mean.
157
+
158
+ - **Hard gate (paid-only feature).** The work lives inside the `feature` closure,
159
+ and the paywall is set to **Gated**. Per the docs, a Gated paywall runs the
160
+ `feature` closure _"only if the user is already paying or if they begin
161
+ paying."_ Dismiss without buying → feature blocked. Use for genuinely
162
+ paid-only capability: the export, the premium generation, the unlimited scan.
163
+
164
+ - **Soft gate (show paywall, let them through).** Same code, paywall set to
165
+ **Non-Gated**: the `feature` closure runs _"when the paywall is dismissed
166
+ (whether they paid or not)."_ Use for upsell moments where you want to surface
167
+ the offer but not block the user - a nudge at `session_start`, a value reminder
168
+ after `onboarding_complete`.
169
+
170
+ In both cases, when no campaign matches or the user is already entitled, the
171
+ feature runs immediately with no paywall and no network call. The important
172
+ consequence: **put the paywalled work in the `feature` closure either way.** That
173
+ keeps the gated/non-gated choice remote. If you run the work _after_ the register
174
+ call unconditionally, you've made it non-gated in code and can never harden it.
175
+
176
+ ## 6. How many placements?
177
+
178
+ There is no healthy universal count. A broad analytics bridge may intentionally
179
+ produce many placement names, while a focused app may have only a few dedicated
180
+ monetization placements. Judge clarity and usefulness, not totals.
181
+
182
+ For dedicated monetization keys, each should express a distinct moment. Use
183
+ `params` to distinguish variants (`{ source: "toolbar" }` vs `{ source: "menu" }`)
184
+ when they share campaign intent. Do not collapse an intentional analytics taxonomy
185
+ just to make the placement list shorter.
186
+
187
+ ## 7. Naming rules
188
+
189
+ - **Preserve the app's established taxonomy.** The SDK does not enforce casing,
190
+ and the docs use multiple styles. `snake_case` is a reasonable choice for new
191
+ dedicated keys, but analytics bridges should retain their existing event names.
192
+ - **Name the user moment, not the UI widget.** `unlock_export`, not
193
+ `export_button_tapped`; `hit_export_limit`, not `alert_shown`. The widget can
194
+ change; the intent is stable.
195
+ - **`verb_noun` for feature gates.** `start_workout`, `unlock_export`,
196
+ `remove_watermark`, `download_offline`. It reads as what the user is trying to
197
+ do.
198
+ - **Stable forever.** A placement name is a routing key shared with the dashboard
199
+ campaign. Renaming it silently breaks routing - the campaign keeps looking for
200
+ the old name and the new one fires nothing. Treat renames as breaking changes:
201
+ add the new campaign mapping before shipping the rename, or don't rename.
202
+ - **Never rename for style alone.** Consistency is not worth breaking campaign
203
+ routing or historical analytics.
204
+ - **Reuse, never duplicate.** Before adding a name, check existing placements
205
+ (`superwall campaigns list --project <id> --app <id> --json`) and existing `register` calls. Two names for
206
+ one intent split your data and double your campaign work.
207
+
208
+ ## Dashboard routing (required for presentation, not instrumentation)
209
+
210
+ A registered placement does not present a paywall until a campaign routes it.
211
+ Campaigns hold one or more placements and use audience filters to decide what each
212
+ user sees. Analytics-only or future placements can remain unrouted intentionally.
213
+
214
+ ```bash
215
+ superwall campaigns list --project <id> --app <id> --json
216
+ superwall campaigns create "Editor upgrade paywall" unlock_export --project <id> --app <id> --json
217
+ superwall campaigns placement <campaignId> another_placement --project <id> --app <id> --json
218
+ ```
219
+
220
+ Rule of thumb: one campaign per distinct paywall surface/decision (onboarding,
221
+ settings upgrade, win-back), routing the placements that belong to it - not one
222
+ campaign per trigger, and no duplicates.
@@ -0,0 +1,120 @@
1
+ # Review Superwall - Android / Kotlin
2
+
3
+ You are reviewing an existing Android integration using
4
+ `com.superwall.sdk:superwall-android`. Complete the whole checklist;
5
+ placements are one part of it.
6
+
7
+ ## Checklist
8
+
9
+ - [ ] SDK dependency in the app module and `minSdk` (23+ on SDK 2.8.0+)
10
+ - [ ] one early `configure` call in `Application.onCreate()` and the intended public key/options
11
+ - [ ] purchase controller, restore flow, and subscription-status ownership
12
+ - [ ] identity, reset, and user attributes
13
+ - [ ] intent filters / App Links and `handleDeepLink`
14
+ - [ ] conditional Web Checkout redemption readiness
15
+ - [ ] placements, feature lambdas, campaign coverage, and standard placements
16
+ - [ ] products, entitlements, paywalls, campaigns, and Play Console product IDs
17
+ - [ ] delegate/analytics and a build or test verification path
18
+
19
+ ## Docs access
20
+
21
+ ```bash
22
+ curl -sL https://superwall.com/docs/android/llms.txt
23
+ curl -sL https://superwall.com/docs/android/quickstart/configure.md
24
+ curl -sL https://superwall.com/docs/android/guides/advanced-configuration.md
25
+ curl -sL https://superwall.com/docs/android/quickstart/tracking-subscription-state.md
26
+ curl -sL https://superwall.com/docs/android/quickstart/user-management.md
27
+ curl -sL https://superwall.com/docs/android/guides/handling-deep-links.md
28
+ curl -sL https://superwall.com/docs/android/guides/web-checkout.md
29
+ curl -sL https://superwall.com/docs/android/quickstart/feature-gating.md
30
+ ```
31
+
32
+ ## 1. SDK and configuration
33
+
34
+ Inspect the app module's `build.gradle(.kts)` and `gradle/libs.versions.toml`
35
+ for `com.superwall.sdk:superwall-android` and its version. Confirm
36
+ `Superwall.configure(...)` (or `configureSuperwall { }`) runs once in
37
+ `Application.onCreate()`, declared via `android:name` in the manifest, not in an
38
+ Activity or a composable. A `pk_` key is public and may be inlined; verify it
39
+ belongs to the current app rather than treating its presence as a secret leak.
40
+ Read any `SuperwallOptions` and judge intentional behavior, not mere
41
+ customization.
42
+
43
+ ## 2. Purchases, restores, and subscription state
44
+
45
+ Infer exactly which path the app uses:
46
+
47
+ - **Default:** no `PurchaseController` is correct; Superwall owns purchases,
48
+ restores, and subscription status through Play Billing.
49
+ - **RevenueCat/custom:** the controller must implement `purchase(activity,
50
+ product, basePlanId, offerId)` and `restorePurchases()`, return accurate
51
+ `PurchaseResult` / `RestorationResult` cases, and keep
52
+ `Superwall.instance.setSubscriptionStatus(...)` synchronized as entitlements
53
+ change. RevenueCat in observer mode is the documented alternative; do not
54
+ flag it as missing a controller.
55
+
56
+ Reading `subscriptionStatus` (a `StateFlow`), `.value`, customer info, or
57
+ entitlements is a documented way to drive app state and UI. Report a problem
58
+ only when two sources contradict each other, status remains `Unknown`, restore
59
+ is missing, or access logic demonstrably bypasses the intended purchase
60
+ architecture.
61
+
62
+ Compare dashboard products/entitlements with Play Console product IDs and base
63
+ plans when CLI access exists. Do not label an auth or network failure as broken
64
+ subscriptions; put it under **Not verified**.
65
+
66
+ ## 3. Identity and attributes
67
+
68
+ If the app has accounts, trace the real login and logout paths. Expect
69
+ `Superwall.instance.identify(userId)` after identity is known and
70
+ `Superwall.instance.reset()` on logout. The id is hashed before it reaches Play
71
+ unless `passIdentifiersToPlayStore` is set; either way it must not be an email
72
+ or a device id. Review `setUserAttributes` for useful targeting data and
73
+ accidental sensitive values.
74
+
75
+ ## 4. Deep links and Web Checkout
76
+
77
+ Trace every URI entry point: the launcher Activity's `intent.data` in
78
+ `onCreate`, `onNewIntent`, navigation deep links, and any routing service.
79
+ Incoming URIs intended for Superwall should reach
80
+ `Superwall.instance.handleDeepLink(intent.data.toString())` (a `String`), which produces the standard
81
+ `deepLink_open` placement with URL parameters. A hardcoded URI-to-placement
82
+ `when` is worth improving when dashboard campaign rules can replace it. Confirm
83
+ the manifest has the intent filter (custom scheme or verified App Link).
84
+
85
+ Web Checkout is conditional. If the app/dashboard uses it, verify return URLs
86
+ and post-checkout handling. Default Superwall purchasing needs no custom
87
+ redemption sync. A custom controller must merge redeemed web entitlements with
88
+ device entitlements and update status; RevenueCat must follow its documented
89
+ path. If there is no Web Checkout intent, list readiness only as an optional
90
+ opportunity.
91
+
92
+ ## 5. Placements and lifecycle
93
+
94
+ Find `register(`, wrappers, analytics bridges, and placement constants.
95
+ Analytics bridges and calls without a feature lambda are valid. Require a
96
+ feature lambda only when the action itself is meant to be remotely gated. Check
97
+ valuable surfaces, placement parameters, accidental calls during composition
98
+ (inside a composable body rather than an `onClick` or `LaunchedEffect`), and
99
+ exact name agreement with active campaigns. Unrouted analytics/future
100
+ placements are fine.
101
+
102
+ Prefer standard `app_launch`, `session_start`, and `deepLink_open` placements
103
+ over custom duplicates when the semantics truly match. Do not suggest cosmetic
104
+ renames of stable keys. Review delegate forwarding for duplicated analytics or
105
+ missing subscription/redemption callbacks only when the app relies on them.
106
+
107
+ ## 6. Dashboard and verification
108
+
109
+ Run the read-only CLI cross-checks from `playbook.md` (Authenticated cross-checks). A presenting chain needs a
110
+ matching Android app, product attached to the intended entitlement/paywall, and
111
+ an active campaign audience for placements expected to show now. Cite dashboard
112
+ IDs where available. Finally identify the project's existing Gradle build/test
113
+ command (`./gradlew :app:assembleDebug`, `./gradlew test`); in fix mode, run it
114
+ after minimal changes.
115
+
116
+ ## Fix-mode boundaries
117
+
118
+ Fix clear wiring bugs and code/doc mismatches. Do not switch purchase providers,
119
+ enable Web Checkout, rename stable placements, change prices, or invent campaign
120
+ strategy without an explicit user decision.
@@ -0,0 +1,100 @@
1
+ # Review Superwall - Expo
2
+
3
+ You are reviewing an existing Expo integration using `expo-superwall`. Complete
4
+ the whole checklist; placements are one part of it.
5
+
6
+ ## Checklist
7
+
8
+ - [ ] package/plugin/native build configuration
9
+ - [ ] one root `SuperwallProvider` with correct platform keys/options
10
+ - [ ] purchase controller, restore flow, and subscription-status ownership
11
+ - [ ] identity, sign-out, and user attributes
12
+ - [ ] Expo linking and `handleDeepLink`
13
+ - [ ] conditional Web Checkout redemption readiness
14
+ - [ ] placements, callbacks, campaign coverage, and standard placements
15
+ - [ ] dashboard products, entitlements, paywalls, campaigns, and store IDs
16
+ - [ ] event forwarding and a native build verification path
17
+
18
+ ## Docs access
19
+
20
+ ```bash
21
+ curl -sL https://superwall.com/docs/expo/llms.txt
22
+ curl -sL https://superwall.com/docs/expo/quickstart/configure.md
23
+ curl -sL https://superwall.com/docs/expo/guides/advanced-configuration.md
24
+ curl -sL https://superwall.com/docs/expo/quickstart/tracking-subscription-state.md
25
+ curl -sL https://superwall.com/docs/expo/quickstart/user-management.md
26
+ curl -sL https://superwall.com/docs/expo/guides/handling-deep-links.md
27
+ curl -sL https://superwall.com/docs/expo/guides/web-checkout.md
28
+ curl -sL https://superwall.com/docs/expo/quickstart/feature-gating.md
29
+ ```
30
+
31
+ ## 1. SDK and configuration
32
+
33
+ Inspect `package.json`, the lockfile, app config, `expo-build-properties`, and the
34
+ native projects when present. Confirm one root `SuperwallProvider` with `apiKeys`
35
+ for the platforms actually shipped. `EXPO_PUBLIC_*` values are public, but should
36
+ follow the app's existing config pattern. Do not also require a separate
37
+ `configure()` when the provider already configures the SDK. Read options and
38
+ plugin settings in context.
39
+
40
+ ## 2. Purchases, restores, and subscription state
41
+
42
+ Infer the path before judging it:
43
+
44
+ - **Default:** `SuperwallProvider` without a custom controller is correct;
45
+ Superwall owns purchases, restores, and status.
46
+ - **RevenueCat/custom:** `CustomPurchaseControllerProvider`/`PurchaseController`
47
+ must handle the current iOS and Android purchase signatures, restoration, and
48
+ synchronize status/entitlements whenever the source of truth changes.
49
+
50
+ `useUser().subscriptionStatus` is documented app state, so its use is not an
51
+ issue by itself. Flag only contradictory state, permanently unknown status,
52
+ missing restore/controller branches, or access behavior that conflicts with the
53
+ chosen architecture. Cross-check product and entitlement identifiers through the
54
+ CLI when available; failed auth/network/store checks belong in **Not verified**.
55
+
56
+ ## 3. Identity and attributes
57
+
58
+ Trace actual auth transitions. Account-based apps should call `identify(userId)`
59
+ when login resolves and `signOut()` on logout. Review user attributes for useful
60
+ audience/paywall personalization and accidental sensitive data. Do not demand
61
+ identity in a deliberately anonymous app.
62
+
63
+ ## 4. Deep links and Web Checkout
64
+
65
+ Inspect Expo Router/React Navigation linking config, `Linking` subscriptions,
66
+ initial URL handling, app schemes, and universal/app links. Superwall URLs should
67
+ reach the current docs' `SuperwallExpoModule.handleDeepLink(url)` path so the
68
+ standard `deepLink_open` placement carries URL parameters into campaign rules.
69
+ Check cold-start and already-running paths.
70
+
71
+ Web Checkout is conditional. If present, verify return URL configuration and
72
+ post-checkout handling. Default purchasing needs no custom redemption sync. A
73
+ custom controller must merge web and device entitlements; RevenueCat follows its
74
+ dedicated docs. Otherwise describe Web Checkout readiness only as optional.
75
+
76
+ ## 5. Placements and lifecycle
77
+
78
+ Find `usePlacement`, `registerPlacement`, wrappers, constants, and analytics
79
+ bridges. Analytics-backed and fire-and-forget placements are valid. A `feature`
80
+ callback is necessary only for an action intended to be remotely gateable. Check
81
+ calls occur in event/effect flows rather than render, await async registrations,
82
+ and compare exact names only for active campaigns expected to present now.
83
+ Unrouted analytics/future placements are fine.
84
+
85
+ Prefer standard `app_launch`, `session_start`, and `deepLink_open` over custom
86
+ duplicates when semantics match. Do not recommend style-only placement renames.
87
+ Review `useSuperwallEvents` only when the app intends to forward analytics.
88
+
89
+ ## 6. Dashboard and verification
90
+
91
+ Run the read-only CLI cross-checks from `playbook.md` (Authenticated cross-checks). Verify the app/platform keys,
92
+ products, entitlements, paywall products, campaigns, and current presentation
93
+ placements form a usable chain. Cite IDs where available. In fix mode, run the
94
+ project's native Expo build/typecheck path - not only hot reload.
95
+
96
+ ## Fix-mode boundaries
97
+
98
+ Fix clear wiring bugs and code/doc mismatches. Do not change purchase providers,
99
+ enable Web Checkout, rename stable placements, alter prices, or invent campaign
100
+ strategy without an explicit user decision.
@@ -0,0 +1,99 @@
1
+ # Review Superwall - Flutter
2
+
3
+ You are reviewing an existing Flutter integration using `superwallkit_flutter`.
4
+ Complete the whole checklist; placements are one part of it.
5
+
6
+ ## Checklist
7
+
8
+ - [ ] package and iOS/Android native configuration
9
+ - [ ] one early `configure` call with the correct platform key/options
10
+ - [ ] purchase controller, restore flow, and subscription-status ownership
11
+ - [ ] identity/reset and user attributes
12
+ - [ ] platform links/router and `handleDeepLink`
13
+ - [ ] conditional Web Checkout redemption readiness
14
+ - [ ] placements, callbacks, campaigns, and standard placements
15
+ - [ ] dashboard/store products, entitlements, paywalls, and campaigns
16
+ - [ ] delegate/analytics and build verification
17
+
18
+ ## Docs access
19
+
20
+ ```bash
21
+ curl -sL https://superwall.com/docs/flutter/llms.txt
22
+ curl -sL https://superwall.com/docs/flutter/quickstart/configure.md
23
+ curl -sL https://superwall.com/docs/flutter/guides/advanced-configuration.md
24
+ curl -sL https://superwall.com/docs/flutter/quickstart/tracking-subscription-state.md
25
+ curl -sL https://superwall.com/docs/flutter/quickstart/user-management.md
26
+ curl -sL https://superwall.com/docs/flutter/guides/handling-deep-links.md
27
+ curl -sL https://superwall.com/docs/flutter/guides/web-checkout.md
28
+ curl -sL https://superwall.com/docs/flutter/quickstart/feature-gating.md
29
+ ```
30
+
31
+ ## 1. SDK and configuration
32
+
33
+ Inspect `pubspec.yaml`/lock, iOS pods and deployment target, Android Gradle/SDK,
34
+ and `main()`. Confirm initialization happens before use, with one
35
+ `Superwall.configure` call and the correct key for each platform. Check
36
+ `WidgetsFlutterBinding.ensureInitialized()` where initialization needs it. Read
37
+ `SuperwallOptions` in context rather than treating custom options as suspicious.
38
+
39
+ ## 2. Purchases, restores, and subscription state
40
+
41
+ Infer the path first:
42
+
43
+ - **Default:** no `PurchaseController` is correct; Superwall owns purchases,
44
+ restores, and subscription status.
45
+ - **RevenueCat/custom:** the controller must implement the current App Store and
46
+ Google Play purchase methods plus restore, and synchronize Superwall status as
47
+ entitlements change.
48
+
49
+ Reading `Superwall.shared.subscriptionStatus`, customer info, or entitlements is
50
+ documented and valid. Flag only conflicting sources, permanently unknown status,
51
+ missing controller branches, or access behavior inconsistent with the selected
52
+ architecture. Compare product/entitlement IDs with authenticated CLI/store data;
53
+ blocked checks belong in **Not verified**.
54
+
55
+ ## 3. Identity and attributes
56
+
57
+ Trace login/logout. Account-based apps should call
58
+ `Superwall.shared.identify(...)` after authentication and `reset()` on logout.
59
+ For Android, check whether Play Store identifiers are intentionally passed when
60
+ needed. Inspect attributes for audience/paywall value and sensitive data. Do not
61
+ demand identity in a deliberately anonymous app.
62
+
63
+ ## 4. Deep links and Web Checkout
64
+
65
+ Inspect `app_links`/`uni_links`, router handling, iOS URL schemes/universal links,
66
+ Android intent filters/app links, cold start, and foreground delivery. Superwall
67
+ URLs should reach `await Superwall.shared.handleDeepLink(uri)` so the standard
68
+ `deepLink_open` placement receives URL parameters for dashboard rules.
69
+
70
+ Web Checkout is conditional. If present, verify return URLs and post-checkout
71
+ handling. Default purchasing needs no custom redemption sync. A custom controller
72
+ must merge web and device entitlements and update status; RevenueCat follows its
73
+ dedicated docs. Otherwise list readiness only as an optional opportunity.
74
+
75
+ ## 5. Placements and lifecycle
76
+
77
+ Find `registerPlacement`, wrappers, constants, and analytics bridges. Analytics
78
+ and fire-and-forget calls are valid. A `feature` callback is needed only when the
79
+ specific action should be remotely gateable. Check calls occur outside widget
80
+ `build`, futures are awaited where sequencing matters, active presenting campaign
81
+ names match, and parameters are useful. Unrouted analytics/future placements are
82
+ fine.
83
+
84
+ Prefer standard `app_launch`, `session_start`, and `deepLink_open` over truly
85
+ duplicative lifecycle placements. Do not recommend cosmetic renames of stable
86
+ keys. Delegate forwarding is optional unless app behavior relies on it.
87
+
88
+ ## 6. Dashboard and verification
89
+
90
+ Run the read-only CLI checks from `playbook.md` (Authenticated cross-checks). Verify platform keys, products,
91
+ entitlements, paywall products, campaigns, and placements expected to present
92
+ now form a usable chain. Cite IDs where available. In fix mode, run existing
93
+ `flutter analyze`, tests, and an appropriate platform build where practical.
94
+
95
+ ## Fix-mode boundaries
96
+
97
+ Fix clear wiring bugs and code/doc mismatches. Do not switch purchase providers,
98
+ enable Web Checkout, rename stable placements, change prices, or invent campaign
99
+ strategy without an explicit user decision.
@@ -0,0 +1,108 @@
1
+ # Review Superwall - iOS / Swift
2
+
3
+ You are reviewing an existing iOS integration using `SuperwallKit`. Complete the
4
+ whole checklist; placements are one part of it.
5
+
6
+ ## Checklist
7
+
8
+ - [ ] SDK dependency and deployment target
9
+ - [ ] one early `configure` call and the intended public key/options
10
+ - [ ] purchase controller, restore flow, and subscription-status ownership
11
+ - [ ] identity, reset, and user attributes
12
+ - [ ] URL schemes/universal links and `handleDeepLink`
13
+ - [ ] conditional Web Checkout redemption readiness
14
+ - [ ] placements, feature callbacks, campaign coverage, and standard placements
15
+ - [ ] products, entitlements, paywalls, campaigns, and App Store identifiers
16
+ - [ ] delegate/analytics and a build or test verification path
17
+
18
+ ## Docs access
19
+
20
+ ```bash
21
+ curl -sL https://superwall.com/docs/ios/llms.txt
22
+ curl -sL https://superwall.com/docs/ios/quickstart/configure.md
23
+ curl -sL https://superwall.com/docs/ios/guides/advanced-configuration.md
24
+ curl -sL https://superwall.com/docs/ios/quickstart/tracking-subscription-state.md
25
+ curl -sL https://superwall.com/docs/ios/quickstart/user-management.md
26
+ curl -sL https://superwall.com/docs/ios/guides/handling-deep-links.md
27
+ curl -sL https://superwall.com/docs/ios/guides/web-checkout.md
28
+ curl -sL https://superwall.com/docs/ios/quickstart/feature-gating.md
29
+ ```
30
+
31
+ ## 1. SDK and configuration
32
+
33
+ Inspect `Package.resolved`, `project.pbxproj`, `Package.swift`, or the Podfile and
34
+ lockfile. Confirm `Superwall.configure(apiKey:)` is called once, as early as
35
+ practical at launch. A `pk_` key is public and may be inlined on iOS; verify it
36
+ belongs to the current app rather than treating its presence as a secret leak.
37
+ Read any `SuperwallOptions` and judge intentional behavior, not mere customization.
38
+
39
+ ## 2. Purchases, restores, and subscription state
40
+
41
+ Infer exactly which path the app uses:
42
+
43
+ - **Default:** no `PurchaseController` is correct; Superwall owns purchases,
44
+ restores, and subscription status.
45
+ - **RevenueCat/custom:** the controller must implement purchase and restore,
46
+ return accurate result cases, and keep `Superwall.shared.subscriptionStatus`
47
+ synchronized as entitlements change. Custom/web products need the current doc's
48
+ handling; do not assume StoreKit-backed and custom products are interchangeable.
49
+
50
+ Reading `subscriptionStatus`, `.isActive`, customer info, or entitlements is a
51
+ documented way to drive app state and UI. Report a problem only when two sources
52
+ contradict each other, status remains `.unknown`, restore is missing, or access
53
+ logic demonstrably bypasses the intended purchase architecture.
54
+
55
+ Compare dashboard products/entitlements with App Store subscription identifiers
56
+ when CLI access exists. Do not label an auth, network, or ASC failure as broken
57
+ subscriptions; put it under **Not verified**.
58
+
59
+ ## 3. Identity and attributes
60
+
61
+ If the app has accounts, trace the real login and logout paths. Expect
62
+ `Superwall.shared.identify(userId:)` after identity is known and
63
+ `Superwall.shared.reset()` on logout. On iOS, a UUID user ID is needed for
64
+ StoreKit `appAccountToken`; non-UUID IDs fall back to the anonymous alias for
65
+ store events. Review `setUserAttributes` for useful targeting data and accidental
66
+ sensitive values.
67
+
68
+ ## 4. Deep links and Web Checkout
69
+
70
+ Trace every URL entry point: SwiftUI `.onOpenURL`, app/scene delegate methods,
71
+ universal links, and any routing service. Incoming URLs intended for Superwall
72
+ should reach `Superwall.handleDeepLink(url)`, which produces the standard
73
+ `deepLink_open` placement with URL parameters. A hardcoded URL-to-placement
74
+ switch is worth improving when dashboard campaign rules can replace it.
75
+
76
+ Web Checkout is conditional. If the app/dashboard uses it, verify return URLs and
77
+ post-checkout handling. Default Superwall purchasing needs no custom redemption
78
+ sync. A custom controller must merge redeemed web entitlements with device
79
+ entitlements and update status; RevenueCat must follow its documented path. If
80
+ there is no Web Checkout intent, list readiness only as an optional opportunity.
81
+
82
+ ## 5. Placements and lifecycle
83
+
84
+ Find `register(placement:)`, wrappers, analytics bridges, and placement constants.
85
+ Analytics bridges and calls without a feature closure are valid. Require a
86
+ feature closure only when the action itself is meant to be remotely gated. Check
87
+ valuable surfaces, placement parameters, accidental calls during SwiftUI `body`,
88
+ and exact name agreement with active campaigns. Unrouted analytics/future
89
+ placements are fine.
90
+
91
+ Prefer standard `app_launch`, `session_start`, and `deepLink_open` placements over
92
+ custom duplicates when the semantics truly match. Do not suggest cosmetic
93
+ renames of stable keys. Review delegate forwarding for duplicated analytics or
94
+ missing subscription/redemption callbacks only when the app relies on them.
95
+
96
+ ## 6. Dashboard and verification
97
+
98
+ Run the read-only CLI cross-checks from `playbook.md` (Authenticated cross-checks). A presenting chain needs a
99
+ matching app, product attached to the intended entitlement/paywall, and an active
100
+ campaign audience for placements expected to show now. Cite dashboard IDs where
101
+ available. Finally identify the project's existing Xcode build/test command; in
102
+ fix mode, run it after minimal changes.
103
+
104
+ ## Fix-mode boundaries
105
+
106
+ Fix clear wiring bugs and code/doc mismatches. Do not switch purchase providers,
107
+ enable Web Checkout, rename stable placements, change prices, or invent campaign
108
+ strategy without an explicit user decision.