@superwall/cli 2.0.0 → 2.1.0

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 (139) hide show
  1. package/dist/{apple-CkKlHBZ9.js → apple-CSzNTGHM.js} +13 -13
  2. package/dist/auth.d.ts +1 -1
  3. package/dist/auth.js +3 -3
  4. package/dist/{billing-XCZU_T46.js → billing-C3Q8DBU2.js} +3 -3
  5. package/dist/{bind-drne__Ys.js → bind-BumHTi9O.js} +4 -4
  6. package/dist/{build-Gpdq5QXP.js → build-Bpviiclc.js} +6 -6
  7. package/dist/{client-DP6Rc0t_.js → client-BL0f_yGf.js} +2 -2
  8. package/dist/create-BSfvpWoD.js +19 -0
  9. package/dist/{create-Cwc3SRWJ.js → create-BUcVG4Ab.js} +23 -23
  10. package/dist/{create-BBrtgUgS.js → create-CfK3PeKA.js} +6 -6
  11. package/dist/{doctor-C9ldpPFC.js → doctor-BWqIYcMn.js} +6 -6
  12. package/dist/{drivers-DNrx4LWA.js → drivers-CPhdPkW5.js} +3 -3
  13. package/dist/entry.js +20 -21
  14. package/dist/{environment-DF1qKlny.js → environment-eBXjELoN.js} +1 -1
  15. package/dist/{existing-78LWSsqS.js → existing-BltvQiX5.js} +2 -2
  16. package/dist/held-CPve03KJ.js +16 -0
  17. package/dist/{held-Cy8Wl4D1.js → held-DgnTFMl3.js} +6 -6
  18. package/dist/{integrate-DcJhpXy8.js → integrate-BRsqoe01.js} +22 -22
  19. package/dist/{login-B2TsCE2H.js → login-BCEH5q0U.js} +1 -1
  20. package/dist/login-BPOONe7n.js +16 -0
  21. package/dist/{login-D0lh3_JI.js → login-BbTIrCFT.js} +5 -5
  22. package/dist/{lookup-D-nmmAbw.js → lookup-rr1AkCJA.js} +2 -2
  23. package/dist/{migrate-Cfec564E.js → migrate-C9X2Vz81.js} +22 -22
  24. package/dist/{notification-url-YDbq6FMA.js → notification-url-CV86qiKP.js} +2 -2
  25. package/dist/{open-Ba2vBl1_.js → open-CcpXotHG.js} +10 -10
  26. package/dist/{org-D0g_q3mv.js → org-BQQDo7wm.js} +2 -2
  27. package/dist/{paths-DxSLdpOI.js → paths-CRlU72cq.js} +1 -1
  28. package/dist/{playbook-DIeb7hne.js → playbook-DVMXN7fh.js} +10 -10
  29. package/dist/{promote-COD4fYdz.js → promote-Da8xctzy.js} +16 -16
  30. package/dist/push-BV-grvQg.js +22 -0
  31. package/dist/{push-CncywhkQ.js → push-D6R9icWN.js} +27 -14
  32. package/dist/{registry-DSrosOYs.js → registry-BYVD-_h6.js} +206 -49
  33. package/dist/{resources-Dqr01Dep.js → resources-DLON3-61.js} +18 -6
  34. package/dist/{run-C9qg_QlC.js → run-Co-BwhOg.js} +2 -2
  35. package/dist/scan-B88OlWOt.js +4 -0
  36. package/dist/{scan-DLrsrFS9.js → scan-CKuk-_6W.js} +1 -1
  37. package/dist/{scope-V336uz8j.js → scope-DV22_Ufm.js} +4 -4
  38. package/dist/{selection-Rdw-ZUoG.js → selection-C2_KbLuo.js} +10 -4
  39. package/dist/server-C4f6ccUr.js +22 -0
  40. package/dist/{server-D0tGG8C4.js → server-D0d2oP-5.js} +10 -8
  41. package/dist/{session-CFAmMhem.js → session-B-Uz0cQ7.js} +1 -1
  42. package/dist/session-BuvArt1j.js +6 -0
  43. package/dist/{session-D_nEWKXT.js → session-C4rbE3VS.js} +41 -13
  44. package/dist/skills/superwall-framework/SKILL.md +7 -3
  45. package/dist/skills/superwall-framework/references/cli.md +1 -0
  46. package/dist/skills/superwall-framework/references/layout.md +34 -1
  47. package/dist/{skills-DMG4bpKk.js → skills-CLGJuMnF.js} +8 -8
  48. package/dist/{skills-BvFOa4y6.js → skills-CZcpnEnG.js} +5 -4
  49. package/dist/{spinner-CneRK5rk.js → spinner-C2U6QBJ9.js} +3 -3
  50. package/dist/{storage-s2Dnz-yl.js → storage-6h9vyiAz.js} +1 -1
  51. package/dist/storekit-CK9JmM2D.js +16 -0
  52. package/dist/{storekit-yY_kS2iR.js → storekit-CinJra3V.js} +3 -3
  53. package/dist/{telemetry-DtG92m5O.js → telemetry-DKyDhURo.js} +1 -1
  54. package/dist/{token-DzRh7dI1.js → token-DaxQgQkv.js} +1 -1
  55. package/dist/tools-skills/animate-onboarding/SKILL.md +467 -0
  56. package/dist/tools-skills/animate-onboarding/references/engine.md +494 -0
  57. package/dist/tools-skills/animate-onboarding/references/framework/Question.tsx +71 -0
  58. package/dist/tools-skills/animate-onboarding/references/framework/README.md +40 -0
  59. package/dist/tools-skills/animate-onboarding/references/framework/answers.ts +19 -0
  60. package/dist/tools-skills/animate-onboarding/references/framework/flow.ts +80 -0
  61. package/dist/tools-skills/animate-onboarding/references/framework/handoffs.ts +869 -0
  62. package/dist/tools-skills/animate-onboarding/references/framework/layout.tsx +113 -0
  63. package/dist/tools-skills/animate-onboarding/references/framework/motion.css +559 -0
  64. package/dist/tools-skills/animate-onboarding/references/framework/useStoryRouter.ts +48 -0
  65. package/dist/tools-skills/animate-onboarding/references/handoffs.md +375 -0
  66. package/dist/tools-skills/animate-onboarding/references/imageReady.ts +92 -0
  67. package/dist/tools-skills/animate-onboarding/references/morphFrame.ts +356 -0
  68. package/dist/tools-skills/animate-onboarding/references/performance.md +41 -0
  69. package/dist/tools-skills/animate-onboarding/references/web-runtime/README.md +17 -0
  70. package/dist/tools-skills/animate-onboarding/references/web-runtime/handoffs.ts +858 -0
  71. package/dist/tools-skills/animate-onboarding/references/web-runtime/story-motion.css +301 -0
  72. package/dist/tools-skills/mobile-design/SKILL.md +447 -0
  73. package/dist/tools-skills/mobile-design/references/responsive.md +162 -0
  74. package/dist/tools-skills/onboarding-questions/SKILL.md +231 -0
  75. package/dist/tools-skills/onboarding-questions/references/arpu-questions.md +139 -0
  76. package/dist/tools-skills/onboarding-questions/references/craft.md +142 -0
  77. package/dist/tools-skills/onboarding-questions/references/example-reflective.md +117 -0
  78. package/dist/tools-skills/superwall/SKILL.md +263 -0
  79. package/dist/tools-skills/superwall/references/api.md +303 -0
  80. package/dist/tools-skills/superwall/references/asa.md +166 -0
  81. package/dist/tools-skills/superwall/references/asc.md +95 -0
  82. package/dist/tools-skills/superwall/references/dashboard-links.md +57 -0
  83. package/dist/tools-skills/superwall/references/data-analytics.md +896 -0
  84. package/dist/tools-skills/superwall/references/docs.md +51 -0
  85. package/dist/tools-skills/superwall/references/sdk-integration.md +104 -0
  86. package/dist/tools-skills/superwall/references/sdk-source.md +18 -0
  87. package/dist/tools-skills/superwall/workflows/dashboard/playbook.md +76 -0
  88. package/dist/tools-skills/superwall/workflows/dashboard/setup.md +100 -0
  89. package/dist/tools-skills/superwall/workflows/integrate/android.md +292 -0
  90. package/dist/tools-skills/superwall/workflows/integrate/expo.md +272 -0
  91. package/dist/tools-skills/superwall/workflows/integrate/flutter.md +285 -0
  92. package/dist/tools-skills/superwall/workflows/integrate/ios.md +314 -0
  93. package/dist/tools-skills/superwall/workflows/integrate/playbook.md +83 -0
  94. package/dist/tools-skills/superwall/workflows/integrate/react-native.md +246 -0
  95. package/dist/tools-skills/superwall/workflows/migrate/adapty.md +229 -0
  96. package/dist/tools-skills/superwall/workflows/migrate/playbook.md +78 -0
  97. package/dist/tools-skills/superwall/workflows/migrate/qonversion.md +227 -0
  98. package/dist/tools-skills/superwall/workflows/migrate/revenuecat.md +414 -0
  99. package/dist/tools-skills/superwall/workflows/placements/android.md +175 -0
  100. package/dist/tools-skills/superwall/workflows/placements/expo.md +161 -0
  101. package/dist/tools-skills/superwall/workflows/placements/flutter.md +139 -0
  102. package/dist/tools-skills/superwall/workflows/placements/ios.md +165 -0
  103. package/dist/tools-skills/superwall/workflows/placements/playbook.md +69 -0
  104. package/dist/tools-skills/superwall/workflows/placements/react-native.md +145 -0
  105. package/dist/tools-skills/superwall/workflows/placements/strategy.md +222 -0
  106. package/dist/tools-skills/superwall/workflows/review/android.md +120 -0
  107. package/dist/tools-skills/superwall/workflows/review/expo.md +100 -0
  108. package/dist/tools-skills/superwall/workflows/review/flutter.md +99 -0
  109. package/dist/tools-skills/superwall/workflows/review/ios.md +108 -0
  110. package/dist/tools-skills/superwall/workflows/review/playbook.md +70 -0
  111. package/dist/tools-skills/superwall/workflows/review/react-native.md +100 -0
  112. package/dist/tools-skills/superwall-editor/SKILL.md +113 -0
  113. package/dist/tools-skills/superwall-editor/references/cli.md +135 -0
  114. package/dist/tools-skills/superwall-editor/references/design.md +51 -0
  115. package/dist/tools-skills/superwall-editor/references/native-elements.md +171 -0
  116. package/dist/tools-skills/superwall-editor/references/workflow.md +65 -0
  117. package/dist/tools-skills/superwall-editor/scripts/sw-editor.sh +662 -0
  118. package/dist/tools-skills/wwdc/SKILL.md +22 -0
  119. package/dist/tools-skills/wwdc/references/docs.md +52 -0
  120. package/dist/tools-skills/wwdc/scripts/wwdc.sh +266 -0
  121. package/dist/tools.d.ts +1 -1
  122. package/dist/tools.js +200 -18
  123. package/dist/{upgrade-Bt4Ouw1y.js → upgrade-DPo0a4Es.js} +1 -1
  124. package/dist/{upgrade-Cqy5orjb.js → upgrade-ffseQDMx.js} +2 -2
  125. package/package.json +2 -2
  126. package/dist/create-Yvf2gStM.js +0 -19
  127. package/dist/held-Ddw1XSsr.js +0 -16
  128. package/dist/kinds-GFXB3sYu.js +0 -11
  129. package/dist/login-BoBe8Psl.js +0 -16
  130. package/dist/push-CtD4FZQV.js +0 -22
  131. package/dist/scan-Cv5uOwVY.js +0 -4
  132. package/dist/send-BxD9yf6F.js +0 -150
  133. package/dist/server-z1LH94R_.js +0 -22
  134. package/dist/session-1AV_Bs_d.js +0 -6
  135. package/dist/storekit-DafAnGkM.js +0 -16
  136. /package/dist/{devtools-ByZ6XYnn.js → devtools-pBl_vt03.js} +0 -0
  137. /package/dist/{reports-DdPq4blM.js → reports-D_qbl7_u.js} +0 -0
  138. /package/dist/{screenshot-file-0UETadF8.js → screenshot-file-tVBfUEIi.js} +0 -0
  139. /package/dist/{storage-DYvmIOHa.d.ts → storage-CerJ5KLP.d.ts} +0 -0
@@ -0,0 +1,65 @@
1
+ # Superwall Paywall Workflow Guide
2
+
3
+ ## Recommended order of operations
4
+
5
+ 1. Decide theming first.
6
+ 2. If the design needs reusable colors, create only the style variables actually needed.
7
+ 3. Build the paywall structure with `write_html` and native elements where appropriate.
8
+ 4. Add products only if the paywall actually needs them.
9
+ 5. If the paywall is a multi-page flow, build it page by page rather than trying to create and polish every page at once.
10
+ 6. Connect the pages after the structure exists.
11
+ 7. Wire tap behaviors after the structure and flow wiring are in place.
12
+ 8. Add any remaining custom logic, dynamic values, and product-driven behavior last.
13
+
14
+ ## Writing new designs
15
+
16
+ 1. Generate a design brief (color palette, type scale, spacing, direction, CTA style).
17
+ 2. Call `get_basic_info` to find the page root.
18
+ 3. Add content in small pieces -- one visual group per `write_html` call.
19
+ 4. Use `duplicate_nodes` combined with `update_styles` and `set_text_content` for repeated elements.
20
+ 5. Screenshot and review after every 2-3 additions.
21
+
22
+ ## Editing existing designs
23
+
24
+ 1. Use `get_subtree` to understand the current structure.
25
+ 2. Use `get_screenshot` to see the current visual state.
26
+ 3. Prefer semantic edits over `write_html`:
27
+ - `update_styles` for visual changes
28
+ - `set_text_content` for copy changes
29
+ - `move_nodes` for reparenting/repositioning
30
+ - `reorder_children` for sibling order
31
+ - `duplicate_nodes` to create variations of existing elements
32
+ - `find_replace` for bulk changes (like updating all colors)
33
+ 4. Use `get_style_token_usage` before changing/deleting tokens.
34
+ 5. Use `bind_style_tokens` when nodes should adopt reusable interface theme tokens.
35
+ 6. Use `get_products` before working with product-specific pricing UI.
36
+ 7. Use `get_variables` before building interactive logic.
37
+ 8. Use `set_dynamic_value` for conditional styles/props. Cases are ordered, first match wins, empty `rules: []` as fallback.
38
+ 9. Use `set_click_behavior` for tap behavior (purchase, close, restore, open-url, navigate-page, set-state, etc.).
39
+ 10. Use `write_html` only for genuinely new structure or intentional section replacement.
40
+ 11. Screenshot and verify after changes.
41
+
42
+ ## Working status indicators
43
+
44
+ Always use `start_working_on_nodes` before modifications and `finish_working_on_nodes` when done. Use `page:page` for the entire paywall, or specific node IDs for targeted sections.
45
+
46
+ ## Best practices
47
+
48
+ - Prefer native elements over manual `div` recreations.
49
+ - Confirm light mode, dark mode, or both before creating style variables.
50
+ - Create reusable style variables only for colors that are actually reused.
51
+ - Do not create unused style variables.
52
+ - Build first, then specialize. Add dynamic behavior after the base structure exists.
53
+ - For multi-page flows, build and verify one page at a time.
54
+ - Add tap behaviors explicitly. Do not assume interactive elements are wired just because they are visible.
55
+ - Connect pages before wiring tappable elements that move through the flow.
56
+ - Set haptics intentionally for interactive elements.
57
+ - Prefer a subtle shrink/press animation for buttons and tappable controls.
58
+
59
+ ## Product and eligibility logic
60
+
61
+ - If the paywall uses products with trials, check whether introductory offer eligibility matters.
62
+ - Use `products.hasIntroductoryOffer` when the paywall should show different copy, styling, or branching depending on trial eligibility.
63
+ - Ensure the user does not see trial-specific messaging when they are not eligible.
64
+ - Product variables use Liquid syntax: `{{ products.<referenceName>.<variable> }}`.
65
+ - `get_products` returns `paywallProducts` (on the paywall) with `liquidPrefix` showing the exact Liquid path.