Index of every page on this site: llms.txt
All skills
tristanmanchester avatar

/expo-revenuecat-superwall-integration

@3323bc9
Run it yourself

Integrate or repair RevenueCat and Superwall together in an Expo React Native app. Use for their shared purchase ownership, Android offer selection, billing identity, entitlement sync, restore, or migration flows; not for web billing or unrelated paywall providers.

Use this Skill: https://skilld.dev/gh/tristanmanchester/agent-skills/expo-revenuecat-superwall-integration

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencessource-notes.md

≈404 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Source Notes for Maintainers

This skill was revised as v2 on 2026-03-08.

Key documentation reviewed while preparing this version:

Agent Skills resources

  • agentskills.io home and what-are-skills pages
  • agentskills.io specification
  • BEST_PRACTICES_FOR_WRITING_AND_USING_SKILLS_MD_FILES.md
  • the bundled PDF guide about building skills

Key skill-specific takeaways applied here:

  • keep SKILL.md focused
  • push detailed material into references/
  • make the description explicit about what and when
  • keep the folder in kebab-case and include SKILL.md exactly
  • include examples, references, validation help, and a zipped deliverable

Superwall resources

Reviewed areas included:

  • Expo install and development-build requirements
  • RevenueCat integration guide
  • subscription-state tracking
  • user management
  • webhook and original-app-user-id troubleshooting
  • placement troubleshooting
  • analytics and useSuperwallEvents
  • CustomPurchaseControllerProvider docs

RevenueCat resources

Reviewed areas included:

  • Expo and React Native installation
  • identifying customers
  • restoring purchases
  • restore behaviour
  • trusted entitlements
  • observer mode / purchasesAreCompletedBy
  • Test Store and sandbox guidance
  • Billing Client 8 restore issue notes

Intent of v2

The main improvement over v1 is that the skill is now decision-led rather than happy-path-only. It explicitly teaches the agent to reason about:

  • architecture choice
  • identity model
  • restore policy
  • Android base plans and offers
  • iOS UUID and server-notification consequences
  • observability
  • test coverage

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo4 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The expo-revenuecat-superwall-integration skill is a professional integration guide for React Native Expo applications. It provides structured architectural choices, implementation playbooks, and a local validation script to ensure a secure and production-ready monetisation stack. The skill adheres to security best practices, such as using public API keys and avoiding PII for identifiers, and contains no malicious code or exfiltration patterns.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

  • ZeroLeaks6mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 3323bc9. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Steadyupdated last month
metadata
{
  "version": "3.0.0",
  "reviewed": "2026-09-13"
}
Other metadata
compatibility
Expo development builds on iOS/Android, expo-superwall's current provider API, and react-native-purchases 9.7 or newer. Resolve native platform requirements from the installed Expo and SDK versions. Offline checks need Python 3.10+, Node.js, and TypeScript.

README badge

README badge for tristanmanchester/agent-skills/expo-revenuecat-superwall-integration