kasy-cli 1.15.0 → 1.17.0

package/lib/scaffold/shared/generator-utils.js

@@ -13,6 +13,36 @@ const pkg = require('../../../package.json');
 /** Backend IDs: firebase | supabase | api */
 const BACKENDS = Object.freeze(['firebase', 'supabase', 'api']);
 
+/**
+ * Resolve the default RC keys to bake into launch.json / Makefile.
+ *
+ * `kasy run` overrides these at runtime based on the device picked (test_ for
+ * simulator/emulator, appl_/goog_ for physical). The values here are only used
+ * when the user runs Flutter directly (e.g. F5 in VS Code, `make run`) without
+ * going through `kasy run`. We default to test_ since that's what works in the
+ * iOS Simulator and Android Emulator — the common dev case.
+ *
+ * Legacy support: projects generated before this refactor only ask for a single
+ * Android/iOS key (`rcAndroidKey` / `rcIosKey`). When those are passed we honor
+ * them as-is.
+ */
+function resolveDefaultRcKeys(answers) {
+  // Legacy single-key format (pre-test/prod split): keep behavior unchanged.
+  if ((answers.rcAndroidKey || answers.rcIosKey) && !answers.rcTestKey && !answers.rcIosProdKey && !answers.rcAndroidProdKey) {
+    return {
+      android: answers.rcAndroidKey || 'YOUR_REVENUECAT_ANDROID_KEY',
+      ios: answers.rcIosKey || 'YOUR_REVENUECAT_IOS_KEY',
+    };
+  }
+  const test = (answers.rcTestKey || '').trim();
+  const iosProd = (answers.rcIosProdKey || '').trim();
+  const androidProd = (answers.rcAndroidProdKey || '').trim();
+  return {
+    android: test || androidProd || 'YOUR_REVENUECAT_ANDROID_KEY',
+    ios: test || iosProd || 'YOUR_REVENUECAT_IOS_KEY',
+  };
+}
+
 /**
  * Build dart-define args for dev and prod environments.
  * Backend-specific vars: Firebase (none extra), Supabase (BACKEND_URL, SUPABASE_TOKEN), API (BACKEND_URL).
@@ -40,12 +70,11 @@ function buildDartDefines(backend, modules, answers) {
   }
 
   if (modules.includes('revenuecat')) {
-    const androidKey = answers.rcAndroidKey || 'YOUR_REVENUECAT_ANDROID_KEY';
-    const iosKey = answers.rcIosKey || 'YOUR_REVENUECAT_IOS_KEY';
-    dev.push(`--dart-define=RC_ANDROID_API_KEY=${androidKey}`);
-    dev.push(`--dart-define=RC_IOS_API_KEY=${iosKey}`);
-    prod.push(`--dart-define=RC_ANDROID_API_KEY=${androidKey}`);
-    prod.push(`--dart-define=RC_IOS_API_KEY=${iosKey}`);
+    const { android: androidDefault, ios: iosDefault } = resolveDefaultRcKeys(answers);
+    dev.push(`--dart-define=RC_ANDROID_API_KEY=${androidDefault}`);
+    dev.push(`--dart-define=RC_IOS_API_KEY=${iosDefault}`);
+    prod.push(`--dart-define=RC_ANDROID_API_KEY=${androidDefault}`);
+    prod.push(`--dart-define=RC_IOS_API_KEY=${iosDefault}`);
     if (answers.revenuecatWeb) {
       const webKey = answers.rcWebKey || 'YOUR_REVENUECAT_WEB_KEY';
       dev.push(`--dart-define=RC_WEB_API_KEY=${webKey}`);
@@ -144,8 +173,11 @@ async function writeEnvExample(projectDir, modules, answers, language = 'en') {
   if (modules.includes('revenuecat')) {
     lines.push('');
     lines.push(t.revenuecat);
-    lines.push(`RC_ANDROID_API_KEY=${answers.rcAndroidKey || 'YOUR_REVENUECAT_ANDROID_KEY'}`);
-    lines.push(`RC_IOS_API_KEY=${answers.rcIosKey || 'YOUR_REVENUECAT_IOS_KEY'}`);
+    if (t.revenuecatTest) lines.push(t.revenuecatTest);
+    lines.push(`RC_TEST_KEY=${(answers.rcTestKey || '').trim()}`);
+    if (t.revenuecatProd) lines.push(t.revenuecatProd);
+    lines.push(`RC_IOS_PROD_KEY=${(answers.rcIosProdKey || '').trim()}`);
+    lines.push(`RC_ANDROID_PROD_KEY=${(answers.rcAndroidProdKey || '').trim()}`);
     if (answers.revenuecatWeb) {
       lines.push(`RC_WEB_API_KEY=${answers.rcWebKey || 'YOUR_REVENUECAT_WEB_KEY'}`);
     }
@@ -468,6 +500,16 @@ const bool revenuecatWeb = ${revenuecatWeb};
 async function writeKitSetup(projectDir, options) {
   const { appName, bundleId, backend, modules = [], firebaseProjectId, supabaseUrl, supabaseAnonKey, moduleAnswers = {} } = options;
   const revenuecatWeb = !!(modules.includes('revenuecat') && modules.includes('web') && moduleAnswers.revenuecatWeb);
+  // Booleans tracking which RC keys the user configured. We never persist key
+  // values to kit_setup.json — those live in .env (gitignored). These flags
+  // let `kasy doctor` warn about release readiness without re-reading .env.
+  const revenuecatKeys = modules.includes('revenuecat')
+    ? {
+        test: !!(moduleAnswers.rcTestKey && moduleAnswers.rcTestKey.trim()),
+        iosProd: !!(moduleAnswers.rcIosProdKey && moduleAnswers.rcIosProdKey.trim()),
+        androidProd: !!(moduleAnswers.rcAndroidProdKey && moduleAnswers.rcAndroidProdKey.trim()),
+      }
+    : undefined;
   const config = {
     appName: appName || 'App',
     bundleId: bundleId || 'com.example.app',
@@ -480,6 +522,7 @@ async function writeKitSetup(projectDir, options) {
     storageProvider: backend === 'firebase' ? 'firebase' : backend === 'supabase' ? 'supabase' : 'api',
     webCompat: modules.includes('web'),
     revenuecatWeb,
+    ...(revenuecatKeys ? { revenuecatKeys } : {}),
     internationalization: true,
     useSentry: modules.includes('sentry'),
     withOnboarding: modules.includes('onboarding'),
@@ -1638,6 +1681,7 @@ async function localizeReleaseDocs(projectDir, language = 'en') {
 module.exports = {
   BACKENDS,
   buildDartDefines,
+  resolveDefaultRcKeys,
   writeRouter,
   writeVsCodeLaunch,
   writeEnvExample,

package/lib/scaffold/shared/post-build.js

@@ -665,49 +665,123 @@ async function validateFacebookAndroidStrings(projectDir) {
 }
 
 /**
- * Validate RevenueCat API keys (RC_IOS_API_KEY, RC_ANDROID_API_KEY) from the project Makefile
- * and return the webhook URL derived from kit_setup.json backend config.
+ * Read a project `.env` file into a plain object. Returns `{}` if the file is
+ * missing. Supports KEY=VALUE lines; ignores comments and blank lines.
  */
-async function validateRevenueCat(projectDir, config = {}) {
-  const makefilePath = path.join(projectDir, 'Makefile');
-  if (!(await fs.pathExists(makefilePath))) {
-    return { ok: true, skipped: true, reason: 'no_makefile' };
-  }
-
+async function readDotenv(projectDir) {
+  const envPath = path.join(projectDir, '.env');
+  if (!(await fs.pathExists(envPath))) return {};
   let content;
   try {
-    content = await fs.readFile(makefilePath, 'utf8');
-  } catch (err) {
-    return { ok: false, error: `Failed to read Makefile: ${err.message}` };
+    content = await fs.readFile(envPath, 'utf8');
+  } catch {
+    return {};
+  }
+  const env = {};
+  for (const rawLine of content.split('\n')) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith('#')) continue;
+    const eq = line.indexOf('=');
+    if (eq === -1) continue;
+    const key = line.slice(0, eq).trim();
+    let value = line.slice(eq + 1).trim();
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+    if (key) env[key] = value;
   }
+  return env;
+}
 
-  // Only consider non-commented lines
-  const activeLines = content.split('\n').filter((l) => !/^\s*#/.test(l)).join('\n');
-
-  const iosMatch = activeLines.match(/RC_IOS_API_KEY=([^\s\\]+)/);
-  const androidMatch = activeLines.match(/RC_ANDROID_API_KEY=([^\s\\]+)/);
-
-  const iosKey = iosMatch ? iosMatch[1].trim() : '';
-  const androidKey = androidMatch ? androidMatch[1].trim() : '';
-
-  const iosEmpty = !iosKey || iosKey === 'xxx';
-  const androidEmpty = !androidKey || androidKey === 'xxx';
-
-  const iosTest = iosKey.startsWith('test_');
-  const androidTest = androidKey.startsWith('test_');
+/**
+ * Validate RevenueCat keys. The new `.env` is the source of truth:
+ *   RC_TEST_KEY (test_xxx — simulator/emulator)
+ *   RC_IOS_PROD_KEY (appl_xxx — physical iOS)
+ *   RC_ANDROID_PROD_KEY (goog_xxx — physical Android)
+ *
+ * Legacy fallback: if none of the new vars are set we read the old
+ * RC_ANDROID_API_KEY/RC_IOS_API_KEY from `.env`, and finally the Makefile
+ * (oldest projects). Returns flags `doctor.js` uses to render granular hints.
+ */
+async function validateRevenueCat(projectDir, config = {}) {
+  const env = await readDotenv(projectDir);
 
+  // Webhook URL (only Supabase exposes it directly; Firebase points to Console).
   let webhookUrl = null;
   if (config.backendProvider === 'supabase' && config.supabaseProjectId) {
     webhookUrl = `https://${config.supabaseProjectId}.supabase.co/functions/v1/revenuecat-webhook`;
   }
 
+  const testKey = (env.RC_TEST_KEY || '').trim();
+  const iosProdKey = (env.RC_IOS_PROD_KEY || '').trim();
+  const androidProdKey = (env.RC_ANDROID_PROD_KEY || '').trim();
+  const hasNewKeys = !!(testKey || iosProdKey || androidProdKey);
+
+  // Legacy single-key path (for projects generated before the test/prod split).
+  if (!hasNewKeys) {
+    let iosKey = (env.RC_IOS_API_KEY || '').trim();
+    let androidKey = (env.RC_ANDROID_API_KEY || '').trim();
+
+    // Last resort: read from Makefile (oldest projects).
+    if (!iosKey && !androidKey) {
+      const makefilePath = path.join(projectDir, 'Makefile');
+      if (await fs.pathExists(makefilePath)) {
+        try {
+          const content = await fs.readFile(makefilePath, 'utf8');
+          const activeLines = content.split('\n').filter((l) => !/^\s*#/.test(l)).join('\n');
+          const iosMatch = activeLines.match(/RC_IOS_API_KEY=([^\s\\]+)/);
+          const androidMatch = activeLines.match(/RC_ANDROID_API_KEY=([^\s\\]+)/);
+          iosKey = iosMatch ? iosMatch[1].trim() : '';
+          androidKey = androidMatch ? androidMatch[1].trim() : '';
+        } catch { /* ignore */ }
+      }
+    }
+
+    const iosEmpty = !iosKey || iosKey === 'xxx';
+    const androidEmpty = !androidKey || androidKey === 'xxx';
+    const iosTest = iosKey.startsWith('test_');
+    const androidTest = androidKey.startsWith('test_');
+
+    return {
+      ok: !iosEmpty && !androidEmpty,
+      legacy: true,
+      iosKey,
+      androidKey,
+      iosEmpty,
+      androidEmpty,
+      bothTest: iosTest && androidTest,
+      webhookUrl,
+    };
+  }
+
+  // New 3-key scheme.
+  const testOk = !!testKey && /^test_/.test(testKey);
+  const testBadPrefix = !!testKey && !/^test_/.test(testKey);
+  const iosProdOk = !!iosProdKey && /^appl_/.test(iosProdKey);
+  const iosProdBadPrefix = !!iosProdKey && !/^appl_/.test(iosProdKey);
+  const androidProdOk = !!androidProdKey && /^goog_/.test(androidProdKey);
+  const androidProdBadPrefix = !!androidProdKey && !/^goog_/.test(androidProdKey);
+
+  // OK if user can run at least one device flow end-to-end. Test alone is fine
+  // for development; prod-only configurations also work but skip the simulator.
+  const anyOk = testOk || iosProdOk || androidProdOk;
+
   return {
-    ok: !iosEmpty && !androidEmpty,
-    iosKey,
-    androidKey,
-    iosEmpty,
-    androidEmpty,
-    bothTest: iosTest && androidTest,
+    ok: anyOk,
+    legacy: false,
+    testKey,
+    iosProdKey,
+    androidProdKey,
+    testOk,
+    testBadPrefix,
+    iosProdOk,
+    iosProdBadPrefix,
+    androidProdOk,
+    androidProdBadPrefix,
+    testMissing: !testKey,
+    iosProdMissing: !iosProdKey,
+    androidProdMissing: !androidProdKey,
+    onlyTest: testOk && !iosProdOk && !androidProdOk,
     webhookUrl,
   };
 }

package/lib/scaffold/shared/template-strings.js

@@ -33,6 +33,8 @@ const TEMPLATE_STRINGS = {
       supabase: '# Supabase',
       apiRest: '# API REST',
       revenuecat: '# RevenueCat',
+      revenuecatTest: '# Test Store key (test_xxx) — auto-used on simulator/emulator',
+      revenuecatProd: '# Production keys — auto-used on physical devices',
       sentry: '# Sentry (prod only)',
       mixpanel: '# Mixpanel',
       llmChat: '# LLM Chat — Cloud/Edge Function endpoint (API key stays on the server, not here)',
@@ -65,6 +67,8 @@ const TEMPLATE_STRINGS = {
       supabase: '# Supabase',
       apiRest: '# API REST',
       revenuecat: '# RevenueCat',
+      revenuecatTest: '# Chave Test Store (test_xxx) — usada automaticamente em simulador/emulador',
+      revenuecatProd: '# Chaves de produção — usadas automaticamente em dispositivo físico',
       sentry: '# Sentry (apenas prod)',
       mixpanel: '# Mixpanel',
       llmChat: '# LLM Chat — endpoint da Cloud/Edge Function (a chave de API fica no servidor, não aqui)',
@@ -97,6 +101,8 @@ const TEMPLATE_STRINGS = {
       supabase: '# Supabase',
       apiRest: '# API REST',
       revenuecat: '# RevenueCat',
+      revenuecatTest: '# Clave Test Store (test_xxx) — se usa automáticamente en simulador/emulador',
+      revenuecatProd: '# Claves de producción — se usan automáticamente en dispositivo físico',
       sentry: '# Sentry (solo prod)',
       mixpanel: '# Mixpanel',
       llmChat: '# LLM Chat — endpoint de Cloud/Edge Function (la clave de API queda en el servidor, no aquí)',

package/lib/utils/i18n/messages-en.js

@@ -419,8 +419,15 @@ module.exports = {
 
     'doctor.revenuecat.title': 'RevenueCat',
     'doctor.revenuecat.keysOk': 'API keys configured (iOS + Android)',
-    'doctor.revenuecat.keysEmpty': 'API keys not configured — set RC_IOS_API_KEY and RC_ANDROID_API_KEY in Makefile and .vscode/launch.json',
-    'doctor.revenuecat.keysTest': 'Using Test Store keys (test_) — replace with appl_ and goog_ for production',
+    'doctor.revenuecat.keysEmpty': 'No keys configured — set at least RC_TEST_KEY in .env (kasy run uses it on simulator/emulator)',
+    'doctor.revenuecat.testKeyOk': 'RC_TEST_KEY configured (test_) — used on simulator/emulator',
+    'doctor.revenuecat.testKeyMissing': 'RC_TEST_KEY missing — subscription flow will not work on simulator/emulator',
+    'doctor.revenuecat.iosProdOk': 'RC_IOS_PROD_KEY configured (appl_) — used on physical iPhone',
+    'doctor.revenuecat.iosProdMissing': 'RC_IOS_PROD_KEY missing — kasy run on physical iPhone will fall back to the test key',
+    'doctor.revenuecat.androidProdOk': 'RC_ANDROID_PROD_KEY configured (goog_) — used on physical Android',
+    'doctor.revenuecat.androidProdMissing': 'RC_ANDROID_PROD_KEY missing — kasy run on physical Android will fall back to the test key',
+    'doctor.revenuecat.prefixMismatch': 'Key has wrong prefix: {key} should start with {expected}',
+    'doctor.revenuecat.keysTest': 'Only Test Store keys (test_) configured — store releases require appl_/goog_, otherwise the app crashes',
     'doctor.revenuecat.webhookUrlSupabase': 'Webhook URL (paste in RevenueCat → Integrations → Webhooks)',
     'doctor.revenuecat.webhookUrlFirebase': 'Webhook URL: Firebase Console → Functions → subscriptionsOnRcPremiumUpdate',
 
@@ -488,6 +495,14 @@ module.exports = {
     'new.firebase.q.revenuecat.webhookKey.hint': 'Save this value. In RevenueCat dashboard, paste as: Bearer <this-value>',
     'new.firebase.q.revenuecat.metaToken': 'Meta Access Token (for Ads Conversions API, optional)',
     'new.firebase.q.revenuecat.metaDataset': 'Meta Dataset ID / Pixel ID (optional)',
+    'new.firebase.q.revenuecat.test': 'Test Store key (test_xxx) — optional, works for both iOS+Android and runs in the simulator',
+    'new.firebase.q.revenuecat.test.invalid': 'Test Store key must start with test_ (e.g. test_xxxxxxxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.iosProd': 'iOS production key (appl_xxx) — optional, used only on physical iPhone',
+    'new.firebase.q.revenuecat.iosProd.invalid': 'iOS production key must start with appl_ (e.g. appl_xxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.androidProd': 'Android production key (goog_xxx) — optional, used only on physical Android',
+    'new.firebase.q.revenuecat.androidProd.invalid': 'Android production key must start with goog_ (e.g. goog_xxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.atLeastOne': 'Configure at least one key (Test, iOS prod or Android prod). You can add the others later in .env.',
+    // Legacy keys — kept for projects/scripts that still reference them.
     'new.firebase.q.revenuecat.android': 'RevenueCat API key for Android',
     'new.firebase.q.revenuecat.ios': 'RevenueCat API key for iOS',
     'new.firebase.q.paywall': 'Which paywall style?',
@@ -645,6 +660,8 @@ module.exports = {
     // run command
     'cli.command.run.description': 'Run your app on phone, simulator, or browser',
     'run.launching': 'Launching Flutter app...',
+    'run.prompt.pickDevice': 'Multiple devices detected. Which one do you want to run on?',
+    'run.warn.nothingSelected': 'No device selected.',
     'run.updateHint.prefix': 'Project improvements available —',
     'run.updateHint.suffix': 'to see what\'s new',
     'run.spinner.building': 'Starting Flutter…',
@@ -659,6 +676,12 @@ module.exports = {
     'run.stage.buildSuccess': 'Build done — launching app…',
     'run.error.notFlutterProject': 'No pubspec.yaml found. Run this command from inside a Flutter project.',
     'run.error.flutterNotFound': 'Flutter not found. Make sure Flutter is installed and on your PATH.',
+    'run.rc.usingTest': 'RevenueCat: using test key (test_) — simulator/emulator',
+    'run.rc.usingProd': 'RevenueCat: using production keys — physical device',
+    'run.rc.fallbackToTest': 'RevenueCat: production key missing ({platform}) — falling back to test_; set RC_{var} in .env to test real in-app purchases',
+    'run.rc.forcedTest': 'RevenueCat: --rc=test forced',
+    'run.rc.forcedProd': 'RevenueCat: --rc=prod forced',
+    'run.rc.forcedProdMissing': 'RevenueCat: --rc=prod requested but RC_IOS_PROD_KEY/RC_ANDROID_PROD_KEY not set in .env',
 
     // reset command
     'cli.command.reset.description': 'Uninstall the app on a simulator/emulator/device so you can test as a fresh install',
@@ -746,6 +769,11 @@ module.exports = {
     'icon.validated': 'PNG looks good',
     'icon.copying': 'Copying icon to assets/images/icon.png...',
     'icon.copied': 'Icon copied',
+    'icon.adaptive.generating': 'Generating Android adaptive variant (fills the launcher circle)...',
+    'icon.adaptive.generated': 'Android adaptive icon generated',
+    'icon.adaptive.failed': 'Failed to generate Android adaptive icon',
+    'icon.adaptive.fallbackTitle': 'Android background',
+    'icon.adaptive.fallbackColor': 'Could not sample a background color from the PNG (transparent). Used white. Edit icon_android.png if you want a different color.',
     'icon.generating': 'Regenerating native icons (Android + iOS)...',
     'icon.generated': 'Native icons regenerated',
     'icon.done': 'Done. Uninstall the app from the device and reinstall to see the new icon.',
@@ -833,6 +861,10 @@ module.exports = {
     'add.cancelled': 'Cancelled.',
     'add.prompt.sentryDsn': 'Sentry DSN (leave blank to configure later):',
     'add.prompt.mixpanelToken': 'Mixpanel Token (leave blank to configure later):',
+    'add.prompt.rcTestKey': 'Test Store key (test_xxx) — optional, works for both iOS+Android and on simulator:',
+    'add.prompt.rcIosProdKey': 'iOS production key (appl_xxx) — optional, only on physical device:',
+    'add.prompt.rcAndroidProdKey': 'Android production key (goog_xxx) — optional, only on physical device:',
+    // Legacy keys — kept for compatibility with old scripts.
     'add.prompt.rcAndroidKey': 'RevenueCat Android API key (leave blank to configure later):',
     'add.prompt.rcIosKey': 'RevenueCat iOS API key (leave blank to configure later):',
     'add.note.facebook': 'Add your Facebook App ID and token in .vscode/launch.json (FB_APP_ID, FB_TOKEN).',

package/lib/utils/i18n/messages-es.js

@@ -421,8 +421,15 @@ module.exports = {
 
     'doctor.revenuecat.title': 'RevenueCat',
     'doctor.revenuecat.keysOk': 'Claves de API configuradas (iOS + Android)',
-    'doctor.revenuecat.keysEmpty': 'Claves de API no configuradas — define RC_IOS_API_KEY y RC_ANDROID_API_KEY en Makefile y .vscode/launch.json',
-    'doctor.revenuecat.keysTest': 'Usando claves Test Store (test_) — reemplaza por appl_ y goog_ para producción',
+    'doctor.revenuecat.keysEmpty': 'Ninguna clave configurada — define al menos RC_TEST_KEY en .env (kasy run la usa en simulador/emulador)',
+    'doctor.revenuecat.testKeyOk': 'RC_TEST_KEY configurada (test_) — usada en simulador/emulador',
+    'doctor.revenuecat.testKeyMissing': 'RC_TEST_KEY ausente — el flujo de suscripción no funciona en simulador/emulador',
+    'doctor.revenuecat.iosProdOk': 'RC_IOS_PROD_KEY configurada (appl_) — usada en iPhone físico',
+    'doctor.revenuecat.iosProdMissing': 'RC_IOS_PROD_KEY ausente — kasy run en iPhone físico va a usar la clave de prueba',
+    'doctor.revenuecat.androidProdOk': 'RC_ANDROID_PROD_KEY configurada (goog_) — usada en Android físico',
+    'doctor.revenuecat.androidProdMissing': 'RC_ANDROID_PROD_KEY ausente — kasy run en Android físico va a usar la clave de prueba',
+    'doctor.revenuecat.prefixMismatch': 'Clave con prefijo incorrecto: {key} debe empezar con {expected}',
+    'doctor.revenuecat.keysTest': 'Solo claves Test Store (test_) configuradas — los releases en la tienda requieren appl_/goog_, sino el app crashea',
     'doctor.revenuecat.webhookUrlSupabase': 'URL del webhook (pega en RevenueCat → Integrations → Webhooks)',
     'doctor.revenuecat.webhookUrlFirebase': 'URL del webhook: Firebase Console → Functions → subscriptionsOnRcPremiumUpdate',
 
@@ -488,6 +495,14 @@ module.exports = {
     'new.firebase.q.revenuecat.webhookKey.hint': 'Guarda este valor. En el panel RevenueCat, pega como: Bearer <este-valor>',
     'new.firebase.q.revenuecat.metaToken': 'Meta Access Token (Conversions API, opcional)',
     'new.firebase.q.revenuecat.metaDataset': 'Meta Dataset ID / Pixel ID (opcional)',
+    'new.firebase.q.revenuecat.test': 'Clave Test Store (test_xxx) — opcional, sirve para iOS+Android y funciona en simulador',
+    'new.firebase.q.revenuecat.test.invalid': 'Clave Test Store debe empezar con test_ (ej: test_xxxxxxxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.iosProd': 'Clave iOS de producción (appl_xxx) — opcional, se usa solo en dispositivo físico',
+    'new.firebase.q.revenuecat.iosProd.invalid': 'Clave iOS de producción debe empezar con appl_ (ej: appl_xxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.androidProd': 'Clave Android de producción (goog_xxx) — opcional, se usa solo en dispositivo físico',
+    'new.firebase.q.revenuecat.androidProd.invalid': 'Clave Android de producción debe empezar con goog_ (ej: goog_xxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.atLeastOne': 'Configura al menos una clave (Test, iOS prod o Android prod). Puedes agregar las demás después en .env.',
+    // Legacy keys — kept for projects/scripts that still reference them.
     'new.firebase.q.revenuecat.android': 'Clave API RevenueCat para Android',
     'new.firebase.q.revenuecat.ios': 'Clave API RevenueCat para iOS',
     'new.firebase.q.paywall': '¿Qué estilo de paywall?',
@@ -678,6 +693,8 @@ module.exports = {
     'reset.warn.launcherCacheFailed': 'No se pudo limpiar la caché del launcher.',
     'reset.warn.launcherNotDetected': 'Launcher por defecto no detectado — saltando limpieza de caché.',
     'run.launching': 'Iniciando app Flutter...',
+    'run.prompt.pickDevice': 'Varios dispositivos detectados. ¿En cuál quieres ejecutar?',
+    'run.warn.nothingSelected': 'Ningún dispositivo seleccionado.',
     'run.updateHint.prefix': 'Mejoras disponibles para el proyecto —',
     'run.updateHint.suffix': 'para ver las novedades',
     'run.spinner.building': 'Iniciando Flutter…',
@@ -692,6 +709,12 @@ module.exports = {
     'run.stage.buildSuccess': 'Build listo — abriendo la app…',
     'run.error.notFlutterProject': 'No se encontro pubspec.yaml. Ejecuta este comando dentro de un proyecto Flutter.',
     'run.error.flutterNotFound': 'Flutter no encontrado. Verifica que Flutter este instalado y en el PATH.',
+    'run.rc.usingTest': 'RevenueCat: usando clave de prueba (test_) — simulador/emulador',
+    'run.rc.usingProd': 'RevenueCat: usando claves de producción — dispositivo físico',
+    'run.rc.fallbackToTest': 'RevenueCat: clave de producción ausente ({platform}) — usando test_; configura RC_{var} en .env para probar in-app purchase real',
+    'run.rc.forcedTest': 'RevenueCat: --rc=test forzado',
+    'run.rc.forcedProd': 'RevenueCat: --rc=prod forzado',
+    'run.rc.forcedProdMissing': 'RevenueCat: --rc=prod pedido pero RC_IOS_PROD_KEY/RC_ANDROID_PROD_KEY no configuradas en .env',
 
     // doctor project checks
     'doctor.project.title': 'Proyecto',
@@ -744,6 +767,11 @@ module.exports = {
     'icon.validated': 'PNG está bien',
     'icon.copying': 'Copiando ícono a assets/images/icon.png...',
     'icon.copied': 'Ícono copiado',
+    'icon.adaptive.generating': 'Generando variante adaptive para Android (llena el círculo del launcher)...',
+    'icon.adaptive.generated': 'Adaptive icon Android generado',
+    'icon.adaptive.failed': 'Fallo al generar adaptive icon Android',
+    'icon.adaptive.fallbackTitle': 'Fondo Android',
+    'icon.adaptive.fallbackColor': 'No pude muestrear el color de fondo del PNG (transparente). Usé blanco. Edita icon_android.png si quieres otro color.',
     'icon.generating': 'Regenerando íconos nativos (Android + iOS)...',
     'icon.generated': 'Íconos nativos regenerados',
     'icon.done': 'Listo. Desinstala el app del dispositivo y reinstala para ver el nuevo ícono.',
@@ -831,6 +859,10 @@ module.exports = {
     'add.cancelled': 'Cancelado.',
     'add.prompt.sentryDsn': 'Sentry DSN (deja en blanco para configurar después):',
     'add.prompt.mixpanelToken': 'Mixpanel Token (deja en blanco para configurar después):',
+    'add.prompt.rcTestKey': 'Clave Test Store (test_xxx) — opcional, sirve para iOS+Android y simulador:',
+    'add.prompt.rcIosProdKey': 'Clave iOS de producción (appl_xxx) — opcional, solo en dispositivo físico:',
+    'add.prompt.rcAndroidProdKey': 'Clave Android de producción (goog_xxx) — opcional, solo en dispositivo físico:',
+    // Legacy keys — kept for compatibility with old scripts.
     'add.prompt.rcAndroidKey': 'RevenueCat Android API key (deja en blanco para configurar después):',
     'add.prompt.rcIosKey': 'RevenueCat iOS API key (deja en blanco para configurar después):',
     'add.note.facebook': 'Agrega tu Facebook App ID y token en .vscode/launch.json (FB_APP_ID, FB_TOKEN).',

package/lib/utils/i18n/messages-pt.js

@@ -419,8 +419,15 @@ module.exports = {
 
     'doctor.revenuecat.title': 'RevenueCat',
     'doctor.revenuecat.keysOk': 'Chaves de API configuradas (iOS + Android)',
-    'doctor.revenuecat.keysEmpty': 'Chaves de API não configuradas — defina RC_IOS_API_KEY e RC_ANDROID_API_KEY no Makefile e .vscode/launch.json',
-    'doctor.revenuecat.keysTest': 'Usando chaves Test Store (test_) — substitua por appl_ e goog_ para produção',
+    'doctor.revenuecat.keysEmpty': 'Nenhuma chave configurada — defina pelo menos RC_TEST_KEY no .env (kasy run usa em simulador/emulador)',
+    'doctor.revenuecat.testKeyOk': 'RC_TEST_KEY configurada (test_) — usada em simulador/emulador',
+    'doctor.revenuecat.testKeyMissing': 'RC_TEST_KEY ausente — fluxo de assinatura não funciona em simulador/emulador',
+    'doctor.revenuecat.iosProdOk': 'RC_IOS_PROD_KEY configurada (appl_) — usada em iPhone físico',
+    'doctor.revenuecat.iosProdMissing': 'RC_IOS_PROD_KEY ausente — kasy run em iPhone físico vai usar a chave de teste',
+    'doctor.revenuecat.androidProdOk': 'RC_ANDROID_PROD_KEY configurada (goog_) — usada em Android físico',
+    'doctor.revenuecat.androidProdMissing': 'RC_ANDROID_PROD_KEY ausente — kasy run em Android físico vai usar a chave de teste',
+    'doctor.revenuecat.prefixMismatch': 'Chave com prefixo errado: {key} deveria começar com {expected}',
+    'doctor.revenuecat.keysTest': 'Apenas chaves Test Store (test_) configuradas — releases na loja exigem appl_/goog_, senão o app crasha',
     'doctor.revenuecat.webhookUrlSupabase': 'URL do webhook (cole no RevenueCat → Integrations → Webhooks)',
     'doctor.revenuecat.webhookUrlFirebase': 'URL do webhook: Firebase Console → Functions → subscriptionsOnRcPremiumUpdate',
 
@@ -488,6 +495,14 @@ module.exports = {
     'new.firebase.q.revenuecat.webhookKey.hint': 'Salve esse valor. No painel RevenueCat, cole como: Bearer <esse-valor>',
     'new.firebase.q.revenuecat.metaToken': 'Meta Access Token (Conversions API, opcional)',
     'new.firebase.q.revenuecat.metaDataset': 'Meta Dataset ID / Pixel ID (opcional)',
+    'new.firebase.q.revenuecat.test': 'Chave Test Store (test_xxx) — opcional, serve pra iOS+Android e funciona em simulador',
+    'new.firebase.q.revenuecat.test.invalid': 'Chave Test Store deve começar com test_ (ex: test_xxxxxxxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.iosProd': 'Chave iOS de produção (appl_xxx) — opcional, usada só em dispositivo físico',
+    'new.firebase.q.revenuecat.iosProd.invalid': 'Chave iOS de produção deve começar com appl_ (ex: appl_xxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.androidProd': 'Chave Android de produção (goog_xxx) — opcional, usada só em dispositivo físico',
+    'new.firebase.q.revenuecat.androidProd.invalid': 'Chave Android de produção deve começar com goog_ (ex: goog_xxxxxxxxxxxxxxx).',
+    'new.firebase.q.revenuecat.atLeastOne': 'Configure pelo menos uma chave (Test, iOS prod ou Android prod). Você pode adicionar as outras depois no .env.',
+    // Legacy keys — kept for projects/scripts that still reference them.
     'new.firebase.q.revenuecat.android': 'Chave de API RevenueCat para Android',
     'new.firebase.q.revenuecat.ios': 'Chave de API RevenueCat para iOS',
     'new.firebase.q.paywall': 'Qual estilo de paywall?',
@@ -678,6 +693,8 @@ module.exports = {
     'reset.warn.launcherCacheFailed': 'Não foi possível limpar o cache do launcher.',
     'reset.warn.launcherNotDetected': 'Launcher padrão não detectado — pulando limpeza de cache.',
     'run.launching': 'Iniciando app Flutter...',
+    'run.prompt.pickDevice': 'Vários dispositivos detectados. Em qual deles rodar?',
+    'run.warn.nothingSelected': 'Nenhum dispositivo selecionado.',
     'run.updateHint.prefix': 'Melhorias disponíveis para o projeto —',
     'run.updateHint.suffix': 'para ver o que há de novo',
     'run.spinner.building': 'Iniciando Flutter…',
@@ -692,6 +709,12 @@ module.exports = {
     'run.stage.buildSuccess': 'Build pronto — abrindo o app…',
     'run.error.notFlutterProject': 'Nenhum pubspec.yaml encontrado. Execute este comando dentro de um projeto Flutter.',
     'run.error.flutterNotFound': 'Flutter não encontrado. Verifique se o Flutter está instalado e no PATH.',
+    'run.rc.usingTest': 'RevenueCat: usando chave de teste (test_) — simulador/emulador',
+    'run.rc.usingProd': 'RevenueCat: usando chaves de produção — dispositivo físico',
+    'run.rc.fallbackToTest': 'RevenueCat: chave de produção ausente ({platform}) — caindo para test_; configure RC_{var} no .env para testar in-app purchase real',
+    'run.rc.forcedTest': 'RevenueCat: --rc=test forçado',
+    'run.rc.forcedProd': 'RevenueCat: --rc=prod forçado',
+    'run.rc.forcedProdMissing': 'RevenueCat: --rc=prod pedido mas RC_IOS_PROD_KEY/RC_ANDROID_PROD_KEY não configuradas no .env',
 
     // doctor project checks
     'doctor.project.title': 'Projeto',
@@ -744,6 +767,11 @@ module.exports = {
     'icon.validated': 'PNG está bom',
     'icon.copying': 'Copiando ícone para assets/images/icon.png...',
     'icon.copied': 'Ícone copiado',
+    'icon.adaptive.generating': 'Gerando versão adaptive para Android (preenche o círculo do launcher)...',
+    'icon.adaptive.generated': 'Adaptive icon Android gerado',
+    'icon.adaptive.failed': 'Falha ao gerar adaptive icon Android',
+    'icon.adaptive.fallbackTitle': 'Fundo Android',
+    'icon.adaptive.fallbackColor': 'Não consegui amostrar a cor de fundo do PNG (transparente). Usei branco. Se quiser outra cor, edite icon_android.png à mão.',
     'icon.generating': 'Regenerando ícones nativos (Android + iOS)...',
     'icon.generated': 'Ícones nativos regenerados',
     'icon.done': 'Pronto. Desinstale o app do dispositivo e reinstale para ver o novo ícone.',
@@ -831,6 +859,10 @@ module.exports = {
     'add.cancelled': 'Cancelado.',
     'add.prompt.sentryDsn': 'Sentry DSN (deixe em branco para configurar depois):',
     'add.prompt.mixpanelToken': 'Mixpanel Token (deixe em branco para configurar depois):',
+    'add.prompt.rcTestKey': 'Chave Test Store (test_xxx) — opcional, serve pra iOS+Android e simulador:',
+    'add.prompt.rcIosProdKey': 'Chave iOS de produção (appl_xxx) — opcional, só em dispositivo físico:',
+    'add.prompt.rcAndroidProdKey': 'Chave Android de produção (goog_xxx) — opcional, só em dispositivo físico:',
+    // Legacy keys — kept for compatibility with old scripts.
     'add.prompt.rcAndroidKey': 'RevenueCat Android API key (deixe em branco para configurar depois):',
     'add.prompt.rcIosKey': 'RevenueCat iOS API key (deixe em branco para configurar depois):',
     'add.note.facebook': 'Adicione seu Facebook App ID e token no .vscode/launch.json (FB_APP_ID, FB_TOKEN).',