feat: add RevenueCat integration templates and modular scaffolding support for native apps

apps/cli/src/helpers/addons/mcp-setup.ts

@@ -214,6 +214,15 @@ function getRecommendedMcpServers(config: ProjectConfig): McpServerDef[] {
     });
   }
 
+  if (config.payments === "revenuecat") {
+    servers.push({
+      key: "revenuecat",
+      label: "RevenueCat",
+      name: "revenuecat",
+      target: "https://mcp.revenuecat.ai/mcp",
+    });
+  }
+
   return servers;
 }
 

apps/cli/src/helpers/core/post-installation.ts

@@ -138,6 +138,8 @@ export async function displayPostInstallInstructions(
   );
   const polarInstructions =
     config.payments === "polar" ? getPolarInstructions(backend, packageManager) : "";
+  const revenueCatInstructions =
+    config.payments === "revenuecat" ? getRevenueCatInstructions(backend, packageManager) : "";
   const paymentSetupInstructions = getPaymentSetupInstructions(config.payments, backend);
   const alchemyDeployInstructions = getAlchemyDeployInstructions(
     runCmd,
@@ -283,6 +285,7 @@ export async function displayPostInstallInstructions(
   if (authSetupInstructions) output += `\n${authSetupInstructions.trim()}\n`;
   if (betterAuthConvexInstructions) output += `\n${betterAuthConvexInstructions.trim()}\n`;
   if (polarInstructions) output += `\n${polarInstructions.trim()}\n`;
+  if (revenueCatInstructions) output += `\n${revenueCatInstructions.trim()}\n`;
   if (paymentSetupInstructions) output += `\n${paymentSetupInstructions.trim()}\n`;
 
   if (noOrmWarning) output += `\n${noOrmWarning.trim()}\n`;
@@ -690,6 +693,29 @@ function getPolarInstructions(backend: Backend, packageManager: string) {
   return `${pc.bold("Polar Payments Setup:")}\n${pc.cyan("•")} Get access token & product ID from ${pc.underline("https://sandbox.polar.sh/")}\n${pc.cyan("•")} Set POLAR_ACCESS_TOKEN in ${envPath}`;
 }
 
+function getRevenueCatInstructions(backend: Backend, packageManager: string) {
+  const base =
+    `${pc.bold("RevenueCat Payments Setup:")}\n` +
+    `${pc.cyan("•")} Create a project, entitlement, and offering in ${pc.underline("https://app.revenuecat.com/")}\n` +
+    `${pc.cyan("•")} Set the public SDK keys in ${pc.white("apps/native/.env")}:\n` +
+    `${pc.white("   EXPO_PUBLIC_REVENUECAT_IOS_KEY=appl_your_ios_key")}\n` +
+    `${pc.white("   EXPO_PUBLIC_REVENUECAT_ANDROID_KEY=goog_your_android_key")}\n` +
+    `${pc.white("   EXPO_PUBLIC_REVENUECAT_ENTITLEMENT_ID=pro")}`;
+
+  if (backend === "convex") {
+    const cmd = packageManager === "npm" ? "npx" : packageManager;
+    return (
+      `${base}\n` +
+      `${pc.cyan("•")} Set the webhook secret (min 32 chars) from ${pc.white("packages/backend")}:\n` +
+      `${pc.white("   cd packages/backend")}\n` +
+      `${pc.white(`   ${cmd} convex env set REVENUECAT_WEBHOOK_AUTH your_webhook_secret`)}\n` +
+      `${pc.cyan("•")} Configure a RevenueCat webhook to ${pc.white("https://<your-convex-site-url>/webhooks/revenuecat")} using the same value as the Authorization header`
+    );
+  }
+
+  return base;
+}
+
 function getAlchemyDeployInstructions(
   runCmd: string,
   webDeploy: WebDeploy,

apps/cli/src/prompts/payments.ts

@@ -38,6 +38,15 @@ export function resolvePaymentsPrompt(
     (context.auth === "better-auth" || context.auth === "better-auth-organizations") &&
     (context.frontends?.length === 0 || splitFrontends(context.frontends).web.length > 0);
 
+  const hasNativeFrontend = (context.frontends ?? []).some(
+    (frontend) =>
+      frontend === "native-bare" ||
+      frontend === "native-uniwind" ||
+      frontend === "native-unistyles",
+  );
+
+  const isRevenueCatCompatible = hasNativeFrontend;
+
   const options: Array<{ value: Payments; label: string; hint: string }> = [];
 
   if (isPolarCompatible) {
@@ -76,6 +85,15 @@ export function resolvePaymentsPrompt(
     },
   );
 
+  if (isRevenueCatCompatible) {
+    options.push({
+      value: "revenuecat" as Payments,
+      label: "RevenueCat",
+      hint: "In-app subscriptions and cross-platform monetization for mobile.",
+    });
+  }
+
+
   return {
     shouldPrompt: true,
     mode: "single",

apps/cli/src/prompts/prompt-resolver-registry.ts

@@ -321,7 +321,10 @@ export const PROMPT_RESOLVER_REGISTRY: ResolverRegistry = {
   payments: {
     schemaValues: PAYMENTS_VALUES,
     resolve: resolvePaymentsPrompt,
-    coverageContexts: [{ auth: "better-auth", backend: "hono", frontends: ["next"] }],
+    coverageContexts: [
+      { auth: "better-auth", backend: "hono", frontends: ["next"] },
+      { auth: "better-auth", backend: "hono", frontends: ["native-bare"] },
+    ],
   },
   realtime: {
     schemaValues: REALTIME_VALUES,

apps/cli/src/utils/compatibility-rules.ts

@@ -644,6 +644,15 @@ export function validatePaymentsCompatibility(
       );
     }
   }
+
+  if (payments === "revenuecat") {
+    const { native } = splitFrontends(frontends);
+    if (native.length === 0) {
+      exitWithError(
+        "RevenueCat payments requires a native frontend. Please select a native frontend or choose a different payments provider.",
+      );
+    }
+  }
 }
 
 export function validateExamplesCompatibility(

apps/cli/test/payments.test.ts

@@ -686,6 +686,54 @@ describe("Payments Options", () => {
     });
   });
 
+  describe("RevenueCat payments", () => {
+    test("revenuecat with native-bare frontend", async () => {
+      const result = await runTRPCTest(
+        createCustomConfig({
+          projectName: "revenuecat-native-bare",
+          frontend: ["native-bare"],
+          backend: "hono",
+          api: "none",
+          payments: "revenuecat",
+        }),
+      );
+      expectSuccess(result);
+    });
+
+    test("revenuecat with native-unistyles frontend", async () => {
+      const result = await runTRPCTest(
+        createCustomConfig({
+          projectName: "revenuecat-native-unistyles",
+          frontend: ["native-unistyles"],
+          backend: "convex",
+          runtime: "none",
+          database: "none",
+          orm: "none",
+          api: "none",
+          payments: "revenuecat",
+        }),
+      );
+      expectSuccess(result);
+    });
+
+    test("revenuecat with native-uniwind and better-auth (convex combined webhook)", async () => {
+      const result = await runTRPCTest(
+        createCustomConfig({
+          projectName: "revenuecat-uniwind-better-auth",
+          frontend: ["native-uniwind"],
+          backend: "convex",
+          runtime: "none",
+          database: "none",
+          orm: "none",
+          api: "none",
+          auth: "better-auth",
+          payments: "revenuecat",
+        }),
+      );
+      expectSuccess(result);
+    });
+  });
+
   describe("No payments option", () => {
     test("none payments option", async () => {
       const result = await runTRPCTest(

apps/web/src/lib/constant.ts

@@ -995,6 +995,14 @@ export const TECH_OPTIONS: Record<
       color: "from-indigo-500 to-blue-600",
       default: false,
     },
+    {
+      id: "revenuecat",
+      name: "RevenueCat",
+      description: "In-app subscriptions and cross-platform monetization for mobile.",
+      icon: "https://cdn.simpleicons.org/revenuecat/F2545B",
+      color: "from-red-400 to-red-600",
+      default: false,
+    },
     {
       id: "none",
       name: "No Payments",

apps/web/src/lib/tech-resource-links.ts

@@ -420,6 +420,7 @@ const BASE_LINKS: LinkMap = {
     githubUrl: "https://github.com/PaddleHQ/paddle-node-sdk",
   },
   dodo: { docsUrl: "https://docs.dodopayments.com/" },
+  revenuecat: { docsUrl: "https://www.revenuecat.com/docs" },
   resend: {
     docsUrl: "https://resend.com/docs",
     githubUrl: "https://github.com/resend/resend-node",

packages/template-generator/src/processors/env-vars.ts

@@ -525,6 +525,7 @@ function buildNativeVars(
   frontend: string[],
   backend: ProjectConfig["backend"],
   auth: ProjectConfig["auth"],
+  payments: ProjectConfig["payments"],
   mobilePush: ProjectConfig["mobilePush"],
   mobileDeepLinking: ProjectConfig["mobileDeepLinking"],
 ): EnvVariable[] {
@@ -574,6 +575,26 @@ function buildNativeVars(
     });
   }
 
+  if (payments === "revenuecat") {
+    vars.push(
+      {
+        key: "EXPO_PUBLIC_REVENUECAT_IOS_KEY",
+        value: "",
+        condition: true,
+      },
+      {
+        key: "EXPO_PUBLIC_REVENUECAT_ANDROID_KEY",
+        value: "",
+        condition: true,
+      },
+      {
+        key: "EXPO_PUBLIC_REVENUECAT_ENTITLEMENT_ID",
+        value: "pro",
+        condition: true,
+      },
+    );
+  }
+
   if (mobilePush === "expo-notifications") {
     vars.push({
       key: "EXPO_PUBLIC_EAS_PROJECT_ID",
@@ -677,6 +698,15 @@ function buildConvexBackendVars(
     );
   }
 
+  if (payments === "revenuecat") {
+    vars.push({
+      key: "REVENUECAT_WEBHOOK_AUTH",
+      value: "",
+      condition: true,
+      comment: "Shared secret for RevenueCat webhook authentication (min 32 characters)",
+    });
+  }
+
   return vars;
 }
 
@@ -720,6 +750,15 @@ ${hasWeb ? "# npx convex env set SITE_URL http://localhost:3001\n" : ""}`;
 # Create a Polar webhook at https://<your-convex-site-url>/polar/events
 # Enable: product.created, product.updated, subscription.created, subscription.updated
 
+`;
+  }
+
+  if (payments === "revenuecat") {
+    commentBlocks += `# Set RevenueCat environment variables
+# npx convex env set REVENUECAT_WEBHOOK_AUTH your_webhook_secret_min_32_chars
+# Create a RevenueCat webhook at https://<your-convex-site-url>/webhooks/revenuecat
+# Set the webhook Authorization header to the same REVENUECAT_WEBHOOK_AUTH value
+
 `;
   }
 
@@ -1916,6 +1955,7 @@ export function processEnvVariables(vfs: VirtualFileSystem, config: ProjectConfi
         frontend,
         backend,
         auth,
+        payments,
         config.mobilePush,
         config.mobileDeepLinking,
       );

packages/template-generator/src/processors/payments-deps.ts

@@ -204,4 +204,27 @@ export function processPaymentsDeps(vfs: VirtualFileSystem, config: ProjectConfi
       }
     }
   }
+
+  if (payments === "revenuecat") {
+    const nativePath = "apps/native/package.json";
+    const hasNativeFrontend = frontend.some((f) =>
+      ["native-bare", "native-uniwind", "native-unistyles"].includes(f),
+    );
+
+    if (hasNativeFrontend && vfs.exists(nativePath)) {
+      addPackageDependency({
+        vfs,
+        packagePath: nativePath,
+        dependencies: ["react-native-purchases"],
+      });
+    }
+
+    if (backend === "convex" && vfs.exists(backendPath)) {
+      addPackageDependency({
+        vfs,
+        packagePath: backendPath,
+        dependencies: ["convex-revenuecat"],
+      });
+    }
+  }
 }

packages/template-generator/src/template-handlers/payments.ts

@@ -18,6 +18,14 @@ export async function processPaymentsTemplates(
   const hasSvelteWeb = config.frontend.includes("svelte");
   const hasSolidWeb = config.frontend.includes("solid");
 
+  const nativeVariant = config.frontend.includes("native-bare")
+    ? "bare"
+    : config.frontend.includes("native-uniwind")
+      ? "uniwind"
+      : config.frontend.includes("native-unistyles")
+        ? "unistyles"
+        : null;
+
   if (config.backend === "convex") {
     processTemplatesFromPrefix(
       vfs,
@@ -26,6 +34,16 @@ export async function processPaymentsTemplates(
       "packages/backend",
       config,
     );
+
+    if (config.payments === "revenuecat" && config.auth !== "better-auth") {
+      processTemplatesFromPrefix(
+        vfs,
+        templates,
+        "payments/revenuecat/convex/no-better-auth",
+        "packages/backend",
+        config,
+      );
+    }
   } else if (config.backend !== "none") {
     processTemplatesFromPrefix(
       vfs,
@@ -36,12 +54,30 @@ export async function processPaymentsTemplates(
     );
   }
 
+  if (nativeVariant) {
+    processTemplatesFromPrefix(
+      vfs,
+      templates,
+      `payments/${config.payments}/native/base`,
+      "apps/native",
+      config,
+    );
+    processTemplatesFromPrefix(
+      vfs,
+      templates,
+      `payments/${config.payments}/native/${nativeVariant}`,
+      "apps/native",
+      config,
+    );
+  }
+
+
   if (hasReactWeb) {
     const reactFramework = config.frontend.includes("react-vite")
       ? "react-router"
       : config.frontend.find((f) =>
-          ["tanstack-router", "react-router", "tanstack-start", "next", "vinext"].includes(f),
-        );
+        ["tanstack-router", "react-router", "tanstack-start", "next", "vinext"].includes(f),
+      );
     if (reactFramework) {
       processTemplatesFromPrefix(
         vfs,

packages/template-generator/src/utils/add-deps.ts

@@ -630,6 +630,10 @@ export const dependencyVersionMap = {
   dodopayments: "^2.40.1",
   "dodopayments-checkout": "^1.9.4",
 
+  // Payments - RevenueCat
+  "react-native-purchases": "^9.10.5",
+  "convex-revenuecat": "^0.3.2",
+
   // File Upload - UploadThing
   uploadthing: "^7.7.4",
   "@uploadthing/react": "^7.3.3",