kasy-cli 1.5.3 → 1.7.0

package/lib/utils/apple-release.js

@@ -4,6 +4,7 @@ const path = require('node:path');
 const fs = require('fs-extra');
 const os = require('node:os');
 const kleur = require('kleur');
+const ui = require('./ui');
 const { exec } = require('node:child_process');
 const { promisify } = require('node:util');
 
@@ -202,17 +203,21 @@ function isXcodeCacheBuildError(output) {
 
 function printBuildFailureHints(t, projectDir) {
   const name = path.basename(projectDir);
-  console.log(kleur.yellow(`\n${t('ios.hints.title')}\n`));
-  console.log(kleur.dim(`  1. ${t('ios.hints.closeXcode')}`));
-  console.log(kleur.cyan(`  2. kasy ios clean${projectDir !== process.cwd() ? ` ${projectDir}` : ''}`));
-  console.log(kleur.dim(`  3. ${t('ios.hints.retry')}: kasy ios release\n`));
+  const cleanArg = projectDir !== process.cwd() ? ` ${projectDir}` : '';
+  const lines = [
+    `1. ${t('ios.hints.closeXcode')}`,
+    `2. ${kleur.cyan(`kasy ios clean${cleanArg}`)}`,
+    `3. ${t('ios.hints.retry')}: ${kleur.cyan('kasy ios release')}`,
+  ];
   if (name) {
-    console.log(kleur.dim(`  ${t('ios.hints.manual')}:`));
-    console.log(kleur.dim(`     cd ${projectDir}`));
-    console.log(kleur.dim('     flutter clean && flutter pub get'));
-    console.log(kleur.dim('     rm -rf ~/Library/Developer/Xcode/DerivedData/Runner-*'));
-    console.log(kleur.dim('     cd ios && pod install\n'));
+    lines.push('');
+    lines.push(kleur.dim(`${t('ios.hints.manual')}:`));
+    lines.push(kleur.dim(`  cd ${projectDir}`));
+    lines.push(kleur.dim('  flutter clean && flutter pub get'));
+    lines.push(kleur.dim('  rm -rf ~/Library/Developer/Xcode/DerivedData/Runner-*'));
+    lines.push(kleur.dim('  cd ios && pod install'));
   }
+  ui.note(lines.join('\n'), t('ios.hints.title'));
 }
 
 async function runIosClean(projectDir, t) {
@@ -224,10 +229,17 @@ async function runIosClean(projectDir, t) {
     { label: t('ios.clean.step.pods'), cmd: 'cd ios && pod install' },
   ];
 
+  const stepper = ui.makeStepper();
   for (const step of steps) {
-    console.log(kleur.dim(`  ${step.label}…`));
-    await execAsync(step.cmd, { cwd: projectDir, maxBuffer: 50 * 1024 * 1024, shell: '/bin/bash' });
+    stepper.next(step.label);
+    try {
+      await execAsync(step.cmd, { cwd: projectDir, maxBuffer: 50 * 1024 * 1024, shell: '/bin/bash' });
+    } catch (err) {
+      stepper.fail(`${step.label}: ${err.message}`);
+      throw err;
+    }
   }
+  stepper.succeed();
 }
 
 async function runReleaseScript(projectDir, args, t) {

package/lib/utils/brand.js

@@ -0,0 +1,72 @@
+/**
+ * Kasy brand kit for the terminal.
+ *
+ * Centralizes logo, banner, headers, and boxed messages so every
+ * command projects a consistent identity. Two header sizes:
+ *  - printBanner(): full ASCII logo + gradient + tagline (kasy new, kasy add)
+ *  - printCompactHeader(): one-line ✦ KASY + tagline (kasy doctor, upgrade, run)
+ *
+ * Box helpers wrap `boxen` so commands stop drawing ─── lines by hand.
+ */
+
+const kleur = require('kleur');
+const gradient = require('gradient-string');
+const boxenPackage = require('boxen');
+const boxen = boxenPackage.default || boxenPackage;
+
+// Kept around for accents and boxes; the wordmark itself is now plain white.
+const BRAND_GRADIENT = ['#a78bfa', '#60a5fa'];
+const brandGradient = gradient(BRAND_GRADIENT);
+
+const DOMAIN_SUFFIX = kleur.gray('.dev');
+
+function printBanner(_tr) {
+  const bar = kleur.gray('─────────────────────────────────────────────────');
+  const logo = [
+    kleur.white('  ╦╔═ ╔═╗ ╔═╗ ╦ ╦'),
+    kleur.white('  ╠╩╗ ╠═╣ ╚═╗ ╚╦╝'),
+    `${kleur.white('  ╩ ╩ ╩ ╩ ╚═╝  ╩ ')} ${DOMAIN_SUFFIX}`,
+  ].join('\n');
+
+  console.log(`\n${bar}\n`);
+  console.log(logo);
+  console.log(`\n${bar}\n`);
+}
+
+function printCompactHeader(_tr) {
+  console.log('');
+  console.log(`  ${kleur.white('✦ KASY')}${DOMAIN_SUFFIX}`);
+  console.log('');
+}
+
+function successBox(title, body, { padding = 1, marginTop = 1, marginBottom = 1 } = {}) {
+  return boxen(
+    `${brandGradient(`✦ ${title}`)}\n\n${body}`,
+    {
+      padding,
+      margin: { top: marginTop, bottom: marginBottom, left: 1, right: 1 },
+      borderStyle: 'round',
+      borderColor: 'cyan',
+    }
+  );
+}
+
+function infoBox(title, body, { padding = 1, marginTop = 1, marginBottom = 1 } = {}) {
+  return boxen(
+    `${kleur.bold(title)}\n\n${body}`,
+    {
+      padding,
+      margin: { top: marginTop, bottom: marginBottom, left: 1, right: 1 },
+      borderStyle: 'round',
+      borderColor: 'gray',
+    }
+  );
+}
+
+module.exports = {
+  brandGradient,
+  printBanner,
+  printCompactHeader,
+  successBox,
+  infoBox,
+};

package/lib/utils/checks.js

@@ -3,6 +3,7 @@ const { promisify } = require('node:util');
 const readline = require('node:readline');
 const kleur = require('kleur');
 const oraPackage = require('ora');
+const ui = require('./ui');
 const { createTranslator, detectDefaultLanguage } = require('./i18n');
 
 const execAsync = promisify(exec);
@@ -290,7 +291,8 @@ async function runChecks(checks, title, options = {}) {
 
   // Compact mode: single spinner, show failures only
   const { spinnerLabel = title, doneLabel = title } = options;
-  process.stdout.write(`  ${kleur.dim(spinnerLabel + '...')}\n`);
+  const spinner = ui.spinner();
+  spinner.start(spinnerLabel);
 
   const results = [];
   for (const check of checks) {
@@ -298,26 +300,35 @@ async function runChecks(checks, title, options = {}) {
   }
 
   const failures = results.filter((r) => !r.ok);
+  const requiredFailures = failures.filter((r) => r.required);
 
   if (failures.length === 0) {
-    console.log(kleur.green(`  ✔ ${doneLabel}`));
+    spinner.stop(doneLabel);
     return results;
   }
 
+  // Close the spinner reflecting what actually happened: red ▲ if a required
+  // check failed, default green ✦ if only optional checks failed (warnings).
+  if (requiredFailures.length > 0) {
+    spinner.error(doneLabel);
+  } else {
+    spinner.stop(doneLabel);
+  }
+
   for (const result of failures) {
-    const hint = result.failHint ? `\n    ${kleur.dim(`→ ${result.failHint}`)}` : '';
+    const hint = result.failHint ? `\n${kleur.dim(`→ ${result.failHint}`)}` : '';
     if (result.required) {
       const detail = result.autoInstallFailed ? ` — ${t('checks.install.failed')}` : '';
-      const diagSuffix = result.diagnosis ? `\n    ${kleur.dim(`→ ${t(`checks.diagnostic.${result.diagnosis}`, { name: result.name })}`)}` : '';
-      console.log(kleur.red(`  ✖ ${t('checks.missing', { name: result.name })}${detail}${diagSuffix}${hint}`));
+      const diagSuffix = result.diagnosis ? `\n${kleur.dim(`→ ${t(`checks.diagnostic.${result.diagnosis}`, { name: result.name })}`)}` : '';
+      ui.log.error(`${t('checks.missing', { name: result.name })}${detail}${diagSuffix}${hint}`);
     } else if (result.diagnosis) {
-      console.log(kleur.yellow(`  ⚠ ${t(`checks.diagnostic.${result.diagnosis}`, { name: result.name })}`));
+      ui.log.warn(t(`checks.diagnostic.${result.diagnosis}`, { name: result.name }));
     } else if (result.warnMessage) {
-      console.log(kleur.yellow(`  ⚠ ${result.warnMessage}${hint}`));
+      ui.log.warn(`${result.warnMessage}${hint}`);
     } else if (result.warnMessageKey) {
-      console.log(kleur.yellow(`  ⚠ ${t(result.warnMessageKey)}${hint}`));
+      ui.log.warn(`${t(result.warnMessageKey)}${hint}`);
     } else {
-      console.log(kleur.yellow(`  ⚠ ${t('checks.notFound', { name: result.name })}${hint}`));
+      ui.log.warn(`${t('checks.notFound', { name: result.name })}${hint}`);
     }
   }
 

package/lib/utils/i18n.js

@@ -34,7 +34,7 @@ const MESSAGES = {
     'cli.command.setup.langName': 'lang',
     'cli.command.setup.langOption': 'Prompt language (en, pt, es)',
     'cli.command.setup.backendOption': 'Backend adapter (firebase, supabase, api)',
-    'cli.command.setup.featuresOption': 'Comma separated optional features (web,widget,camera,llm_chat,revenuecat,ci)',
+    'cli.command.setup.featuresOption': 'Comma separated optional features (web,widget,llm_chat,revenuecat,ci)',
     'cli.command.help.paramName': 'command',
     'cli.command.doctor.description': '🩺 Check environment and dependencies',
     'cli.command.modules.description': '🧩 List available backend and features',
@@ -73,22 +73,31 @@ const MESSAGES = {
     'doctor.requiredMissing': 'Missing required dependencies. Fix the errors above and rerun doctor.',
     'doctor.requiredPassed': '✓ Required environment checks passed.',
     'modules.backends': 'Available backends:',
-    'modules.features': 'Available optional features:',
+    'modules.featuresBase': 'Always included:',
+    'modules.features': 'Optional features:',
+    'modules.tag.firebaseOnly': 'Firebase only',
+    'modules.tag.requiresDb': 'requires Firebase or Supabase',
+    'modules.tag.enhances': 'enables {target}',
+    'modules.hint.subscriptionNoRc': 'Tip: Subscriptions screen is included but inactive. Run `kasy add revenuecat` to enable real payments.',
+    'modules.feature.base.authentication.description': 'Sign up, login and account management',
+    'modules.feature.base.home.description': 'Main app screen after login',
+    'modules.feature.base.settings.description': 'Theme, language, account and preferences',
+    'modules.feature.base.notifications.description': 'Push notifications via Firebase Cloud Messaging (works with any backend)',
+    'modules.feature.base.subscription.description': 'Premium subscription screen and data model (add RevenueCat to enable real payments)',
     'modules.backend.firebase.description': 'Firebase backend adapter',
     'modules.backend.supabase.description': 'Supabase backend adapter',
     'modules.backend.api.description': 'REST/GraphQL API backend adapter',
     'modules.feature.sentry.description': 'Sentry error tracking and crash reporting',
     'modules.feature.analytics.description': 'Analytics event tracking (Firebase Analytics)',
-    'modules.feature.facebook.description': 'Facebook Login integration',
-    'modules.feature.revenuecat.description': 'RevenueCat subscriptions integration',
-    'modules.feature.onboarding.description': 'Onboarding flow feature',
-    'modules.feature.web.description': 'Web compatibility layer',
-    'modules.feature.widget.description': 'iOS/Android home widget integration',
-    'modules.feature.camera.description': 'Camera feature template',
-    'modules.feature.llm_chat.description': 'LLM chat feature template',
-    'modules.feature.feedback.description': 'User feedback and feature requests feature',
-    'modules.feature.local_notifications.description': 'Local reminders — user-scheduled notifications (iOS & Android only)',
-    'modules.feature.ci.description': 'CI: GitHub/GitLab (tests + build) + Codemagic (publish to stores)',
+    'modules.feature.facebook.description': 'Facebook Login and Meta Ads event tracking (always bundled together)',
+    'modules.feature.revenuecat.description': 'Enables real in-app payments on the Subscriptions screen',
+    'modules.feature.onboarding.description': 'Welcome flow shown on first launch',
+    'modules.feature.web.description': 'Web/PWA support',
+    'modules.feature.widget.description': 'iOS/Android home screen widget integration',
+    'modules.feature.llm_chat.description': 'AI chat screen with OpenAI or Gemini',
+    'modules.feature.feedback.description': 'In-app feature requests and voting',
+    'modules.feature.local_notifications.description': 'Local reminders scheduled by the user (no server required)',
+    'modules.feature.ci.description': 'CI/CD: GitHub/GitLab (tests + build) + Codemagic (publish to stores)',
     'checks.checking': 'Checking {name}...',
     'checks.found': '{name} found',
     'checks.foundWithVersion': '{name} ready ({version})',
@@ -248,7 +257,7 @@ const MESSAGES = {
     'new.q.preset': 'Which features to include?',
     'new.q.preset.starter': '⚡ Starter — analytics + crash reports + onboarding',
     'new.q.preset.saas': '💰 SaaS — subscriptions + analytics + onboarding + feedback',
-    'new.q.preset.content': '📱 Content — analytics + onboarding + camera + LLM chat',
+    'new.q.preset.content': '📱 Content — crash reports + analytics + onboarding + AI chat',
     'new.q.preset.full': '🚀 Full — all features',
     'new.q.preset.custom': '⚙️  Custom — choose features one by one',
     'new.q.preset.none': '○  None — just the core',
@@ -411,18 +420,17 @@ const MESSAGES = {
     'new.modules.header.feedback': '── Feedback (Firebase + Supabase) ──',
     'new.modules.header.ci': '── CI/CD ──',
     'new.modules.header.monetization': '── Monetization ──',
-    'new.firebase.module.revenuecat': '💰 In-app subscriptions (RevenueCat)',
-    'new.firebase.module.sentry': '🚨 Crash reporting (Sentry)',
+    'new.firebase.module.revenuecat': '💰 RevenueCat (enables Subscriptions)',
+    'new.firebase.module.sentry': '🚨 Crash Reports (Sentry)',
     'new.firebase.module.analytics': '📊 Analytics (Mixpanel)',
-    'new.firebase.module.facebook': '👤 Facebook login (requires App ID + Token)',
-    'new.firebase.module.web': '🌐 Web (add browser support — iOS/Android always included)',
-    'new.firebase.module.widget': '📱 Home widget (iOS/Android)',
-    'new.firebase.module.camera': '📷 Camera feature',
-    'new.firebase.module.llm_chat': '🤖 LLM chat feature',
-    'new.firebase.module.local_notifications': '🔔 Local reminders — user-scheduled notifications (iOS & Android only)',
-    'new.firebase.module.feedback': '💬 Feedback / feature requests',
-    'new.firebase.module.ci': '⚙️ CI: GitHub/GitLab (tests + build) + Codemagic (publish to stores)',
-    'new.firebase.module.onboarding': '👋 Onboarding (welcome screens, profile questions)',
+    'new.firebase.module.facebook': '👤 Facebook (Login + Ads)',
+    'new.firebase.module.web': '🌐 Web Support (PWA, Firebase only)',
+    'new.firebase.module.widget': '📱 Home Widget (iOS/Android)',
+    'new.firebase.module.llm_chat': '🤖 AI Chat (OpenAI/Gemini)',
+    'new.firebase.module.local_notifications': '🔔 Local Reminders (no server)',
+    'new.firebase.module.feedback': '💬 Feature Requests (requires Firebase or Supabase)',
+    'new.firebase.module.ci': '⚙️ CI/CD (GitHub + Codemagic)',
+    'new.firebase.module.onboarding': '👋 Onboarding (welcome flow)',
 
     'new.firebase.q.secrets.configureNow': 'Configure server secrets now? (RevenueCat webhook, Meta Ads)',
     'new.firebase.q.secrets.configureNow.hint': 'If not now, see the README for commands to add them later',
@@ -633,7 +641,7 @@ const MESSAGES = {
     'notifications.summary.demo': 'Home → Features (demo):',
     'notifications.summary.reminder': 'Settings → Reminders (scheduled):',
 
-    'add.list.title': 'Available features (✓ = already active)',
+    'add.list.title': 'Project features',
     'add.error.noModule': 'Provide a feature name or use --list to see available features.',
     'add.error.notKasyProject': 'No kit_setup.json found. Run this command from inside a Kasy project.',
     'add.error.unknownModule': 'Unknown feature: {module}\nAvailable: {list}',
@@ -692,7 +700,7 @@ const MESSAGES = {
     'remove.warn.ci': 'CI files removed. If you had custom workflow files, restore them from git.',
     'remove.warn.sentry.shared': 'sentry_flutter kept — still required by active features (revenuecat/facebook).',
     'cli.command.update.description': '⬆️  Update features/components in an existing project',
-    'cli.command.update.targetArg': 'Target to update (e.g. camera, revenuecat, sentry, components)',
+    'cli.command.update.targetArg': 'Target to update (e.g. revenuecat, sentry, components)',
     'update.error.noProject': 'No kit_setup.json found. Run this command from inside a Kasy project.',
     'update.error.unknownModule': 'Unknown feature: {module}\nAvailable: {list}',
     'update.error.unknownTarget': 'Unknown update target: {module}\nAvailable: {list}',
@@ -759,7 +767,7 @@ const MESSAGES = {
     '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,camera,llm_chat,revenuecat,ci)',
+    'cli.command.setup.featuresOption': 'Features opcionais separadas por virgula (web,widget,llm_chat,revenuecat,ci)',
     'cli.command.help.paramName': 'comando',
     'cli.command.doctor.description': '🩺 Verifica ambiente e dependencias',
     'cli.command.modules.description': '🧩 Lista backends e features disponiveis',
@@ -798,22 +806,31 @@ const MESSAGES = {
     'doctor.requiredMissing': 'Dependencias obrigatorias ausentes. Corrija os erros acima e execute o doctor novamente.',
     'doctor.requiredPassed': '✓ Verificacoes obrigatorias de ambiente aprovadas.',
     'modules.backends': 'Backends disponiveis:',
-    'modules.features': 'Features opcionais disponiveis:',
+    'modules.featuresBase': 'Sempre incluido:',
+    'modules.features': 'Features opcionais:',
+    'modules.tag.firebaseOnly': 'somente Firebase',
+    'modules.tag.requiresDb': 'requer Firebase ou Supabase',
+    'modules.tag.enhances': 'ativa {target}',
+    'modules.hint.subscriptionNoRc': 'Dica: a tela de Subscriptions esta inclusa mas inativa. Rode `kasy add revenuecat` para habilitar pagamentos reais.',
+    'modules.feature.base.authentication.description': 'Cadastro, login e gerenciamento de conta',
+    'modules.feature.base.home.description': 'Tela principal do app apos o login',
+    'modules.feature.base.settings.description': 'Tema, idioma, conta e preferencias',
+    'modules.feature.base.notifications.description': 'Notificacoes push via Firebase Cloud Messaging (funciona com qualquer backend)',
+    'modules.feature.base.subscription.description': 'Tela e modelo de assinatura premium (adicione RevenueCat para habilitar pagamentos reais)',
     'modules.backend.firebase.description': 'Adapter de backend Firebase',
     '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.facebook.description': 'Integracao de Login com Facebook',
-    'modules.feature.revenuecat.description': 'Integracao de assinaturas com RevenueCat',
-    'modules.feature.onboarding.description': 'Feature de fluxo de onboarding',
-    'modules.feature.web.description': 'Camada de compatibilidade Web',
-    'modules.feature.widget.description': 'Integracao de widget iOS/Android',
-    'modules.feature.camera.description': 'Template da feature de camera',
-    'modules.feature.llm_chat.description': 'Template da feature de chat com LLM',
-    'modules.feature.feedback.description': 'Feature de feedback e sugestoes de funcionalidades',
-    'modules.feature.local_notifications.description': 'Lembretes locais — agendados pelo usuario (apenas iOS e Android)',
-    'modules.feature.ci.description': 'CI: GitHub/GitLab (testes + build) + Codemagic (publicacao nas lojas)',
+    '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.feedback.description': 'Pedidos e votacao de features dentro do app',
+    'modules.feature.local_notifications.description': 'Lembretes locais agendados pelo usuario (sem servidor)',
+    'modules.feature.ci.description': 'CI/CD: GitHub/GitLab (testes + build) + Codemagic (publicacao nas lojas)',
     'checks.checking': 'Verificando {name}...',
     'checks.found': '{name} encontrado',
     'checks.foundWithVersion': '{name} pronto ({version})',
@@ -973,7 +990,7 @@ const MESSAGES = {
     'new.q.preset': 'Quais features incluir?',
     'new.q.preset.starter': '⚡ Starter — analytics + erros + onboarding',
     'new.q.preset.saas': '💰 SaaS — assinaturas + analytics + onboarding + feedback',
-    'new.q.preset.content': '📱 Conteudo — analytics + onboarding + camera + chat LLM',
+    'new.q.preset.content': '📱 Conteudo — crash reports + analytics + onboarding + AI chat',
     'new.q.preset.full': '🚀 Completo — todas as features',
     'new.q.preset.custom': '⚙️  Personalizar — escolha feature a feature',
     'new.q.preset.none': '○  Nenhum — so o core',
@@ -1136,18 +1153,17 @@ const MESSAGES = {
     'new.modules.header.feedback': '── Feedback (Firebase + Supabase) ──',
     'new.modules.header.ci': '── CI/CD ──',
     'new.modules.header.monetization': '── Monetizacao ──',
-    'new.firebase.module.revenuecat': '💰 Assinaturas no app (RevenueCat)',
-    'new.firebase.module.sentry': '🚨 Relatorio de erros (Sentry)',
+    'new.firebase.module.revenuecat': '💰 RevenueCat (ativa Subscriptions)',
+    'new.firebase.module.sentry': '🚨 Crash Reports (Sentry)',
     'new.firebase.module.analytics': '📊 Analytics (Mixpanel)',
-    'new.firebase.module.facebook': '👤 Login com Facebook (requer App ID + Token)',
-    'new.firebase.module.web': '🌐 Web (adicional ao nativo — iOS/Android sempre incluidos)',
-    'new.firebase.module.widget': '📱 Widget na tela inicial (iOS/Android)',
-    'new.firebase.module.camera': '📷 Feature de camera',
-    'new.firebase.module.llm_chat': '🤖 Feature de chat com LLM',
-    'new.firebase.module.local_notifications': '🔔 Lembretes locais — agendados pelo usuario (apenas iOS e Android)',
-    'new.firebase.module.feedback': '💬 Feedback / sugestoes de features',
-    'new.firebase.module.ci': '⚙️ CI: GitHub/GitLab (testes + build) + Codemagic (publicacao nas lojas)',
-    'new.firebase.module.onboarding': '👋 Onboarding (telas de boas-vindas, perguntas de perfil)',
+    'new.firebase.module.facebook': '👤 Facebook (Login + Ads)',
+    'new.firebase.module.web': '🌐 Web Support (PWA, somente Firebase)',
+    '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.feedback': '💬 Feature Requests (requer Firebase ou Supabase)',
+    'new.firebase.module.ci': '⚙️ CI/CD (GitHub + Codemagic)',
+    'new.firebase.module.onboarding': '👋 Onboarding (fluxo de boas-vindas)',
 
     'new.firebase.q.secrets.configureNow': 'Configurar as secrets do servidor agora? (webhook RevenueCat, Meta Ads)',
     'new.firebase.q.secrets.configureNow.hint': 'Se nao agora, veja o README para os comandos de configuracao depois',
@@ -1358,7 +1374,7 @@ const MESSAGES = {
     'notifications.summary.demo': 'Home → Features (demo):',
     'notifications.summary.reminder': 'Configuracoes → Lembretes (agendado):',
 
-    'add.list.title': 'Features disponiveis (✓ = ja ativa)',
+    'add.list.title': 'Features do projeto',
     'add.error.noModule': 'Informe o nome da feature ou use --list para ver as disponiveis.',
     'add.error.notKasyProject': 'kit_setup.json nao encontrado. Execute este comando dentro de um projeto Kasy.',
     'add.error.unknownModule': 'Feature desconhecida: {module}\nDisponiveis: {list}',
@@ -1417,7 +1433,7 @@ const MESSAGES = {
     'remove.warn.ci': 'Arquivos de CI removidos. Se tinha workflows customizados, restaure-os pelo git.',
     'remove.warn.sentry.shared': 'sentry_flutter mantido — ainda necessario para features ativas (revenuecat/facebook).',
     'cli.command.update.description': '⬆️  Atualiza features/componentes em um projeto existente',
-    'cli.command.update.targetArg': 'Alvo para atualizar (ex.: camera, revenuecat, sentry, components)',
+    'cli.command.update.targetArg': 'Alvo para atualizar (ex.: revenuecat, sentry, components)',
     'update.error.noProject': 'kit_setup.json nao encontrado. Execute dentro de um projeto Kasy.',
     'update.error.unknownModule': 'Modulo desconhecido: {module}\nDisponiveis: {list}',
     'update.error.unknownTarget': 'Alvo de atualizacao desconhecido: {module}\nDisponiveis: {list}',
@@ -1484,7 +1500,7 @@ const MESSAGES = {
     'cli.command.setup.langName': 'idioma',
     'cli.command.setup.langOption': 'Idioma de prompts (en, pt, es)',
     'cli.command.setup.backendOption': 'Adapter de backend (firebase, supabase, api)',
-    'cli.command.setup.featuresOption': 'Features opcionales separadas por coma (web,widget,camera,llm_chat,revenuecat,ci)',
+    'cli.command.setup.featuresOption': 'Features opcionales separadas por coma (web,widget,llm_chat,revenuecat,ci)',
     'cli.command.help.paramName': 'comando',
     'cli.command.doctor.description': '🩺 Verifica entorno y dependencias',
     'cli.command.modules.description': '🧩 Lista backends y features disponibles',
@@ -1523,22 +1539,31 @@ const MESSAGES = {
     'doctor.requiredMissing': 'Faltan dependencias obligatorias. Corrige los errores anteriores y ejecuta doctor nuevamente.',
     'doctor.requiredPassed': '✓ Verificaciones obligatorias de entorno aprobadas.',
     'modules.backends': 'Backends disponibles:',
-    'modules.features': 'Features opcionales disponibles:',
+    'modules.featuresBase': 'Siempre incluido:',
+    'modules.features': 'Features opcionales:',
+    'modules.tag.firebaseOnly': 'solo Firebase',
+    'modules.tag.requiresDb': 'requiere Firebase o Supabase',
+    'modules.tag.enhances': 'activa {target}',
+    'modules.hint.subscriptionNoRc': 'Tip: la pantalla de Subscriptions esta incluida pero inactiva. Ejecuta `kasy add revenuecat` para habilitar pagos reales.',
+    'modules.feature.base.authentication.description': 'Registro, inicio de sesion y gestion de cuenta',
+    'modules.feature.base.home.description': 'Pantalla principal de la app despues del login',
+    'modules.feature.base.settings.description': 'Tema, idioma, cuenta y preferencias',
+    'modules.feature.base.notifications.description': 'Notificaciones push via Firebase Cloud Messaging (funciona con cualquier backend)',
+    'modules.feature.base.subscription.description': 'Pantalla y modelo de suscripcion premium (anade RevenueCat para habilitar pagos reales)',
     'modules.backend.firebase.description': 'Adapter de backend Firebase',
     'modules.backend.supabase.description': 'Adapter de backend Supabase',
     'modules.backend.api.description': 'Adapter de backend API REST/GraphQL',
     'modules.feature.sentry.description': 'Seguimiento de errores y crashes con Sentry',
     'modules.feature.analytics.description': 'Seguimiento de eventos de analytics (Firebase Analytics)',
-    'modules.feature.facebook.description': 'Integracion de inicio de sesion con Facebook',
-    'modules.feature.revenuecat.description': 'Integracion de suscripciones con RevenueCat',
-    'modules.feature.onboarding.description': 'Feature de flujo de onboarding',
-    'modules.feature.web.description': 'Capa de compatibilidad Web',
-    'modules.feature.widget.description': 'Integracion de widget iOS/Android',
-    'modules.feature.camera.description': 'Plantilla de la feature de camara',
-    'modules.feature.llm_chat.description': 'Plantilla de la feature de chat con LLM',
-    'modules.feature.feedback.description': 'Feature de feedback y sugerencias de funcionalidades',
-    'modules.feature.local_notifications.description': 'Recordatorios locales — programados por el usuario (solo iOS y Android)',
-    'modules.feature.ci.description': 'CI: GitHub/GitLab (tests + build) + Codemagic (publicacion en tiendas)',
+    'modules.feature.facebook.description': 'Login de Facebook y seguimiento de eventos Meta Ads (siempre juntos)',
+    'modules.feature.revenuecat.description': 'Habilita pagos reales en la pantalla de Subscriptions',
+    'modules.feature.onboarding.description': 'Flujo de bienvenida mostrado en el primer acceso',
+    'modules.feature.web.description': 'Soporte Web/PWA',
+    'modules.feature.widget.description': 'Widget de pantalla inicial iOS/Android',
+    'modules.feature.llm_chat.description': 'Pantalla de chat con IA usando OpenAI o Gemini',
+    'modules.feature.feedback.description': 'Solicitudes y votacion de features dentro de la app',
+    'modules.feature.local_notifications.description': 'Recordatorios locales programados por el usuario (sin servidor)',
+    'modules.feature.ci.description': 'CI/CD: GitHub/GitLab (tests + build) + Codemagic (publicacion en tiendas)',
     'checks.checking': 'Verificando {name}...',
     'checks.found': '{name} encontrado',
     'checks.foundWithVersion': '{name} listo ({version})',
@@ -1700,7 +1725,7 @@ const MESSAGES = {
     'new.q.preset': '¿Qué features incluir?',
     'new.q.preset.starter': '⚡ Starter — analytics + errores + onboarding',
     'new.q.preset.saas': '💰 SaaS — suscripciones + analytics + onboarding + feedback',
-    'new.q.preset.content': '📱 Contenido — analytics + onboarding + camara + chat LLM',
+    'new.q.preset.content': '📱 Contenido — crash reports + analytics + onboarding + AI chat',
     'new.q.preset.full': '🚀 Completo — todas las features',
     'new.q.preset.custom': '⚙️  Personalizar — elige feature a feature',
     'new.q.preset.none': '○  Ninguno — solo el core',
@@ -1861,18 +1886,17 @@ const MESSAGES = {
     'new.modules.header.feedback': '── Feedback (Firebase + Supabase) ──',
     'new.modules.header.ci': '── CI/CD ──',
     'new.modules.header.monetization': '── Monetizacion ──',
-    'new.firebase.module.revenuecat': '💰 Suscripciones en app (RevenueCat)',
-    'new.firebase.module.sentry': '🚨 Reporte de errores (Sentry)',
+    'new.firebase.module.revenuecat': '💰 RevenueCat (activa Subscriptions)',
+    'new.firebase.module.sentry': '🚨 Crash Reports (Sentry)',
     'new.firebase.module.analytics': '📊 Analytics (Mixpanel)',
-    'new.firebase.module.facebook': '👤 Login con Facebook (requiere App ID + Token)',
-    'new.firebase.module.web': '🌐 Web (adicional al nativo — iOS/Android siempre incluidos)',
-    'new.firebase.module.widget': '📱 Widget de inicio (iOS/Android)',
-    'new.firebase.module.camera': '📷 Feature de camara',
-    'new.firebase.module.llm_chat': '🤖 Feature de chat con LLM',
-    'new.firebase.module.local_notifications': '🔔 Recordatorios locales — programados por el usuario (solo iOS y Android)',
-    'new.firebase.module.feedback': '💬 Feedback / sugerencias de features',
-    'new.firebase.module.ci': '⚙️ CI: GitHub/GitLab (tests + build) + Codemagic (publicacion en tiendas)',
-    'new.firebase.module.onboarding': '👋 Onboarding (pantallas de bienvenida, preguntas de perfil)',
+    'new.firebase.module.facebook': '👤 Facebook (Login + Ads)',
+    'new.firebase.module.web': '🌐 Web Support (PWA, solo Firebase)',
+    'new.firebase.module.widget': '📱 Home Widget (iOS/Android)',
+    'new.firebase.module.llm_chat': '🤖 AI Chat (OpenAI/Gemini)',
+    'new.firebase.module.local_notifications': '🔔 Local Reminders (sin servidor)',
+    'new.firebase.module.feedback': '💬 Feature Requests (requiere Firebase o Supabase)',
+    'new.firebase.module.ci': '⚙️ CI/CD (GitHub + Codemagic)',
+    'new.firebase.module.onboarding': '👋 Onboarding (flujo de bienvenida)',
 
     'new.firebase.q.secrets.configureNow': '¿Configurar los secrets del servidor ahora? (webhook RevenueCat, Meta Ads)',
     'new.firebase.q.secrets.configureNow.hint': 'Si no ahora, vea el README para los comandos de configuración después',
@@ -2083,7 +2107,7 @@ const MESSAGES = {
     'notifications.summary.demo': 'Home → Features (demo):',
     'notifications.summary.reminder': 'Ajustes → Recordatorios (programado):',
 
-    'add.list.title': 'Features disponibles (✓ = ya activa)',
+    'add.list.title': 'Features del proyecto',
     'add.error.noModule': 'Indica el nombre de la feature o usa --list para ver las disponibles.',
     'add.error.notKasyProject': 'kit_setup.json no encontrado. Ejecuta este comando dentro de un proyecto Kasy.',
     'add.error.unknownModule': 'Feature desconocida: {module}\nDisponibles: {list}',
@@ -2142,7 +2166,7 @@ const MESSAGES = {
     'remove.warn.ci': 'Archivos de CI eliminados. Si tenias workflows personalizados, restauralos desde git.',
     'remove.warn.sentry.shared': 'sentry_flutter conservado — todavia requerido por features activas (revenuecat/facebook).',
     'cli.command.update.description': '⬆️  Actualiza features/componentes en un proyecto existente',
-    'cli.command.update.targetArg': 'Objetivo a actualizar (ej.: camera, revenuecat, sentry, components)',
+    'cli.command.update.targetArg': 'Objetivo a actualizar (ej.: revenuecat, sentry, components)',
     'update.error.noProject': 'kit_setup.json no encontrado. Ejecuta dentro de un proyecto Kasy.',
     'update.error.unknownModule': 'Modulo desconocido: {module}\nDisponibles: {list}',
     'update.error.unknownTarget': 'Objetivo de actualizacion desconocido: {module}\nDisponibles: {list}',