kasy-cli 1.21.9 → 1.22.0

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

@@ -1,7 +1,7 @@
 "use strict";
 
 /**
- * Kasy CLI i18n messages — Português.
+ * Kasy CLI i18n messages — Portuguese.
  *
  * One entry per user-facing string. Keys are dotted paths describing
  * where the string is used (cli.help.*, run.*, ios.*, etc.).
@@ -43,7 +43,7 @@ module.exports = {
     'cli.command.setup.langName': 'idioma',
     'cli.command.setup.langOption': 'Idioma dos prompts (en, pt, es)',
     'cli.command.setup.backendOption': 'Adapter de backend (firebase, supabase, api)',
-    'cli.command.setup.featuresOption': 'Features opcionais separadas por virgula (web,widget,llm_chat,revenuecat,ci)',
+    'cli.command.setup.featuresOption': 'Features opcionais separadas por virgula (web,widget,ai_chat,revenuecat,ci)',
     'cli.command.help.paramName': 'comando',
     'cli.command.doctor.description': 'Verifica se o seu computador está pronto para rodar a Kasy',
     'cli.command.modules.description': 'Mostra o que já vem incluso e o que você pode adicionar',
@@ -109,15 +109,15 @@ module.exports = {
     'modules.backend.supabase.description': 'Adapter de backend Supabase',
     'modules.backend.api.description': 'Adapter de backend API REST/GraphQL',
     'modules.feature.sentry.description': 'Rastreamento de erros e crashes com Sentry',
-    'modules.feature.analytics.description': 'Rastreamento de eventos de analytics (Firebase Analytics)',
+    'modules.feature.analytics.description': 'Rastreamento de eventos de analytics (Mixpanel)',
     'modules.feature.facebook.description': 'Login do Facebook e rastreamento de eventos Meta Ads (vem sempre junto)',
     'modules.feature.revenuecat.description': 'Habilita pagamentos reais na tela de Subscriptions',
     'modules.feature.onboarding.description': 'Fluxo de boas-vindas mostrado no primeiro acesso',
     'modules.feature.web.description': 'Suporte Web/PWA',
     'modules.feature.widget.description': 'Widget de tela inicial iOS/Android',
-    'modules.feature.llm_chat.description': 'Tela de chat com IA usando OpenAI ou Gemini',
+    'modules.feature.ai_chat.description': 'Tela de chat com IA usando OpenAI ou Gemini',
     'modules.feature.feedback.description': 'Pedidos e votacao de features dentro do app',
-    'modules.feature.local_notifications.description': 'Lembretes locais agendados pelo usuario (sem servidor)',
+    'modules.feature.local_reminders.description': 'Lembretes locais agendados pelo usuario (sem servidor)',
     'modules.feature.ci.description': 'CI/CD: GitHub/GitLab (testes + build) + Codemagic (publicação nas lojas)',
     'checks.checking': 'Verificando {name}...',
     'checks.found': '{name} encontrado',
@@ -268,6 +268,9 @@ module.exports = {
     'new.supabase.created': 'Projeto criado com sucesso.',
     'new.supabase.createFailed': 'Não foi possível criar o projeto',
     'new.supabase.loginHint': 'Execute: supabase login. Depois informe a URL e chave do seu projeto existente.',
+    'new.supabase.createFailed.freeLimit': 'Seu plano grátis do Supabase atingiu o limite de projetos nesta organização.',
+    'new.supabase.freeLimit.title': 'Como liberar',
+    'new.supabase.freeLimit.options': '• Apague um projeto que você não usa mais\n• Escolha outra organização (se você tiver mais de uma)\n• Ou faça upgrade do plano no painel do Supabase\nDepois rode o kasy new de novo.',
     'new.supabase.setup': 'Vinculando projeto e publicando…',
     'new.supabase.setupManual': 'Execute manualmente: supabase link, supabase db push, supabase functions deploy',
     'new.supabase.passwordSaved': 'Senha do banco gerada automaticamente e salva em .kasy/supabase.json (gitignorado).',
@@ -301,7 +304,7 @@ module.exports = {
     'validate.fail': 'falhou',
     'validate.passed': 'aprovado',
 
-    // ── Fluxo Firebase ────────────────────────────────────────────────────
+    // ── Firebase flow ────────────────────────────────────────────────────
     'cli.command.firebase.description': '🔥 Criar app Flutter completo com Firebase (recomendado)',
     'new.banner': '✨ Novo app Flutter',
     'new.subtitle': 'Escolha o backend: Firebase, Supabase ou API REST.',
@@ -345,8 +348,10 @@ module.exports = {
     'configure.section.sentry': 'Sentry (Crash Reports)',
     'configure.section.mixpanel': 'Mixpanel (Analytics)',
     'configure.section.revenuecat': 'RevenueCat (Assinaturas)',
+    'configure.section.stripe': 'Stripe (Pagamentos na Web)',
+    'configure.stripe.apiNote': 'Backend API: configure STRIPE_SECRET_KEY + STRIPE_WEBHOOK_SECRET no seu próprio servidor (veja Stripe-Guia.md). A CLI não tem onde guardar.',
     'configure.section.facebook': 'Facebook (Login + Ads)',
-    'configure.section.llmChat': 'AI Chat (LLM)',
+    'configure.section.aiChat': 'AI Chat',
     'configure.savedFacebook': 'Credenciais do Facebook gravadas em Info.plist e strings.xml.',
     'configure.facebookPlistMissing': 'ios/Runner/Info.plist não encontrado — Facebook iOS não foi atualizado.',
     'configure.facebookStringsMissing': 'android/.../strings.xml não encontrado — Facebook Android não foi atualizado.',
@@ -501,7 +506,13 @@ module.exports = {
     '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',
+    'doctor.revenuecat.webhookUrlFirebase': 'URL do webhook: Firebase Console → Functions → subscriptions-revenuecatWebhook',
+    'doctor.stripe.title': 'Stripe (Pagamentos na Web)',
+    'doctor.stripe.serverSide': 'Só no servidor — nenhuma chave Stripe vai no app (Checkout hospedado).',
+    'doctor.stripe.secretsFirebase': 'Defina STRIPE_SECRET_KEY + STRIPE_WEBHOOK_SECRET com `kasy configure stripe`, depois `kasy deploy`.',
+    'doctor.stripe.secretsSupabase': 'Secrets via `supabase secrets set` (feito no `kasy new` se informadas).',
+    'doctor.stripe.secretsApi': 'Configure STRIPE_SECRET_KEY + STRIPE_WEBHOOK_SECRET no seu servidor (veja Stripe-Guia.md).',
+    'doctor.stripe.webhookUrl': 'URL do webhook Stripe (adicione em Stripe → Developers → Webhooks)',
 
     'update.iosRelease.success': 'Arquivos de release iOS atualizados',
     'add.iosRelease.success': 'Arquivos de release iOS adicionados',
@@ -548,14 +559,15 @@ module.exports = {
     'new.modules.header.feedback': '── Feedback (Firebase + Supabase) ──',
     'new.modules.header.ci': '── CI/CD ──',
     'new.modules.header.monetization': '── Monetizacao ──',
-    'new.firebase.module.revenuecat': '💰 RevenueCat (ativa Subscriptions)',
+    'new.firebase.module.revenuecat': '💰 RevenueCat (assinaturas mobile)',
+    'new.firebase.module.stripe': '🌐 Stripe (assinaturas na web)',
     'new.firebase.module.sentry': '🚨 Crash Reports (Sentry)',
     'new.firebase.module.analytics': '📊 Analytics (Mixpanel)',
     'new.firebase.module.facebook': '👤 Facebook (Login + Ads)',
     'new.firebase.module.web': '🌐 Web Support (PWA)',
     'new.firebase.module.widget': '📱 Home Widget (iOS/Android)',
-    'new.firebase.module.llm_chat': '🤖 AI Chat (OpenAI/Gemini)',
-    'new.firebase.module.local_notifications': '🔔 Local Reminders (sem servidor)',
+    'new.firebase.module.ai_chat': '🤖 AI Chat (OpenAI/Gemini)',
+    'new.firebase.module.local_reminders': '🔔 Local Reminders (sem servidor)',
     'new.firebase.module.feedback': '💬 Feature Requests (requer Firebase ou Supabase)',
     'new.firebase.module.ci': '⚙️ CI/CD (GitHub + Codemagic)',
     'new.firebase.module.onboarding': '👋 Onboarding (fluxo de boas-vindas)',
@@ -579,10 +591,12 @@ module.exports = {
     'new.firebase.q.revenuecat.ios': 'Chave de API RevenueCat para iOS',
     'new.firebase.q.paywall': 'Qual estilo de paywall?',
     'new.firebase.q.paywall.hint': 'Layout da tela de assinaturas — pode alterar depois no RevenueCat',
-    'new.firebase.q.revenuecat.web': 'Habilitar assinaturas na web (RevenueCat Web Billing)?',
-    'new.firebase.q.revenuecat.web.hint': 'Requer Web Billing no dashboard RevenueCat + Stripe. Deixe desmarcado se não precisar.',
-    'new.firebase.q.revenuecat.webKey': 'Chave API RevenueCat Web Billing (rcb_xxx ou rcb_sb_xxx, opcional — configure depois)',
-    'new.firebase.success.revenuecatWeb': '• RevenueCat Web: adicione RC_WEB_API_KEY (launch.json) para assinaturas na web',
+    'new.firebase.q.stripe.secretKey': 'Stripe Secret Key (sk_test_… / sk_live_…) — opcional, configure depois',
+    'new.firebase.q.stripe.webhookSecret': 'Stripe Webhook Signing Secret (whsec_…) — opcional, configure depois',
+    'new.firebase.q.stripe.webhookSecret.hint': 'Em Stripe → Developers → Webhooks → seu endpoint',
+    'new.firebase.q.stripe.webhookSecret.invalid': 'O signing secret do webhook deve começar com whsec_.',
+    'new.firebase.q.stripe.productId': 'Stripe Product ID (prod_…) — opcional, limita o paywall a um produto',
+    'new.firebase.q.stripe.productId.hint': 'Deixe em branco para listar todos os preços recorrentes ativos',
     'new.firebase.q.sentry.dsn': 'DSN do Sentry (deixe em branco para configurar depois)',
     'new.firebase.q.sentry.dsn.invalid': 'DSN inválido. Formato esperado: https://chave@host/project-id',
     'new.firebase.q.mixpanel.token': 'Token do Mixpanel (deixe em branco para configurar depois)',
@@ -594,7 +608,6 @@ module.exports = {
     'new.firebase.q.revenuecat.android.required': 'Chave Android do RevenueCat é obrigatória.',
     'new.firebase.q.revenuecat.ios.required': 'Chave iOS do RevenueCat é obrigatória.',
     'new.firebase.q.revenuecat.metaDataset.invalid': 'Pixel ID deve ser numerico (ex: 1234567890).',
-    'new.firebase.q.revenuecat.webKey.invalid': 'Chave Web Billing deve começar com rcb_ (ex: rcb_sb_xxx ou rcb_xxx).',
 
     'new.firebase.confirm.title': 'Resumo da configuração:',
     'new.firebase.confirm.app': 'App',
@@ -707,6 +720,8 @@ module.exports = {
     'new.outdated.upgraded': 'kasy atualizado! Rode kasy new novamente.',
     'new.success.title': 'Projeto criado com sucesso!',
     'new.success.featuresInstalled': 'Recursos ativados:',
+    'new.success.bundleId': 'Identificador do app (bundle ID)',
+    'new.success.bundleId.hint': 'Identificador único do seu app no Android, iOS e Firebase (push).',
     'new.success.nextSteps': 'Proximos passos:',
     'new.success.step.cd': 'Entre na pasta do projeto:',
     'new.success.step.deploy': 'Suba o servidor pro Firebase (banco + funções):',
@@ -914,7 +929,7 @@ module.exports = {
     'notifications.error.notKasyProject': 'kit_setup.json não encontrado. Execute dentro de um projeto Kasy.',
     'notifications.error.noI18n': 'lib/i18n/*.i18n.json não encontrado neste projeto.',
     'notifications.error.noFeatures': 'lib/core/config/features.dart não encontrado.',
-    'notifications.error.notEnabled': 'Notificações locais desativadas. Execute: kasy add local_notifications',
+    'notifications.error.notEnabled': 'Notificações locais desativadas. Execute: kasy add local_reminders',
     'notifications.error.cancelled': 'Cancelado.',
     'notifications.prompt.intro': 'Textos de notificação local',
     'notifications.prompt.hint': 'Demo Home = teste instantâneo em Features. Lembrete = alerta agendado em Configurações.',
@@ -957,26 +972,26 @@ module.exports = {
     // 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).',
-    'new.q.llm_chat.configureNow': 'Configurar o agente de Chat LLM agora?',
-    'new.q.llm_chat.configureNow.hint': 'Pode pular e executar "kasy add llm_chat" depois',
-    'add.llm_chat.reconfigure': 'Feature já ativa — reconfigurando apenas as credenciais.',
-    'add.prompt.llmProvider': 'Provedor de LLM:',
-    'add.prompt.llmSystemPrompt': 'Instrução do agente — system prompt (deixe em branco para nenhuma):\n  Exemplo: "Você e um assistente de suporte do app Fitsync. Responda apenas sobre treinos."\n >',
-    'add.prompt.llmApiKey': 'Chave de API (OpenAI ou Gemini) — fica no servidor, nunca no app (deixe em branco para configurar depois):',
-    'add.prompt.llmEndpoint': 'URL do seu endpoint LLM (deixe em branco para configurar depois):',
-    'add.llm_chat.settingSecret': 'Salvando chave de API como secret no servidor...',
-    'add.llm_chat.secretSet': 'Chave de API salva como secret',
-    'add.llm_chat.secretFailed': 'Não foi possível salvar o secret automaticamente — configure manualmente (veja instruções abaixo)',
-    'add.llm_chat.skipSecret': 'Chave de API ignorada — configure antes do deploy via CLI do servidor',
-    'add.llm_chat.deploying': 'Fazendo deploy da função LLM no servidor...',
-    'add.llm_chat.deployed': 'Função LLM deployada com sucesso',
-    'add.llm_chat.deployFailed': 'Deploy automático falhou — faca o deploy manualmente (veja instruções abaixo)',
-    'add.llm_chat.nextSteps.firebase': '\n  Proximos passos:\n  1. O LLM_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  2. Rode o app: kasy run\n',
-    'add.llm_chat.nextSteps.firebase.deployFailed': '\n  Proximos passos:\n  1. Deploy manual: firebase deploy --only functions:llmChat\n  2. O LLM_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  3. Rode o app: kasy run\n',
-    'add.llm_chat.nextSteps.supabase': '\n  Proximos passos:\n  1. O LLM_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  2. Rode o app: kasy run\n',
-    'add.llm_chat.nextSteps.supabase.deployFailed': '\n  Proximos passos:\n  1. Deploy manual: supabase functions deploy llm-chat --no-verify-jwt\n  2. O LLM_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  3. Rode o app: kasy run\n',
-    'add.llm_chat.nextSteps.api': '\n  Proximos passos:\n  1. Crie um endpoint no seu servidor que aceite {message, history} e chame sua LLM.\n  2. Atualize LLM_CHAT_ENDPOINT no .vscode/launch.json com a URL do seu endpoint.\n  3. Rode o app: kasy run\n',
+    'add.note.facebook': 'Adicione seu Facebook App ID e token no .vscode/launch.json (FB_APP_ID, FB_CLIENT_TOKEN).',
+    'new.q.ai_chat.configureNow': 'Configurar o agente de Chat IA agora?',
+    'new.q.ai_chat.configureNow.hint': 'Pode pular e executar "kasy add ai_chat" depois',
+    'add.ai_chat.reconfigure': 'Feature já ativa — reconfigurando apenas as credenciais.',
+    'add.prompt.aiProvider': 'Provedor de IA:',
+    'add.prompt.aiSystemPrompt': 'Instrução do agente — system prompt (deixe em branco para nenhuma):\n  Exemplo: "Você e um assistente de suporte do app Fitsync. Responda apenas sobre treinos."\n >',
+    'add.prompt.aiApiKey': 'Chave de API (OpenAI ou Gemini) — fica no servidor, nunca no app (deixe em branco para configurar depois):',
+    'add.prompt.aiEndpoint': 'URL do seu endpoint IA (deixe em branco para configurar depois):',
+    'add.ai_chat.settingSecret': 'Salvando chave de API como secret no servidor...',
+    'add.ai_chat.secretSet': 'Chave de API salva como secret',
+    'add.ai_chat.secretFailed': 'Não foi possível salvar o secret automaticamente — configure manualmente (veja instruções abaixo)',
+    'add.ai_chat.skipSecret': 'Chave de API ignorada — configure antes do deploy via CLI do servidor',
+    'add.ai_chat.deploying': 'Fazendo deploy da função IA no servidor...',
+    'add.ai_chat.deployed': 'Função IA deployada com sucesso',
+    'add.ai_chat.deployFailed': 'Deploy automático falhou — faca o deploy manualmente (veja instruções abaixo)',
+    'add.ai_chat.nextSteps.firebase': '\n  Proximos passos:\n  1. O AI_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  2. Rode o app: kasy run\n',
+    'add.ai_chat.nextSteps.firebase.deployFailed': '\n  Proximos passos:\n  1. Deploy manual: firebase deploy --only functions:aiChat\n  2. O AI_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  3. Rode o app: kasy run\n',
+    'add.ai_chat.nextSteps.supabase': '\n  Proximos passos:\n  1. O AI_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  2. Rode o app: kasy run\n',
+    'add.ai_chat.nextSteps.supabase.deployFailed': '\n  Proximos passos:\n  1. Deploy manual: supabase functions deploy ai-chat --no-verify-jwt\n  2. O AI_CHAT_ENDPOINT no .vscode/launch.json já foi preenchido.\n  3. Rode o app: kasy run\n',
+    'add.ai_chat.nextSteps.api': '\n  Proximos passos:\n  1. Crie um endpoint no seu servidor que aceite {message, history} e chame sua IA.\n  2. Atualize AI_CHAT_ENDPOINT no .vscode/launch.json com a URL do seu endpoint.\n  3. Rode o app: kasy run\n',
     'cli.command.remove.description': 'Remove algo que você não usa mais (ex: kasy remove sentry)',
     'remove.error.noModule': 'Informe o nome da feature. Uso: kasy remove <feature>',
     'remove.error.notKasyProject': 'kit_setup.json não encontrado. Execute este comando dentro de um projeto Kasy.',

package/lib/utils/updates.js

@@ -8,9 +8,9 @@ const pkg = require('../../package.json');
 const ui = require('./ui');
 const { CONFIG_PATH } = require('./license');
 
-const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 horas
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
 
-// ── Helpers de config ────────────────────────────────────────────────────────
+// ── Config helpers ────────────────────────────────────────────────────────
 
 function readConfig() {
   if (!existsSync(CONFIG_PATH)) return {};
@@ -22,7 +22,7 @@ function writeConfig(config) {
   writeJsonSync(CONFIG_PATH, config, { spaces: 2 });
 }
 
-// ── Comparação semver mínima (sem deps externas) ─────────────────────────────
+// ── Minimal semver comparison (no external deps) ─────────────────────────────
 
 function isNewer(remote, local) {
   const parse = (v) => String(v).replace(/^v/, '').split('.').map(Number);
@@ -33,7 +33,7 @@ function isNewer(remote, local) {
   return rPat > lPat;
 }
 
-// ── Fetch assíncrono (dispara em background) ─────────────────────────────────
+// ── Async fetch (fires in the background) ─────────────────────────────────
 
 function fetchLatestVersion() {
   return new Promise((resolve) => {
@@ -54,19 +54,19 @@ function fetchLatestVersion() {
   });
 }
 
-// ── Função principal ─────────────────────────────────────────────────────────
+// ── Main function ─────────────────────────────────────────────────────────
 
 /**
- * Mostra aviso de atualização (baseado no cache da última verificação — zero latência).
- * Dispara refresh do cache em background se já passaram 24h.
- * Nunca lança erro — falha silenciosa em qualquer cenário.
+ * Shows an update notice (based on the last-check cache — zero latency).
+ * Triggers a background cache refresh if 24h have passed.
+ * Never throws — fails silently in any scenario.
  */
 async function checkForUpdates() {
   try {
     const config = readConfig();
     const cache = config.updateCheck || {};
 
-    // Exibe aviso baseado no cache — não espera rede
+    // Show a notice based on the cache — does not wait for the network
     if (cache.latestVersion && isNewer(cache.latestVersion, pkg.version)) {
       console.log(
         '\n' +
@@ -79,7 +79,7 @@ async function checkForUpdates() {
       );
     }
 
-    // Atualiza cache em background a cada 24h — não bloqueia o CLI
+    // Refresh the cache in the background every 24h — does not block the CLI
     const now = Date.now();
     if (!cache.checkedAt || now - cache.checkedAt > CHECK_INTERVAL_MS) {
       fetchLatestVersion()
@@ -91,14 +91,14 @@ async function checkForUpdates() {
         .catch(() => {});
     }
   } catch {
-    // Nunca travar o CLI por causa de verificação de update
+    // Never block the CLI because of an update check
   }
 }
 
 /**
- * Chamado antes de kasy new. Se houver versão mais nova no cache,
- * mostra aviso e pergunta se quer continuar ou sair para atualizar.
- * Nunca bloqueia — se o usuário ignorar, o fluxo segue normalmente.
+ * Called before kasy new. If there is a newer version in the cache,
+ * shows a notice and asks whether to continue or exit to update.
+ * Never blocks — if the user ignores it, the flow continues normally.
  */
 async function warnIfOutdatedBeforeNew(t) {
   try {
@@ -128,7 +128,7 @@ async function warnIfOutdatedBeforeNew(t) {
       process.exit(result.status ?? 0);
     }
   } catch {
-    // Nunca travar o kasy new por causa do aviso de versão
+    // Never block kasy new because of the version notice
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.21.9",
+  "version": "1.22.0",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"

package/templates/firebase/.env.example

@@ -6,8 +6,8 @@ ENV=dev
 # Firebase Cloud Functions (região + project id do seu projeto)
 BACKEND_URL=https://europe-west1-YOUR_PROJECT_ID.cloudfunctions.net
 
-# LLM Chat — proxy Cloud Function (LLM_API_KEY fica no Firebase Secret)
-LLM_CHAT_ENDPOINT=https://europe-west1-YOUR_PROJECT_ID.cloudfunctions.net/llmChat
+# AI Chat — proxy Cloud Function (AI_API_KEY fica no Firebase Secret)
+AI_CHAT_ENDPOINT=https://europe-west1-YOUR_PROJECT_ID.cloudfunctions.net/aiChat
 
 # RevenueCat
 RC_ANDROID_API_KEY=YOUR_REVENUECAT_ANDROID_KEY

package/templates/firebase/android/app/src/main/res/values-night-v31/styles.xml

@@ -6,7 +6,7 @@
         <item name="android:windowFullscreen">true</item>
         <item name="android:windowDrawsSystemBarBackgrounds">true</item>
         <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
-        <item name="android:windowSplashScreenBackground">#060608</item>
+        <item name="android:windowSplashScreenBackground">#0C0A14</item>
         <item name="android:windowSplashScreenAnimatedIcon">@drawable/android12splash</item>
     </style>
     <!-- Theme applied to the Android Window as soon as the process has started.

package/templates/firebase/android/app/src/main/res/values-v31/styles.xml

@@ -6,7 +6,7 @@
         <item name="android:windowFullscreen">true</item>
         <item name="android:windowDrawsSystemBarBackgrounds">true</item>
         <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
-        <item name="android:windowSplashScreenBackground">#F7F7F7</item>
+        <item name="android:windowSplashScreenBackground">#FAF9FC</item>
         <item name="android:windowSplashScreenAnimatedIcon">@drawable/android12splash</item>
     </style>
     <!-- Theme applied to the Android Window as soon as the process has started.

package/templates/firebase/docs/revenuecat-setup.es.md

@@ -88,7 +88,7 @@ Encuentra la URL de la función:
 | Backend | Dónde encontrar la URL |
 |---------|------------------------|
 | **Supabase** | `https://TU_PROJECT_REF.supabase.co/functions/v1/revenuecat-webhook` |
-| **Firebase** | [Firebase Console → Functions](https://console.firebase.google.com/project/_/functions) → `subscriptionsOnRcPremiumUpdate` → copia la URL |
+| **Firebase** | [Firebase Console → Functions](https://console.firebase.google.com/project/_/functions) → `subscriptions-revenuecatWebhook` → copia la URL |
 
 Regístrala en RevenueCat:
 

package/templates/firebase/docs/revenuecat-setup.pt.md

@@ -88,7 +88,7 @@ Encontre a URL da função:
 | Backend | Onde encontrar a URL |
 |---------|---------------------|
 | **Supabase** | `https://SEU_PROJECT_REF.supabase.co/functions/v1/revenuecat-webhook` |
-| **Firebase** | [Firebase Console → Functions](https://console.firebase.google.com/project/_/functions) → `subscriptionsOnRcPremiumUpdate` → copie a URL |
+| **Firebase** | [Firebase Console → Functions](https://console.firebase.google.com/project/_/functions) → `subscriptions-revenuecatWebhook` → copie a URL |
 
 Registre no RevenueCat:
 

package/templates/firebase/firestore.rules

@@ -2,8 +2,22 @@ rules_version = '2';
 service cloud.firestore {
   match /databases/{database}/documents {
 
+    // True when the signed-in user has role == "admin" on their OWN user doc.
+    // `role` is writable only server-side (see the users rules below), so a
+    // client cannot forge it — this check is trustworthy and server-evaluated.
+    function isAdmin() {
+      return request.auth != null
+        && exists(/databases/$(database)/documents/users/$(request.auth.uid))
+        && get(/databases/$(database)/documents/users/$(request.auth.uid)).data.get('role', '') == 'admin';
+    }
+
     match /users/{id} {
-      allow read, update, delete: if request.auth.uid != null && request.auth.uid == id;
+      allow read, delete: if request.auth.uid != null && request.auth.uid == id;
+      // Owners update their own profile, but NEVER their own `role`
+      // (no self-promotion to admin). `role` is set only server-side
+      // (Cloud Function / console), never from the client.
+      allow update: if request.auth.uid != null && request.auth.uid == id
+                    && !request.resource.data.diff(resource.data).affectedKeys().hasAny(['role']);
       allow create: if false;
     }
     match /users/{id}/{document=**} {
@@ -23,10 +37,15 @@ service cloud.firestore {
       allow create: if request.auth.uid != null
                     && request.resource.data.active == false
                     && request.resource.data.votes == 0;
+      // Either a normal ±1 vote by any signed-in user, OR full moderation
+      // (toggle visibility, edit translations) by an admin.
       allow update: if request.auth.uid != null
-                    && request.resource.data.diff(resource.data).affectedKeys().hasOnly(['votes', 'last_update_date'])
-                    && (request.resource.data.votes == resource.data.votes + 1
-                        || request.resource.data.votes == resource.data.votes - 1);
+                    && (
+                      (request.resource.data.diff(resource.data).affectedKeys().hasOnly(['votes', 'last_update_date'])
+                        && (request.resource.data.votes == resource.data.votes + 1
+                            || request.resource.data.votes == resource.data.votes - 1))
+                      || isAdmin()
+                    );
       allow delete: if false;
     }
     match /feature_requests/{featureId}/votes/{id} {
@@ -48,4 +67,4 @@ service cloud.firestore {
       allow read, write: if false;
     }
   }
-}
+}

package/templates/firebase/functions/package-lock.json

@@ -7,7 +7,8 @@
       "name": "functions",
       "dependencies": {
         "firebase-admin": "^13.6.0",
-        "firebase-functions": "^7.1.1"
+        "firebase-functions": "^7.1.1",
+        "stripe": "^18.5.0"
       },
       "devDependencies": {
         "@types/jest": "^29.5.14",
@@ -6239,6 +6240,26 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/stripe": {
+      "version": "18.5.0",
+      "resolved": "https://registry.npmjs.org/stripe/-/stripe-18.5.0.tgz",
+      "integrity": "sha512-Hp+wFiEQtCB0LlNgcFh5uVyKznpDjzyUZ+CNVEf+I3fhlYvh7rZruIg+jOwzJRCpy0ZTPMjlzm7J2/M2N6d+DA==",
+      "license": "MIT",
+      "dependencies": {
+        "qs": "^6.11.0"
+      },
+      "engines": {
+        "node": ">=12.*"
+      },
+      "peerDependencies": {
+        "@types/node": ">=12.x.x"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/strnum": {
       "version": "2.2.0",
       "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.0.tgz",

package/templates/firebase/functions/package.json

@@ -19,7 +19,8 @@
   "main": "lib/index.js",
   "dependencies": {
     "firebase-admin": "^13.6.0",
-    "firebase-functions": "^7.1.1"
+    "firebase-functions": "^7.1.1",
+    "stripe": "^18.5.0"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",

package/templates/firebase/functions/src/admin/functions.ts

@@ -0,0 +1,113 @@
+import {onCall, HttpsError} from "firebase-functions/v2/https";
+import * as admin from "firebase-admin";
+import {Logger} from "../core/logger/logger";
+
+// In-memory cap: the admin console loads up to this many of the most recent
+// users in ONE call, then searches / sorts / paginates entirely on the client
+// for an instant experience (no extra reads when typing or paging). Apps that
+// outgrow this should add a dedicated search index (Algolia/Typesense) — see
+// README. Reads are admin-only and bounded, so the cost stays predictable.
+const MAX_SCAN = 1000;
+
+// getAll() batch size for the subscription lookups (Firestore caps a single
+// getAll at a few hundred refs comfortably; chunking keeps it safe).
+const SUB_CHUNK = 200;
+
+// A user counts as a subscriber when their subscription is currently usable.
+const ACTIVE_SUBSCRIPTION_STATUSES = ["ACTIVE", "LIFETIME"];
+
+interface AdminUser {
+  id: string;
+  email: string | null;
+  name: string | null;
+  createdAt: number | null; // epoch millis
+  subscriber: boolean;
+}
+
+/**
+ * Lists app users for the admin console.
+ *
+ * Security: the caller must be authenticated AND have `role == "admin"` on their
+ * own `users/{uid}` document. Clients cannot read the whole users collection
+ * (Firestore rules), so this runs with Admin privileges and gates on the role.
+ *
+ * Returns the most-recent users (bounded to MAX_SCAN) with their subscriber
+ * status already resolved. The client (admin_users_tab.dart) does the search,
+ * sort and pagination locally so those interactions are instant. Shape:
+ *   { users: AdminUser[], totalUsers: number, truncated: boolean }
+ *  - totalUsers: the true size of the collection (for an honest count).
+ *  - truncated: true when the collection is larger than what we returned, so
+ *    the UI can warn that search only covers the loaded set.
+ */
+export const listUsers = onCall(async (request) => {
+  if (!request.auth) {
+    throw new HttpsError("unauthenticated", "Authentication required");
+  }
+  const callerUid = request.auth.uid;
+  const db = admin.firestore();
+  const logger = new Logger("listUsers");
+
+  // Admin gate: the caller's own user doc must carry role == "admin".
+  const callerDoc = await db.collection("users").doc(callerUid).get();
+  if (!callerDoc.exists || callerDoc.get("role") !== "admin") {
+    throw new HttpsError("permission-denied", "Admin role required");
+  }
+
+  try {
+    const usersRef = db.collection("users");
+
+    // Bounded fetch — the client does the search/sort/paginate.
+    //
+    // IMPORTANT: do NOT order this query by "creation_date". A Firestore
+    // orderBy silently DROPS every document that lacks the ordered field, and
+    // some user docs have no creation_date (e.g. accounts whose doc was created
+    // client-side during anonymous→social linking; the auth trigger then only
+    // patches the email and never backfills creation_date). Ordering by it
+    // would hide exactly those real, active users. We fetch unordered and sort
+    // in memory below (newest first, undated last) so every user is returned.
+    const snapshot = await usersRef.limit(MAX_SCAN).get();
+    const docs = snapshot.docs;
+
+    // Subscriber status for the whole batch, in chunked getAll() reads.
+    const activeSubscribers = new Set<string>();
+    for (let i = 0; i < docs.length; i += SUB_CHUNK) {
+      const chunk = docs.slice(i, i + SUB_CHUNK);
+      const refs = chunk.map((d) => db.collection("subscriptions").doc(d.id));
+      const snaps = await db.getAll(...refs);
+      for (const s of snaps) {
+        if (
+          s.exists &&
+          ACTIVE_SUBSCRIPTION_STATUSES.includes(s.get("status"))
+        ) {
+          activeSubscribers.add(s.id);
+        }
+      }
+    }
+
+    const users: AdminUser[] = docs.map((d) => {
+      const createdAt = d.get("creation_date");
+      return {
+        id: d.id,
+        email: (d.get("email") as string) || null,
+        name: (d.get("name") as string) || null,
+        createdAt: createdAt ? createdAt.toMillis() : null,
+        subscriber: activeSubscribers.has(d.id),
+      };
+    });
+
+    // Newest first; users without a creation_date sort to the end.
+    users.sort((a, b) => (b.createdAt ?? 0) - (a.createdAt ?? 0));
+
+    const countSnap = await usersRef.count().get();
+    const totalUsers = countSnap.data().count;
+
+    return {
+      users,
+      totalUsers,
+      truncated: totalUsers > users.length,
+    };
+  } catch (e) {
+    logger.error(`listUsers error: ${e}`);
+    throw new HttpsError("internal", "Failed to list users");
+  }
+});