From 95f50d5bd6d5f44e5309c4f183a83efb92e66201 Mon Sep 17 00:00:00 2001
From: kipavy <kiki.kalagan@gmail.com>
Date: Thu, 22 Oct 2026 17:19:05 +0200
Subject: [PATCH 1/2] feat(android): hide purchase links in the Google Play
 build

Google Play does not allow linking to an outside payment page. Builds made
with VITE_DISTRIBUTION=play now never open checkout or the billing portal,
and the mobile purchase prompts (account page, vault limit, trial expired,
Business lock, Teams members prompt, Voltius sync) show
"Available with <plan>" instead. Desktop and the GitHub APK are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015Ly4RP96nLUnj4FWtWthpE
---
 src/components/members/panels/MembersCTA.tsx  |  4 ++
 .../mobile/screens/MobileAccountPage.tsx      | 10 ++--
 src/components/shared/AvailableWithPlan.tsx   |  7 +++
 src/components/shared/BusinessLockBanner.tsx  |  4 ++
 src/components/shared/TrialExpiredModal.tsx   |  6 +++
 src/components/shared/VaultLimitModal.tsx     |  4 ++
 src/i18n/locales/cs/shared.json               |  3 +-
 src/i18n/locales/en/shared.json               |  3 +-
 src/i18n/locales/fr/shared.json               |  3 +-
 src/i18n/locales/ru/shared.json               |  3 +-
 src/i18n/locales/tr/shared.json               |  3 +-
 src/i18n/locales/zh/shared.json               |  3 +-
 src/services/billingCheckout.ts               |  2 +
 src/services/distribution.test.ts             | 53 +++++++++++++++++++
 src/services/distribution.ts                  |  6 +++
 src/services/syncProviders.ts                 |  3 +-
 src/utils/billing.ts                          |  2 +
 src/vite-env.d.ts                             |  5 ++
 18 files changed, 114 insertions(+), 10 deletions(-)
 create mode 100644 src/components/shared/AvailableWithPlan.tsx
 create mode 100644 src/services/distribution.test.ts
 create mode 100644 src/services/distribution.ts

diff --git a/src/components/members/panels/MembersCTA.tsx b/src/components/members/panels/MembersCTA.tsx
index 37563404f..c66182be7 100644
--- a/src/components/members/panels/MembersCTA.tsx
+++ b/src/components/members/panels/MembersCTA.tsx
@@ -2,6 +2,8 @@ import { Icon } from "@iconify/react";
 import { useTranslation } from "react-i18next";
 import { openBillingCheckout } from "@/services/billingCheckout";
 import { TEAMS_TRIAL_DAYS } from "@/services/billingTrial";
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
+import { AvailableWithPlan } from "@/components/shared/AvailableWithPlan";
 
 export function SignInToCloudCTA({ onSignIn }: { onSignIn: () => void }) {
   const { t } = useTranslation();
@@ -44,6 +46,7 @@ export function UpgradeToTeamsCTA() {
           {t("members.cta.upgradeDesc")}
         </p>
       </div>
+      {!CAN_OPEN_CHECKOUT ? <AvailableWithPlan plan="Teams" /> : (<>
       <button
         onClick={() => void openCheckout()}
         className="flex items-center gap-2 px-4 py-2 rounded-lg text-sm font-medium text-white transition-opacity hover:opacity-90"
@@ -52,6 +55,7 @@ export function UpgradeToTeamsCTA() {
         {t("members.cta.upgradeBtn", { days: TEAMS_TRIAL_DAYS })}
       </button>
       <p className="-mt-3 text-xs text-(--t-text-dim)">{t("members.cta.trialNote")}</p>
+      </>)}
     </div>
   );
 }
diff --git a/src/components/mobile/screens/MobileAccountPage.tsx b/src/components/mobile/screens/MobileAccountPage.tsx
index c9f566a2b..82cbeb501 100644
--- a/src/components/mobile/screens/MobileAccountPage.tsx
+++ b/src/components/mobile/screens/MobileAccountPage.tsx
@@ -12,6 +12,8 @@ import { getCurrentUserEmail, logout } from "@/services/account";
 import { openBillingCheckout } from "@/services/billingCheckout";
 import { TEAMS_TRIAL_DAYS } from "@/services/billingTrial";
 import { openPortal } from "@/utils/billing";
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
+import { AvailableWithPlan } from "@/components/shared/AvailableWithPlan";
 import { useServerBillingEnabled } from "@/services/serverCapabilities";
 import { useSeatReadout } from "@/hooks/useSeatReadout";
 import { seatsUsedText } from "@/services/seatMath";
@@ -115,7 +117,9 @@ export default function MobileAccountPage() {
               </div>
             )}
 
-            {!isPro && (
+            {!isPro && !CAN_OPEN_CHECKOUT && <AvailableWithPlan plan="Pro" />}
+
+            {!isPro && CAN_OPEN_CHECKOUT && (
               <button
                 data-account-upgrade-pro
                 disabled={checkoutBusy}
@@ -127,7 +131,7 @@ export default function MobileAccountPage() {
               </button>
             )}
 
-            {isPro && !isTeams && (
+            {isPro && !isTeams && CAN_OPEN_CHECKOUT && (
               <>
                 <button
                   data-account-upgrade-teams
@@ -142,7 +146,7 @@ export default function MobileAccountPage() {
               </>
             )}
 
-            {billingEnabled && (
+            {billingEnabled && CAN_OPEN_CHECKOUT && (
               <button
                 data-account-manage-billing
                 onClick={() => void openPortal()}
diff --git a/src/components/shared/AvailableWithPlan.tsx b/src/components/shared/AvailableWithPlan.tsx
new file mode 100644
index 000000000..4e51909bf
--- /dev/null
+++ b/src/components/shared/AvailableWithPlan.tsx
@@ -0,0 +1,7 @@
+import { useTranslation } from "react-i18next";
+
+/** Stands in for a purchase button in builds that may not link to checkout. */
+export function AvailableWithPlan({ plan, className = "" }: { plan: "Pro" | "Teams" | "Business"; className?: string }) {
+  const { t } = useTranslation();
+  return <p className={`text-xs text-center text-(--t-text-dim) ${className}`}>{t("shared.availableWith", { plan })}</p>;
+}
diff --git a/src/components/shared/BusinessLockBanner.tsx b/src/components/shared/BusinessLockBanner.tsx
index 2c7509445..a03b7e311 100644
--- a/src/components/shared/BusinessLockBanner.tsx
+++ b/src/components/shared/BusinessLockBanner.tsx
@@ -3,6 +3,7 @@ import { Icon } from "@iconify/react";
 import { useTranslation } from "react-i18next";
 import { useBusinessLock } from "@/hooks/useBusinessLock";
 import { openBillingCheckout } from "@/services/billingCheckout";
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
 
 export function UpgradeAction({ teamId, look }: { teamId: string; look: "button" | "link" }) {
   const { t } = useTranslation();
@@ -12,6 +13,9 @@ export function UpgradeAction({ teamId, look }: { teamId: string; look: "button"
     return look === "link" ? null : <p className="text-xs text-(--t-text-dim)">{t("shared.businessLock.ownerOnly")}</p>;
   }
   if (isOwner !== true) return null;
+  if (!CAN_OPEN_CHECKOUT) {
+    return look === "link" ? null : <p className="text-xs text-(--t-text-dim)">{t("shared.availableWith", { plan: "Business" })}</p>;
+  }
   if (look === "link") {
     return <button type="button" onClick={upgrade} className="text-xs text-(--t-accent)">{t("shared.businessLock.upgrade")}</button>;
   }
diff --git a/src/components/shared/TrialExpiredModal.tsx b/src/components/shared/TrialExpiredModal.tsx
index e3a259439..27e10845f 100644
--- a/src/components/shared/TrialExpiredModal.tsx
+++ b/src/components/shared/TrialExpiredModal.tsx
@@ -6,6 +6,8 @@ import { UpgradeStrip } from "@/components/shared/UpgradeStrip";
 import { useSubscriptionStore } from "@/stores/subscriptionStore";
 import { openBillingCheckout } from "@/services/billingCheckout";
 import { TEAMS_TRIAL_DAYS } from "@/services/billingTrial";
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
+import { AvailableWithPlan } from "@/components/shared/AvailableWithPlan";
 
 const STORAGE_KEY = "voltius_trial_expired_shown";
 
@@ -65,20 +67,24 @@ export function TrialExpiredModal() {
           {t("shared.trialExpiredModal.freeNote")}
         </p>
 
+        {CAN_OPEN_CHECKOUT && (
         <UpgradeStrip
           variant="neutral"
           label={t("shared.trialExpiredModal.teamsPrompt", { days: TEAMS_TRIAL_DAYS })}
           buttonLabel={t("settings.account.plan.teamsButton")}
           onClick={() => upgrade("teams")}
         />
+        )}
 
         <div className="flex items-center justify-between gap-3">
+          {CAN_OPEN_CHECKOUT ? (
           <button
             onClick={() => upgrade("pro")}
             className="btn btn-primary px-4 py-2 rounded-lg text-sm font-semibold"
           >
             {t("shared.trialExpiredModal.upgradeButton")}
           </button>
+          ) : <AvailableWithPlan plan="Pro" className="text-left" />}
           <button
             onClick={() => setVisible(false)}
             className="text-xs text-(--t-text-dim) hover:text-(--t-text-primary) transition-colors"
diff --git a/src/components/shared/VaultLimitModal.tsx b/src/components/shared/VaultLimitModal.tsx
index c648c0ef0..6b65a8659 100644
--- a/src/components/shared/VaultLimitModal.tsx
+++ b/src/components/shared/VaultLimitModal.tsx
@@ -5,6 +5,8 @@ import { useSubscriptionStore } from "@/stores/subscriptionStore";
 import { useVaultStore } from "@/stores/vaultStore";
 import { useUIStore } from "@/stores/uiStore";
 import { openBillingCheckout } from "@/services/billingCheckout";
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
+import { AvailableWithPlan } from "@/components/shared/AvailableWithPlan";
 
 /** Free accounts keep the one vault they start with; more vaults are a Pro feature. */
 export function useVaultLimitReached(): boolean {
@@ -50,12 +52,14 @@ export function VaultLimitModal({ onClose }: { onClose: () => void }) {
         </div>
 
         <div className="flex flex-col gap-2">
+          {isCloudAccount && !CAN_OPEN_CHECKOUT ? <AvailableWithPlan plan="Pro" className="py-2" /> : (
           <button
             onClick={isCloudAccount ? () => void upgrade() : signIn}
             className="w-full py-2.5 rounded-lg text-sm font-semibold bg-(--t-accent) text-white hover:opacity-90 transition-opacity"
           >
             {isCloudAccount ? t("layout.vaultSidebar.upgradeToPro") : t("layout.vaultSidebar.signInOrCreate")}
           </button>
+          )}
           <button
             onClick={onClose}
             className="w-full py-2.5 rounded-lg text-sm text-(--t-text-muted) hover:text-(--t-text-primary) transition-colors"
diff --git a/src/i18n/locales/cs/shared.json b/src/i18n/locales/cs/shared.json
index fadb682e6..3e4cc649c 100644
--- a/src/i18n/locales/cs/shared.json
+++ b/src/i18n/locales/cs/shared.json
@@ -205,6 +205,7 @@
       "memberLine": "Oprávnění pro jednotlivé členy vyžadují Business.",
       "objectLine": "Oprávnění pro jednotlivé objekty vyžadují Business.",
       "removeOverrides": "Odebrat přepsání"
-    }
+    },
+    "availableWith": "K dispozici s {{plan}}"
   }
 }
diff --git a/src/i18n/locales/en/shared.json b/src/i18n/locales/en/shared.json
index dddbc1533..0962c2af5 100644
--- a/src/i18n/locales/en/shared.json
+++ b/src/i18n/locales/en/shared.json
@@ -195,6 +195,7 @@
       "memberLine": "Per-member permissions need Business.",
       "objectLine": "Per-object permissions need Business.",
       "removeOverrides": "Remove overrides"
-    }
+    },
+    "availableWith": "Available with {{plan}}"
   }
 }
diff --git a/src/i18n/locales/fr/shared.json b/src/i18n/locales/fr/shared.json
index 17c82b3d0..e25a04995 100644
--- a/src/i18n/locales/fr/shared.json
+++ b/src/i18n/locales/fr/shared.json
@@ -200,6 +200,7 @@
       "memberLine": "Les permissions par membre nécessitent le forfait Business.",
       "objectLine": "Les permissions par objet nécessitent le forfait Business.",
       "removeOverrides": "Supprimer les dérogations"
-    }
+    },
+    "availableWith": "Disponible avec {{plan}}"
   }
 }
diff --git a/src/i18n/locales/ru/shared.json b/src/i18n/locales/ru/shared.json
index 293fbe558..fe509ad9e 100644
--- a/src/i18n/locales/ru/shared.json
+++ b/src/i18n/locales/ru/shared.json
@@ -205,6 +205,7 @@
       "memberLine": "Права отдельных участников доступны на тарифе Business.",
       "objectLine": "Права отдельных объектов доступны на тарифе Business.",
       "removeOverrides": "Удалить исключения"
-    }
+    },
+    "availableWith": "Доступно в {{plan}}"
   }
 }
diff --git a/src/i18n/locales/tr/shared.json b/src/i18n/locales/tr/shared.json
index 2c7bef693..7372c7a9e 100644
--- a/src/i18n/locales/tr/shared.json
+++ b/src/i18n/locales/tr/shared.json
@@ -195,6 +195,7 @@
       "memberLine": "Üye bazlı izinler Business planını gerektirir.",
       "objectLine": "Nesne bazlı izinler Business planını gerektirir.",
       "removeOverrides": "Geçersiz kılmaları kaldır"
-    }
+    },
+    "availableWith": "{{plan}} ile kullanılabilir"
   }
 }
diff --git a/src/i18n/locales/zh/shared.json b/src/i18n/locales/zh/shared.json
index 79b785d30..554b108ee 100644
--- a/src/i18n/locales/zh/shared.json
+++ b/src/i18n/locales/zh/shared.json
@@ -195,6 +195,7 @@
       "memberLine": "按成员的权限需要 Business 套餐。",
       "objectLine": "按对象的权限需要 Business 套餐。",
       "removeOverrides": "移除覆盖设置"
-    }
+    },
+    "availableWith": "{{plan}} 可用"
   }
 }
diff --git a/src/services/billingCheckout.ts b/src/services/billingCheckout.ts
index d19263442..cc3106a33 100644
--- a/src/services/billingCheckout.ts
+++ b/src/services/billingCheckout.ts
@@ -2,6 +2,7 @@ import { invoke } from "@/lib/invoke";
 import { openUrl } from "@tauri-apps/plugin-opener";
 import { appFetch } from "@/services/http";
 import { checkoutRequiresEmailVerification } from "@/utils/emailVerification";
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
 
 export const EMAIL_VERIFICATION_REQUIRED_EVENT = "voltius:email-verification-required";
 
@@ -22,6 +23,7 @@ async function readResponseBody(res: Response): Promise<unknown> {
 }
 
 export async function openBillingCheckout(plan: BillingPlan, options: CheckoutOptions = {}): Promise<boolean> {
+  if (!CAN_OPEN_CHECKOUT) return false;
   const [serverUrl, jwt] = await Promise.all([
     invoke<string | null>("keychain_get", { key: "server_url" }),
     invoke<string | null>("keychain_get", { key: "jwt" }),
diff --git a/src/services/distribution.test.ts b/src/services/distribution.test.ts
new file mode 100644
index 000000000..dd6d2f894
--- /dev/null
+++ b/src/services/distribution.test.ts
@@ -0,0 +1,53 @@
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+const invoke = vi.hoisted(() => vi.fn());
+const openUrl = vi.hoisted(() => vi.fn());
+vi.mock("@/lib/invoke", () => ({ invoke }));
+vi.mock("@tauri-apps/plugin-opener", () => ({ openUrl }));
+
+afterEach(() => {
+  vi.unstubAllEnvs();
+  vi.resetModules();
+  invoke.mockReset();
+  openUrl.mockReset();
+});
+
+describe("Google Play build", () => {
+  it("opens neither checkout nor the billing portal", async () => {
+    vi.stubEnv("VITE_DISTRIBUTION", "play");
+    const { openBillingCheckout } = await import("@/services/billingCheckout");
+    const { openPortal } = await import("@/utils/billing");
+
+    expect(await openBillingCheckout("pro")).toBe(false);
+    await openPortal();
+
+    expect(invoke).not.toHaveBeenCalled();
+    expect(openUrl).not.toHaveBeenCalled();
+  });
+
+  it("offers no Voltius sync upgrade action", async () => {
+    vi.stubEnv("VITE_DISTRIBUTION", "play");
+    const { buildSyncProviders } = await import("@/services/syncProviders");
+    const [voltius] = buildSyncProviders({
+      voltius: {
+        label: "Voltius Sync",
+        state: { status: "idle", lastSync: null, error: null, blobSizeBytes: null },
+        accountMode: "server",
+        isPro: false,
+        paused: false,
+        syncNow: vi.fn(async () => {}),
+      },
+      plugins: [],
+      settingsPages: [],
+    });
+    expect(voltius).toMatchObject({ availability: "needs_upgrade", action: null });
+  });
+});
+
+describe("other builds", () => {
+  it("keep checkout", async () => {
+    const { CAN_OPEN_CHECKOUT } = await import("@/services/distribution");
+    expect(CAN_OPEN_CHECKOUT).toBe(true);
+  });
+});
diff --git a/src/services/distribution.ts b/src/services/distribution.ts
new file mode 100644
index 000000000..b277756f8
--- /dev/null
+++ b/src/services/distribution.ts
@@ -0,0 +1,6 @@
+/**
+ * Google Play builds (VITE_DISTRIBUTION=play) must not send users to an outside
+ * payment page, so they show no purchase or billing-portal buttons. Plans are
+ * bought on the website or from the desktop app; signing in unlocks them here.
+ */
+export const CAN_OPEN_CHECKOUT: boolean = import.meta.env.VITE_DISTRIBUTION !== "play";
diff --git a/src/services/syncProviders.ts b/src/services/syncProviders.ts
index 576289f3a..6ed241e0a 100644
--- a/src/services/syncProviders.ts
+++ b/src/services/syncProviders.ts
@@ -1,3 +1,4 @@
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
 import type { PluginManifest, SettingsPage, SyncProviderAvailability, SyncProviderSummary } from "@/plugins/api";
 import type { MarketplacePlugin } from "@/stores/marketplaceStore";
 import { attributePage } from "@/plugins/attributePage";
@@ -69,7 +70,7 @@ const STATUS_RANK: Record<SyncStatus, number> = { idle: 0, success: 1, syncing:
 
 const VOLTIUS_ACTIONS: Partial<Record<SyncProviderAvailability, SyncProviderAction>> = {
   locked: { kind: "signIn" },
-  needs_upgrade: { kind: "upgrade" },
+  ...(CAN_OPEN_CHECKOUT ? { needs_upgrade: { kind: "upgrade" } as const } : {}),
   paused: { kind: "resume" },
 };
 
diff --git a/src/utils/billing.ts b/src/utils/billing.ts
index f8333a19e..59f2c762b 100644
--- a/src/utils/billing.ts
+++ b/src/utils/billing.ts
@@ -1,8 +1,10 @@
+import { CAN_OPEN_CHECKOUT } from "@/services/distribution";
 import { openUrl } from "@tauri-apps/plugin-opener";
 import { invoke } from "@/lib/invoke";
 import { isDefaultServer } from "@/utils/serverInstance";
 
 export async function openPortal(): Promise<void> {
+  if (!CAN_OPEN_CHECKOUT) return;
   const [serverUrl, jwt] = await Promise.all([
     invoke<string | null>("keychain_get", { key: "server_url" }).catch(() => null),
     invoke<string | null>("keychain_get", { key: "jwt" }).catch(() => null),
diff --git a/src/vite-env.d.ts b/src/vite-env.d.ts
index 757dde74e..0d1f96054 100644
--- a/src/vite-env.d.ts
+++ b/src/vite-env.d.ts
@@ -1,6 +1,11 @@
 /// <reference types="vite/client" />
 /// <reference types="vite-plugin-svgr/client" />
 
+interface ImportMetaEnv {
+  /** "play" for the Google Play bundle; unset everywhere else. */
+  readonly VITE_DISTRIBUTION?: string;
+}
+
 declare module "virtual:lucide-subset" {
   const data: import("@iconify/types").IconifyJSON;
   export default data;

From a8e8b9a8cc81b18f53dac3b98e9d5c5303c5607d Mon Sep 17 00:00:00 2001
From: kipavy <kiki.kalagan@gmail.com>
Date: Fri, 23 Oct 2026 20:17:54 +0200
Subject: [PATCH 2/2] i18n(pt): translate the Google Play "Available with
 <plan>" label

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015Ly4RP96nLUnj4FWtWthpE
---
 src/i18n/locales/pt-PT/shared.json | 3 ++-
 src/i18n/locales/pt/shared.json    | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/i18n/locales/pt-PT/shared.json b/src/i18n/locales/pt-PT/shared.json
index 61107aafa..6ed7fdf6a 100644
--- a/src/i18n/locales/pt-PT/shared.json
+++ b/src/i18n/locales/pt-PT/shared.json
@@ -200,6 +200,7 @@
       "failed": "Não foi possível eliminar a sua conta (erro {{status}}). Tente novamente mais tarde ou contacte o suporte.",
       "ownsTeamWithMembers": "É o único proprietário de uma equipa que ainda tem outros membros ({{teams}}). Torne outro membro proprietário, remova os membros ou elimine a equipa e tente novamente.",
       "subscriptionCancelFailed": "Não foi possível cancelar a sua subscrição, por isso a sua conta não foi eliminada. Tente novamente dentro de alguns minutos ou contacte o suporte."
-    }
+    },
+    "availableWith": "Disponível com {{plan}}"
   }
 }
diff --git a/src/i18n/locales/pt/shared.json b/src/i18n/locales/pt/shared.json
index 7f8d3a735..287e62f25 100644
--- a/src/i18n/locales/pt/shared.json
+++ b/src/i18n/locales/pt/shared.json
@@ -200,6 +200,7 @@
       "failed": "Não foi possível excluir sua conta (erro {{status}}). Tente novamente mais tarde ou entre em contato com o suporte.",
       "ownsTeamWithMembers": "Você é o único proprietário de uma equipe que ainda tem outros membros ({{teams}}). Torne outro membro proprietário, remova os membros ou exclua a equipe e tente novamente.",
       "subscriptionCancelFailed": "Não foi possível cancelar sua assinatura, então sua conta não foi excluída. Tente novamente em alguns minutos ou entre em contato com o suporte."
-    }
+    },
+    "availableWith": "Disponível com {{plan}}"
   }
 }