Skip to content

v1.0.0 — Initial public release

Choose a tag to compare

@kherembourg kherembourg released this 19 May 16:39
· 20 commits to main since this release

Initial public release of the Purchasely AI Plugin — an AI coding assistant for Purchasely SDK integration across iOS, Android, React Native, Flutter, and Cordova.

What's inside

Core plugin

  • Claude Code plugin manifest (.claude-plugin/plugin.json and marketplace.json)
  • 3 AI-invoked skills: integrate, review, debug
  • 4 user-invoked slash commands: /purchasely:integrate, /purchasely:review, /purchasely:debug, /purchasely:question
  • sdk-expert agent for Q&A (/purchasely:question delegates to it via the Task tool)
  • Pre-built configs for Cursor, GitHub Copilot, Windsurf, Codex, Gemini, Mistral
  • POSIX-compatible install.sh with auto-detection of installed AI tools
  • MIT License

Universal concept references (references/concepts/)

  • user-identity.mduserLogin / userLogout ordering, anonymous→logged-in receipt merge, foreground resync
  • promotional-offers.md — Apple promo offers, Google developer-determined offers, offer codes, win-back recipe
  • subscription-management.md — opening the native Manage Subscription page (iOS 15+ in-app sheet + universal URL fallback, Google Play per-product deeplink)
  • analytics-integration.md — server-side vs client-side routing, single analytics wrapper, GDPR consent gating
  • campaigns.md — no-code Console automations, readyToOpenDeeplink, SDK ≥ 5.1.0 requirement
  • subscription-checks.md — gating including the Purchasely-paywall caveat for Restore
  • cross-platform-subscriptions.md — handling subscriptions across iOS and Android stores

Platform-specific references

Integration guides for iOS, Android, React Native, Flutter, Cordova; cross-platform architecture diagrams; architecture-patterns.md (wrapper / service / gateway pattern — recommended, not required).

Testing & troubleshooting

  • testing/README.md — sandbox testing for Apple and Google + per-release checklist
  • troubleshooting/debug-mode.md — SDK debug logging vs Console-side Debug Mode (QR-code activation)
  • troubleshooting/error-codes.mdPLYError reference for iOS and Android, Google Play Billing v8 hang and fix
  • troubleshooting/screen-issue-report.md — escalation template for Purchasely Support
  • troubleshooting/common-issues.md — common integration pitfalls and fixes

Skill highlights

  • debug — Step 0 (enable SDK debug logging), Step 5 (escalate to Support), Step 6 (PLYError decoding)
  • integrate — initialization, paywalls, purchases, action interceptor, Restore (with Purchasely-paywall caveat), Manage Subscription, Beyond the Basics (preload, campaigns, promo offers, analytics, gating, attributes)
  • review — 24-point checklist: userLogin ordering, foreground synchronize, Restore, Manage Subscription, PrivacyInfo.xcprivacy, Google Play Billing v8, LogLevel.DEBUG gating, Campaigns / Promo Offers / Analytics sections

Install

curl -fsSL https://raw.githubusercontent.com/Purchasely/Purchasely-AI-Plugin/main/install.sh | sh

Or see README.md for manual installation per AI tool.


Full changelog: CHANGELOG.md