kasy-cli 1.17.0 → 1.18.0

package/lib/utils/flutter-run.js

@@ -5,18 +5,29 @@
  * stage detection, elapsed timer, hot-reload stdin pass-through and SIGINT
  * forwarding stay consistent in one place.
  *
- * Flow:
- *  - Spawn flutter with piped stdio.
- *  - Show a Clack spinner with elapsed time, ticking every second.
- *  - As Flutter logs scroll, update the spinner message when we see a known
- *    stage marker (Gradle, Xcode, install, sync, etc.).
- *  - When Flutter signals "ready" (DAP key commands), flush buffered output,
- *    drop into stdio pass-through and pipe stdin so hot reload works.
- *  - On early exit, replay the buffer so the user can see the error.
+ * Two modes:
+ *
+ *  - spinner mode (default, TTY only): Spawn flutter with piped stdio. Show a
+ *    Clack spinner with elapsed time. Update the spinner message when we see a
+ *    known stage marker (Gradle, Xcode, install, sync, etc.). When Flutter
+ *    signals "ready" (DAP key commands), flush buffered output, drop into stdio
+ *    pass-through, and pipe stdin so hot reload works. On early exit, replay
+ *    the buffer so the user can see the error.
+ *
+ *  - raw mode (auto when stdout is not a TTY, or forced via `--raw`):
+ *    No spinner, no buffer. Flutter output is piped straight through so devs
+ *    and AI agents see the unmodified stream.
+ *
+ * In both modes we always tee the raw (ANSI-stripped) flutter output to
+ * `<project>/.kasy/run.log`. This gives AI assistants a stable, single-file
+ * source of truth for the last run, even when the spinner cosmetically rewrites
+ * the human terminal.
  */
 
 'use strict';
 
+const path = require('node:path');
+const fs = require('node:fs');
 const { spawn } = require('node:child_process');
 const kleur = require('kleur');
 const ui = require('./ui');
@@ -24,6 +35,35 @@ const ui = require('./ui');
 // Markers that tell us the initial build is done and the app is running.
 const FLUTTER_READY_RE = /Flutter run key commands\.|is listening on|VM Service|Dart VM service|To hot reload|Hot restart/i;
 
+// Strip ANSI escape sequences before persisting to the log file so the file
+// is grep-friendly for tooling (CI logs, agents, editors).
+const ANSI_RE = /\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
+
+function stripAnsi(text) {
+  return String(text).replace(ANSI_RE, '');
+}
+
+/**
+ * Open (and create the parent dir of) the persistent run log. Overwrites any
+ * previous run — we want "the last run", not an ever-growing history.
+ *
+ * Returns a write stream, or null when the file can't be created (read-only
+ * project, permissions, etc.) — failure here must never break `kasy run`.
+ */
+function openRunLog(projectDir) {
+  const logPath = path.join(projectDir, '.kasy', 'run.log');
+  try {
+    fs.mkdirSync(path.dirname(logPath), { recursive: true });
+    const stream = fs.createWriteStream(logPath, { flags: 'w' });
+    stream.on('error', () => {});
+    const header = `# kasy run — ${new Date().toISOString()}\n`;
+    stream.write(header);
+    return { stream, logPath };
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Map a chunk of Flutter output to a user-friendly stage label, or null
  * if the chunk doesn't carry any of the known markers.
@@ -66,10 +106,82 @@ function render(stageMessage, startTime) {
 }
 
 /**
- * Spawn `flutter` with the given args inside `projectDir`, surfacing progress
- * through a Clack spinner. Resolves on success, rejects on non-zero exit.
+ * Pretty-print the path used for the run log. Falls back to the absolute path
+ * when the log lives outside cwd (unusual, but keeps the message accurate).
  */
-function spawnFlutterWithSpinner(args, projectDir, t) {
+function relLogPath(logPath) {
+  const rel = path.relative(process.cwd(), logPath);
+  return rel.startsWith('..') ? logPath : rel;
+}
+
+/**
+ * Spawn `flutter` with the given args inside `projectDir`. When `options.raw`
+ * is true or stdout is not a TTY, runs in raw pass-through mode. Otherwise,
+ * shows a Clack spinner that buffers output until Flutter is ready.
+ *
+ * Resolves on success, rejects on non-zero exit. The log file path is always
+ * announced at the end so callers (and AI agents) can find the full output.
+ */
+function spawnFlutterWithSpinner(args, projectDir, t, options = {}) {
+  const raw = Boolean(options.raw) || !process.stdout.isTTY;
+  const log = openRunLog(projectDir);
+
+  if (raw) return spawnRaw(args, projectDir, t, log);
+  return spawnWithSpinner(args, projectDir, t, log);
+}
+
+/**
+ * Raw mode: no spinner, no buffer. Flutter stdout/stderr are piped straight
+ * through to the parent process, and tee'd (ANSI-stripped) into the log file.
+ *
+ * Stdin is forwarded directly so hot-reload keys (r/R/q) work without any
+ * raw-mode toggling — the user is already on a "dumb" terminal here.
+ */
+function spawnRaw(args, projectDir, t, log) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn('flutter', args, {
+      cwd: projectDir,
+      stdio: ['inherit', 'pipe', 'pipe'],
+    });
+
+    const tee = (chunk, sink) => {
+      sink.write(chunk);
+      if (log) log.stream.write(stripAnsi(chunk.toString()));
+    };
+
+    proc.stdout.on('data', (c) => tee(c, process.stdout));
+    proc.stderr.on('data', (c) => tee(c, process.stderr));
+
+    const sigintHandler = () => { try { proc.kill('SIGINT'); } catch (_) {} };
+    process.on('SIGINT', sigintHandler);
+
+    const cleanup = () => {
+      process.off('SIGINT', sigintHandler);
+      if (log) log.stream.end();
+    };
+
+    proc.on('close', (code) => {
+      cleanup();
+      announceLog(log, t);
+      if (code === 0) resolve();
+      else reject(new Error(`flutter exited with code ${code}`));
+    });
+
+    proc.on('error', (err) => {
+      cleanup();
+      announceLog(log, t);
+      reject(err);
+    });
+  });
+}
+
+/**
+ * Spinner mode: buffer flutter output during the build phase, surface progress
+ * as friendly stage labels, then flush + pass-through once Flutter signals
+ * ready. On early exit, the buffer is replayed so the user sees the real
+ * Flutter error.
+ */
+function spawnWithSpinner(args, projectDir, t, log) {
   return new Promise((resolve, reject) => {
     const proc = spawn('flutter', args, {
       cwd: projectDir,
@@ -106,7 +218,12 @@ function spawnFlutterWithSpinner(args, projectDir, t) {
       }
     };
 
+    const teeLog = (chunk) => {
+      if (log) log.stream.write(stripAnsi(chunk.toString()));
+    };
+
     const handleStdout = (chunk) => {
+      teeLog(chunk);
       const text = chunk.toString();
       if (!ready) {
         buffer.push(chunk);
@@ -122,6 +239,7 @@ function spawnFlutterWithSpinner(args, projectDir, t) {
     };
 
     const handleStderr = (chunk) => {
+      teeLog(chunk);
       if (!ready) {
         buffer.push(chunk);
         if (FLUTTER_READY_RE.test(chunk.toString())) flushAndSwitch();
@@ -144,6 +262,7 @@ function spawnFlutterWithSpinner(args, projectDir, t) {
         process.stdin.unpipe(proc.stdin);
         process.stdin.pause();
       }
+      if (log) log.stream.end();
     };
 
     proc.on('close', (code) => {
@@ -152,6 +271,7 @@ function spawnFlutterWithSpinner(args, projectDir, t) {
         spinner.stop(t('run.spinner.failed'), 2);
         for (const chunk of buffer) process.stdout.write(chunk);
       }
+      announceLog(log, t);
       if (code === 0) resolve();
       else reject(new Error(`flutter exited with code ${code}`));
     });
@@ -159,15 +279,23 @@ function spawnFlutterWithSpinner(args, projectDir, t) {
     proc.on('error', (err) => {
       cleanup();
       if (!ready) spinner.stop(t('run.spinner.failed'), 2);
+      announceLog(log, t);
       reject(err);
     });
   });
 }
 
+function announceLog(log, t) {
+  if (!log) return;
+  const msg = t('run.log.savedTo', { path: relLogPath(log.logPath) });
+  console.log(kleur.dim(`\n  ${msg}`));
+}
+
 module.exports = {
   spawnFlutterWithSpinner,
   // Exported for tests and reuse in non-flutter spawn helpers.
   detectStage,
   formatElapsed,
   FLUTTER_READY_RE,
+  stripAnsi,
 };

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

@@ -79,6 +79,9 @@ module.exports = {
     'doctor.title': 'Kasy Doctor',
     'doctor.baseEnvironment': 'Base environment',
     'doctor.optionalBackend': 'Optional backend tooling',
+    'doctor.gcpBilling.title': 'Google Cloud Billing (Firebase Blaze)',
+    'doctor.gcpBilling.found': '{count} active billing account(s):',
+    'doctor.gcpBilling.missing': 'No billing account found. Create one before running `kasy new` with Firebase:',
     'doctor.requiredMissing': 'Missing required dependencies. Fix the errors above and rerun doctor.',
     'doctor.requiredPassed': '✓ Required environment checks passed.',
     'modules.backends': 'Available backends:',
@@ -196,6 +199,10 @@ module.exports = {
     'new.firebase.create.success': 'Firebase project created successfully.',
     'new.firebase.create.failed': 'Could not create project',
     'new.firebase.create.gcloudRequired': 'gcloud CLI is required for "create from scratch". Without it, the full Firebase flow cannot run.',
+    'new.firebase.billing.required': 'You do not have a billing account on Google Cloud yet. Firebase needs the Blaze plan to use Storage and Cloud Functions.',
+    'new.firebase.billing.create.steps': 'Opening the billing account creation page. Create the account (credit card required, no charges within the free quota) and come back here:',
+    'new.firebase.billing.created.ready': 'I created the billing account, ready to continue?',
+    'new.firebase.billing.stillMissing': 'No active billing account found. Finish the setup in the Console and run `kasy new` again.',
     'new.firebase.create.installTitle': 'To install gcloud CLI, run:',
     'new.firebase.create.installCommand': 'Command',
     'new.firebase.create.installAfter': 'Then log in',
@@ -212,6 +219,8 @@ module.exports = {
     'new.firebase.q.organization': 'In which GCP organization should the project be created?',
     'new.firebase.q.organization.none': 'No organization (personal account / standalone project)',
     'new.firebase.q.organization.hint': 'Organizations linked to your gcloud account',
+    'new.firebase.create.billingWait': 'Waiting for billing propagation…',
+    'new.firebase.create.billingQuotaError': 'Could not link billing (account quota reached or propagation not finished yet).',
     'new.firebase.create.billingRetry.title': 'Link billing manually (quota exceeded or billing error):',
     'new.firebase.create.billingRetry.hint': 'Tip: Limit is 3 projects per billing account. Remove unused projects at the link above. If you just removed one, wait 2–5 min for changes to propagate, then retry.',
     'new.firebase.create.billingRetry.ready': 'Linked billing. Retry setup?',
@@ -233,6 +242,7 @@ module.exports = {
     'new.supabase.loginHint': 'Run: supabase login. Then enter your existing project URL and key below.',
     'new.supabase.setup': 'Linking project and deploying…',
     'new.supabase.setupManual': 'Run manually: supabase link, supabase db push, supabase functions deploy',
+    'new.supabase.passwordSaved': 'Database password auto-generated and saved to .kasy/supabase.json (gitignored).',
     'new.supabase.q.useExisting.orgSelect': 'Which organization is the project in?',
     'new.supabase.q.useExisting.projectSelect': 'Which existing Supabase project do you want to use?',
     'new.supabase.projectsRequired': 'No projects found in this organization.',
@@ -273,9 +283,9 @@ module.exports = {
     'new.q.backend.supabase.desc': 'SQL database (PostgreSQL) with more control',
     'new.q.backend.api.desc': 'You already have your own backend server',
 
-    'new.q.mode': 'How do you want to configure?',
-    'new.q.mode.quick': '⚡ Quick — minimal questions, smart defaults',
-    'new.q.mode.advanced': '🛠  Advanced — all options and credentials now',
+    'new.q.mode': 'How do you want to create the app?',
+    'new.q.mode.quick': '⚡ Quick (recommended): everything ready, zero config',
+    'new.q.mode.advanced': '🛠  Step by step: pick every detail',
 
     'new.q.preset': 'Which features to include?',
     'new.q.preset.starter': '⚡ Starter — analytics + crash reports + onboarding',
@@ -288,6 +298,40 @@ module.exports = {
     'new.firebase.success.deployStep': '• Deploy backend (from inside the project folder):',
 
     'cli.command.deploy.description': 'Publish the server to Firebase or Supabase',
+    'cli.command.configure.description': 'Configure optional keys (RevenueCat, Sentry, Mixpanel...) — skippable, picks up where you left off',
+    'configure.title': 'App credential setup',
+    'configure.notKasyProject': 'This folder is not a Kasy project (no pubspec.yaml). Cd into the project and run again.',
+    'configure.alreadyFilled': 'Already configured ({count}):',
+    'configure.toFill': 'Missing ({count}):',
+    'configure.skipHint': 'Press Enter without typing to skip any key. Run `kasy configure` again when you have the credential.',
+    'configure.skipPlaceholder': '(leave empty to skip)',
+    'configure.saved': 'Saved to {path} ({count} key(s) filled)',
+    'configure.stillPending': '{count} key(s) still pending.',
+    'configure.runAgainHint': 'Run `kasy configure` again once you have the keys.',
+    'configure.allDone': 'All set! You can run the app without missing credentials.',
+    'configure.allSkipped': 'No keys filled this time. Run again when ready.',
+    'configure.outroSaved': '{count} key(s) updated in .env',
+    'configure.outroNoChange': 'No changes to .env',
+    'configure.aborted': 'Cancelled. Nothing was written.',
+    'configure.section.appStore': 'App Store',
+    'configure.section.sentry': 'Sentry (Crash Reports)',
+    'configure.section.mixpanel': 'Mixpanel (Analytics)',
+    'configure.section.revenuecat': 'RevenueCat (Subscriptions)',
+    'configure.section.facebook': 'Facebook (Login + Ads)',
+    'configure.section.llmChat': 'AI Chat (LLM)',
+    'configure.savedFacebook': 'Facebook credentials written to Info.plist and strings.xml.',
+    'configure.facebookPlistMissing': 'ios/Runner/Info.plist not found — Facebook iOS was not updated.',
+    'configure.facebookStringsMissing': 'android/.../strings.xml not found — Facebook Android was not updated.',
+    'configure.facebookNeedsAppId': 'Facebook credentials need an App ID. Run `kasy configure` again and provide the App ID.',
+    'configure.noOptionalFeatures': 'This project has no optional features that need credentials.',
+    'configure.statusSummary': '{filled} already configured, {pending} pending',
+    'configure.alreadyDone': 'all set',
+    'configure.alreadyFilledShort': 'already configured',
+    'configure.savedEnv': '{count} key(s) saved to .env',
+    'configure.savedFnEnv': '{count} key(s) saved to functions/.env',
+    'configure.settingSecrets': 'Setting {count} Firebase Secret(s)…',
+    'configure.savedSecrets': '{count} Firebase Secret(s) set',
+    'configure.secretFailed': 'Could not set secret {key}. Run manually: firebase functions:secrets:set {key}',
     'cli.command.check.description': 'Check push notifications setup (use --fix to fix it)',
     'deploy.q.project': 'Firebase Project ID:',
     'deploy.q.serviceAccount': 'Path to service account JSON:',
@@ -629,13 +673,20 @@ module.exports = {
     'new.outdated.upgradeNow': 'Upgrade to the latest version before creating? (requires active subscription)',
     'new.outdated.upgraded': 'kasy updated! Run kasy new again.',
     'new.success.title': 'Project created successfully!',
+    'new.success.featuresInstalled': 'Features enabled:',
     'new.success.nextSteps': 'Next steps:',
     'new.success.step.cd': 'Go to your project folder:',
-    'new.success.step.deploy': 'Deploy your backend to Firebase:',
+    'new.success.step.deploy': 'Push the server to Firebase (DB + functions):',
+    'new.success.step.configure': 'Configure optional keys when you have them (RevenueCat, Sentry, etc.):',
+    'new.success.step.docs': 'Documentation:',
     'new.success.step.run': 'Run your app (with your configured keys):',
     'new.success.step.run.vscode': '(or F5 in VS Code)',
     'new.success.step.console': 'Open your backend console:',
     'new.fcm.generating': 'Generating push notifications key (Firebase Service Account)…',
+    'new.google.enabling': 'Enabling Google Sign-In…',
+    'new.google.refreshConfigs': 'Updating google-services.json and GoogleService-Info.plist with Google Client IDs…',
+    'new.google.manualHint': 'Google Sign-In: enable manually in the Console (Google provider):',
+    'new.google.manualHint.noEmail': 'Google Sign-In: could not detect a support email (gcloud has no account). Enable manually in the Console:',
     'new.sha1.registering': 'Registering SHA-1 for Google Sign-In (Android)…',
     'new.sha1.failed': 'SHA-1 not added automatically: {error}',
     'new.sha1.manual': 'Add it manually so Google Sign-In works on Android:',
@@ -654,7 +705,8 @@ module.exports = {
     'new.apns.warning': '⚠  iOS Push: configure the APNs Key in Firebase Console',
     'new.apns.step1': '1. Apple Developer Portal → Keys → create APNs Key (.p8)',
     'new.apns.step2': '2. Firebase Console → Cloud Messaging → iOS app → upload APNs Key',
-    'new.firebase.create.estimatedTime': '(usually 3–5 min — do not close the terminal)',
+    'new.apns.hint': 'iOS Push (APNs Key) is only needed once you publish for iOS. Step-by-step: https://kasy.dev/docs/apns',
+    'new.firebase.create.estimatedTime': '(3–5 min — needs stable internet, do not close the terminal)',
     'new.internet.warning': '📶  Make sure you have a stable internet connection — this step requires network access.',
 
     // run command
@@ -682,6 +734,7 @@ module.exports = {
     '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',
+    'run.log.savedTo': 'Full output at {path} (handy to paste into AI/assistant)',
 
     // reset command
     'cli.command.reset.description': 'Uninstall the app on a simulator/emulator/device so you can test as a fresh install',

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

@@ -79,6 +79,9 @@ module.exports = {
     'doctor.title': 'Kasy Doctor',
     'doctor.baseEnvironment': 'Entorno base',
     'doctor.optionalBackend': 'Herramientas opcionales de backend',
+    'doctor.gcpBilling.title': 'Google Cloud Billing (Firebase Blaze)',
+    'doctor.gcpBilling.found': '{count} cuenta(s) de facturación activa(s):',
+    'doctor.gcpBilling.missing': 'No se encontró ninguna cuenta de facturación. Crea una antes de ejecutar `kasy new` con Firebase:',
     'doctor.requiredMissing': 'Faltan dependencias obligatorias. Corrige los errores anteriores y ejecuta doctor nuevamente.',
     'doctor.requiredPassed': '✓ Verificaciones obligatorias de entorno aprobadas.',
     'modules.backends': 'Backends disponibles:',
@@ -196,6 +199,10 @@ module.exports = {
     'new.firebase.create.success': 'Proyecto Firebase creado correctamente.',
     'new.firebase.create.failed': 'No se pudo crear el proyecto',
     'new.firebase.create.gcloudRequired': 'gcloud CLI es obligatorio para "crear desde cero". Sin él, el flujo completo de Firebase no puede ejecutarse.',
+    'new.firebase.billing.required': 'Aún no tienes una cuenta de facturación en Google Cloud. Firebase necesita el plan Blaze para usar Storage y Cloud Functions.',
+    'new.firebase.billing.create.steps': 'Abriendo la página de creación de cuenta de facturación. Crea la cuenta (tarjeta de crédito requerida, sin cargos dentro de la cuota gratuita) y vuelve aquí:',
+    'new.firebase.billing.created.ready': 'Ya creé la cuenta de facturación, ¿puedo continuar?',
+    'new.firebase.billing.stillMissing': 'No se encontró ninguna cuenta de facturación activa. Termina la configuración en la consola y ejecuta `kasy new` nuevamente.',
     'new.firebase.create.installTitle': 'Para instalar gcloud CLI, ejecuta:',
     'new.firebase.create.installCommand': 'Comando',
     'new.firebase.create.installAfter': 'Luego inicia sesión',
@@ -212,6 +219,8 @@ module.exports = {
     'new.firebase.q.organization': '¿En qué organización GCP crear el proyecto?',
     'new.firebase.q.organization.none': 'Sin organización (cuenta personal / proyecto independiente)',
     'new.firebase.q.organization.hint': 'Organizaciones vinculadas a tu cuenta gcloud',
+    'new.firebase.create.billingWait': 'Esperando propagación de la facturación…',
+    'new.firebase.create.billingQuotaError': 'No se pudo vincular la facturación (cuota de la cuenta alcanzada o propagación aún no finalizada).',
     'new.firebase.create.billingRetry.title': 'Vincula la facturación manualmente (cuota excedida o error de billing):',
     'new.firebase.create.billingRetry.hint': 'Consejo: El límite es 3 proyectos por cuenta de facturación. Elimina proyectos no usados en el enlace de arriba. Si acabas de eliminar uno, espera 2–5 min a que se propague el cambio y reintenta.',
     'new.firebase.create.billingRetry.ready': 'He vinculado la facturación. ¿Reintentar?',
@@ -235,6 +244,7 @@ module.exports = {
     'new.supabase.loginHint': 'Ejecuta: supabase login. Luego ingresa la URL y clave de tu proyecto existente.',
     'new.supabase.setup': 'Vinculando proyecto y desplegando…',
     'new.supabase.setupManual': 'Ejecuta manualmente: supabase link, supabase db push, supabase functions deploy',
+    'new.supabase.passwordSaved': 'Contraseña de la base generada y guardada en .kasy/supabase.json (gitignored).',
     'new.supabase.q.useExisting.orgSelect': '¿En qué organización está el proyecto?',
     'new.supabase.q.useExisting.projectSelect': '¿Qué proyecto Supabase existente quieres usar?',
     'new.supabase.projectsRequired': 'No se encontraron proyectos en esta organización.',
@@ -275,9 +285,9 @@ module.exports = {
     'new.q.backend.supabase.desc': 'Base de datos SQL (PostgreSQL) con más control',
     'new.q.backend.api.desc': 'Ya tienes tu propio servidor',
 
-    'new.q.mode': '¿Como quieres configurar?',
-    'new.q.mode.quick': '⚡ Rápido — pocas preguntas, valores inteligentes',
-    'new.q.mode.advanced': '🛠  Avanzado — todas las opciones y credenciales ahora',
+    'new.q.mode': '¿Como quieres crear la app?',
+    'new.q.mode.quick': '⚡ Rápido (recomendado): todo listo, cero configuración',
+    'new.q.mode.advanced': '🛠  Paso a paso: elegir cada detalle',
 
     'new.q.preset': '¿Qué features incluir?',
     'new.q.preset.starter': '⚡ Starter — analytics + errores + onboarding',
@@ -290,6 +300,40 @@ module.exports = {
     'new.firebase.success.deployStep': '• Desplegar backend (desde dentro de la carpeta del proyecto):',
 
     'cli.command.deploy.description': 'Publica el servidor en Firebase o Supabase',
+    'cli.command.configure.description': 'Configura claves opcionales (RevenueCat, Sentry, Mixpanel...) — puede omitir, recuerda lo que falta',
+    'configure.title': 'Configuración de claves del app',
+    'configure.notKasyProject': 'Esta carpeta no es un proyecto Kasy (no se encontró pubspec.yaml). Entra en la carpeta del proyecto y ejecuta de nuevo.',
+    'configure.alreadyFilled': 'Ya configurado ({count}):',
+    'configure.toFill': 'Falta configurar ({count}):',
+    'configure.skipHint': 'Pulsa Enter sin escribir nada para omitir cualquier clave. Ejecuta `kasy configure` de nuevo cuando tengas la credencial.',
+    'configure.skipPlaceholder': '(vacío para omitir)',
+    'configure.saved': 'Guardado en {path} ({count} clave(s) completada(s))',
+    'configure.stillPending': '{count} clave(s) todavía pendiente(s).',
+    'configure.runAgainHint': 'Ejecuta `kasy configure` de nuevo cuando tengas las claves.',
+    'configure.allDone': '¡Todo listo! Puedes ejecutar la app sin pendientes de credenciales.',
+    'configure.allSkipped': 'Ninguna clave completada ahora. Ejecuta de nuevo cuando estés listo.',
+    'configure.outroSaved': '{count} clave(s) actualizada(s) en .env',
+    'configure.outroNoChange': 'Sin cambios en .env',
+    'configure.aborted': 'Cancelado. Nada fue guardado.',
+    'configure.section.appStore': 'App Store',
+    'configure.section.sentry': 'Sentry (Crash Reports)',
+    'configure.section.mixpanel': 'Mixpanel (Analytics)',
+    'configure.section.revenuecat': 'RevenueCat (Suscripciones)',
+    'configure.section.facebook': 'Facebook (Login + Ads)',
+    'configure.section.llmChat': 'AI Chat (LLM)',
+    'configure.savedFacebook': 'Credenciales de Facebook escritas en Info.plist y strings.xml.',
+    'configure.facebookPlistMissing': 'ios/Runner/Info.plist no encontrado — Facebook iOS no fue actualizado.',
+    'configure.facebookStringsMissing': 'android/.../strings.xml no encontrado — Facebook Android no fue actualizado.',
+    'configure.facebookNeedsAppId': 'Las credenciales de Facebook requieren un App ID. Ejecuta `kasy configure` de nuevo y proporciona el App ID.',
+    'configure.noOptionalFeatures': 'Este proyecto no tiene features opcionales que requieran credenciales.',
+    'configure.statusSummary': '{filled} ya configurada(s), {pending} pendiente(s)',
+    'configure.alreadyDone': 'todo listo',
+    'configure.alreadyFilledShort': 'ya configurada',
+    'configure.savedEnv': '{count} clave(s) guardada(s) en .env',
+    'configure.savedFnEnv': '{count} clave(s) guardada(s) en functions/.env',
+    'configure.settingSecrets': 'Guardando {count} Firebase Secret(s)…',
+    'configure.savedSecrets': '{count} Firebase Secret(s) guardado(s)',
+    'configure.secretFailed': 'No pude guardar el secret {key}. Ejecuta manualmente: firebase functions:secrets:set {key}',
     'cli.command.check.description': 'Verifica si las notificaciones push están configuradas (usa --fix para arreglar)',
     'deploy.q.project': 'Firebase Project ID:',
     'deploy.q.serviceAccount': 'Ruta al service account JSON:',
@@ -629,13 +673,20 @@ module.exports = {
     'new.outdated.upgradeNow': '¿Actualizar a la última versión antes de crear? (requiere suscripción activa)',
     'new.outdated.upgraded': '¡kasy actualizado! Ejecuta kasy new nuevamente.',
     'new.success.title': '¡Proyecto creado con exito!',
+    'new.success.featuresInstalled': 'Recursos activados:',
     'new.success.nextSteps': 'Proximos pasos:',
     'new.success.step.cd': 'Ve a la carpeta del proyecto:',
-    'new.success.step.deploy': 'Despliega el backend en Firebase:',
+    'new.success.step.deploy': 'Sube el servidor a Firebase (DB + funciones):',
+    'new.success.step.configure': 'Configura claves opcionales cuando las tengas (RevenueCat, Sentry, etc.):',
+    'new.success.step.docs': 'Documentación:',
     'new.success.step.run': 'Ejecuta el app (con tus claves configuradas):',
     'new.success.step.run.vscode': '(o F5 en VS Code)',
     'new.success.step.console': 'Abre la consola del backend:',
     'new.fcm.generating': 'Generando clave de Service Account FCM…',
+    'new.google.enabling': 'Activando Inicio de sesión con Google…',
+    'new.google.refreshConfigs': 'Actualizando google-services.json y GoogleService-Info.plist con los Client IDs de Google…',
+    'new.google.manualHint': 'Inicio de sesión con Google: actívalo manualmente en la consola (proveedor Google):',
+    'new.google.manualHint.noEmail': 'Inicio de sesión con Google: no detecté un email de soporte (gcloud sin cuenta). Actívalo manualmente en la consola:',
     'new.sha1.registering': 'Registrando SHA-1 para Google Sign-In (Android)…',
     'new.sha1.failed': 'SHA-1 no añadido automaticamente: {error}',
     'new.sha1.manual': 'Agregalo manualmente para que Google Sign-In funcione en Android:',
@@ -654,7 +705,8 @@ module.exports = {
     'new.apns.warning': '⚠  Push iOS: configura la APNs Key en Firebase Console',
     'new.apns.step1': '1. Apple Developer Portal → Keys → crear APNs Key (.p8)',
     'new.apns.step2': '2. Firebase Console → Cloud Messaging → app iOS → subir la APNs Key',
-    'new.firebase.create.estimatedTime': '(generalmente 3-5 min — no cierres la terminal)',
+    'new.apns.hint': 'Push para iOS (APNs Key) solo se necesita cuando publiques para iOS. Paso a paso: https://kasy.dev/docs/apns',
+    'new.firebase.create.estimatedTime': '(3-5 min — requiere internet estable, no cierres la terminal)',
     'new.internet.warning': '📶  Asegúrate de tener una conexión a internet estable — este paso requiere red.',
 
     // run command
@@ -715,6 +767,7 @@ module.exports = {
     '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',
+    'run.log.savedTo': 'Salida completa en {path} (útil para pegar en IA/asistente)',
 
     // doctor project checks
     'doctor.project.title': 'Proyecto',

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

@@ -79,6 +79,9 @@ module.exports = {
     'doctor.title': 'Kasy Doctor',
     'doctor.baseEnvironment': 'Ambiente base',
     'doctor.optionalBackend': 'Ferramentas opcionais de backend',
+    'doctor.gcpBilling.title': 'Google Cloud Billing (Firebase Blaze)',
+    'doctor.gcpBilling.found': '{count} conta(s) de faturamento ativa(s):',
+    'doctor.gcpBilling.missing': 'Nenhuma conta de faturamento encontrada. Crie uma antes de rodar `kasy new` com Firebase:',
     'doctor.requiredMissing': 'Dependencias obrigatórias ausentes. Corrija os erros acima e execute o doctor novamente.',
     'doctor.requiredPassed': '✓ Verificações obrigatórias de ambiente aprovadas.',
     'modules.backends': 'Backends disponíveis:',
@@ -196,6 +199,10 @@ module.exports = {
     'new.firebase.create.success': 'Projeto Firebase criado com sucesso.',
     'new.firebase.create.failed': 'Não foi possível criar o projeto',
     'new.firebase.create.gcloudRequired': 'gcloud CLI é obrigatório para "criar do zero". Sem ele, o fluxo completo do Firebase não pode rodar.',
+    'new.firebase.billing.required': 'Você ainda não tem uma conta de faturamento no Google Cloud. O Firebase precisa do plano Blaze para usar Storage e Cloud Functions.',
+    'new.firebase.billing.create.steps': 'Vou abrir a página de criação de conta de faturamento. Crie a conta (cartão de crédito, sem cobrança até bater a cota gratuita) e volte aqui:',
+    'new.firebase.billing.created.ready': 'Já criei a conta de faturamento, pode seguir?',
+    'new.firebase.billing.stillMissing': 'Ainda não encontrei nenhuma conta de faturamento ativa. Finalize a criação no Console e rode `kasy new` novamente.',
     'new.firebase.create.installTitle': 'Para instalar o gcloud CLI, execute:',
     'new.firebase.create.installCommand': 'Comando',
     'new.firebase.create.installAfter': 'Depois faca login',
@@ -212,6 +219,8 @@ module.exports = {
     'new.firebase.q.organization': 'Em qual organização GCP criar o projeto?',
     'new.firebase.q.organization.none': 'Sem organização (conta pessoal / projeto avulso)',
     'new.firebase.q.organization.hint': 'Organizações vinculadas à sua conta gcloud',
+    'new.firebase.create.billingWait': 'Aguardando propagação do faturamento…',
+    'new.firebase.create.billingQuotaError': 'Não foi possível vincular o faturamento (cota da conta atingida ou propagação ainda não concluída).',
     'new.firebase.create.billingRetry.title': 'Vincule o faturamento manualmente (cota excedida ou erro de billing):',
     'new.firebase.create.billingRetry.hint': 'Dica: O limite é 3 projetos por conta de faturamento. Remova projetos não usados no link acima. Se acabou de remover um, espere 2–5 min para a alteração propagar e tente novamente.',
     'new.firebase.create.billingRetry.ready': 'Vinculei o faturamento. Tentar novamente?',
@@ -233,6 +242,7 @@ module.exports = {
     'new.supabase.loginHint': 'Execute: supabase login. Depois informe a URL e chave do seu projeto existente.',
     '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).',
     'new.supabase.q.useExisting.orgSelect': 'Em qual organização está o projeto?',
     'new.supabase.q.useExisting.projectSelect': 'Qual projeto Supabase existente deseja usar?',
     'new.supabase.projectsRequired': 'Nenhum projeto encontrado nesta organização.',
@@ -273,9 +283,9 @@ module.exports = {
     'new.q.backend.supabase.desc': 'Banco SQL (PostgreSQL) com mais controle',
     'new.q.backend.api.desc': 'Você já tem seu próprio servidor',
 
-    'new.q.mode': 'Como quer configurar?',
-    'new.q.mode.quick': '⚡ Rapido — poucas perguntas, padrões inteligentes',
-    'new.q.mode.advanced': '🛠  Avançado — todas as opções e credenciais agora',
+    'new.q.mode': 'Como quer criar o app?',
+    'new.q.mode.quick': '⚡ Rápido (recomendado): tudo pronto, zero configuração',
+    'new.q.mode.advanced': '🛠  Passo a passo: escolher cada detalhe',
 
     'new.q.preset': 'Quais features incluir?',
     'new.q.preset.starter': '⚡ Starter — analytics + erros + onboarding',
@@ -288,6 +298,40 @@ module.exports = {
     'new.firebase.success.deployStep': '• Deploy do backend (de dentro da pasta do projeto):',
 
     'cli.command.deploy.description': 'Publica o servidor no Firebase ou Supabase',
+    'cli.command.configure.description': 'Configura chaves opcionais (RevenueCat, Sentry, Mixpanel...) — pode pular, lembra do que falta',
+    'configure.title': 'Configuração de chaves do app',
+    'configure.notKasyProject': 'Esta pasta não parece um projeto Kasy (não encontrei pubspec.yaml). Entre na pasta do projeto e rode novamente.',
+    'configure.alreadyFilled': 'Já configurado ({count}):',
+    'configure.toFill': 'Falta configurar ({count}):',
+    'configure.skipHint': 'Pressione Enter sem digitar nada pra pular qualquer chave. Rode `kasy configure` de novo quando tiver a credencial.',
+    'configure.skipPlaceholder': '(deixe vazio pra pular)',
+    'configure.saved': 'Salvo em {path} ({count} chave(s) preenchida(s))',
+    'configure.stillPending': 'Restam {count} chave(s) pendente(s).',
+    'configure.runAgainHint': 'Rode `kasy configure` novamente quando tiver as chaves.',
+    'configure.allDone': 'Tudo configurado! Você pode rodar o app sem pendências de credenciais.',
+    'configure.allSkipped': 'Nenhuma chave preenchida agora. Rode novamente quando estiver pronto.',
+    'configure.outroSaved': '{count} chave(s) atualizada(s) no .env',
+    'configure.outroNoChange': 'Nenhuma alteração no .env',
+    'configure.aborted': 'Cancelado. Nada foi gravado.',
+    'configure.section.appStore': 'App Store',
+    'configure.section.sentry': 'Sentry (Crash Reports)',
+    'configure.section.mixpanel': 'Mixpanel (Analytics)',
+    'configure.section.revenuecat': 'RevenueCat (Assinaturas)',
+    'configure.section.facebook': 'Facebook (Login + Ads)',
+    'configure.section.llmChat': 'AI Chat (LLM)',
+    '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.',
+    'configure.facebookNeedsAppId': 'Pra salvar credenciais do Facebook, precisa do App ID. Rode `kasy configure` novamente e preencha o App ID.',
+    'configure.noOptionalFeatures': 'Esse projeto não tem features opcionais que precisem de credenciais.',
+    'configure.statusSummary': '{filled} já configurada(s), {pending} pendente(s)',
+    'configure.alreadyDone': 'tudo certo',
+    'configure.alreadyFilledShort': 'já configurada',
+    'configure.savedEnv': '{count} chave(s) salva(s) no .env',
+    'configure.savedFnEnv': '{count} chave(s) salva(s) em functions/.env',
+    'configure.settingSecrets': 'Gravando {count} Firebase Secret(s)…',
+    'configure.savedSecrets': '{count} Firebase Secret(s) gravado(s)',
+    'configure.secretFailed': 'Não consegui gravar o secret {key}. Rode manualmente: firebase functions:secrets:set {key}',
     'cli.command.check.description': 'Confere se as notificações push estão configuradas (use --fix para corrigir)',
     'deploy.q.project': 'Firebase Project ID:',
     'deploy.q.serviceAccount': 'Caminho para o service account JSON:',
@@ -629,13 +673,20 @@ module.exports = {
     'new.outdated.upgradeNow': 'Atualizar antes de criar? (requer assinatura ativa)',
     'new.outdated.upgraded': 'kasy atualizado! Rode kasy new novamente.',
     'new.success.title': 'Projeto criado com sucesso!',
+    'new.success.featuresInstalled': 'Recursos ativados:',
     'new.success.nextSteps': 'Proximos passos:',
     'new.success.step.cd': 'Entre na pasta do projeto:',
-    'new.success.step.deploy': 'Publique o backend no Firebase:',
-    'new.success.step.run': 'Execute o app (com suas chaves configuradas):',
+    'new.success.step.deploy': 'Suba o servidor pro Firebase (banco + funções):',
+    'new.success.step.configure': 'Configure chaves opcionais quando tiver (RevenueCat, Sentry, etc.):',
+    'new.success.step.run': 'Rode o app:',
     'new.success.step.run.vscode': '(ou F5 no VS Code)',
     'new.success.step.console': 'Abra o console do backend:',
+    'new.success.step.docs': 'Documentação:',
     'new.fcm.generating': 'Gerando chave de Service Account FCM…',
+    'new.google.enabling': 'Ativando login com Google…',
+    'new.google.refreshConfigs': 'Atualizando google-services.json e GoogleService-Info.plist com Client IDs do Google…',
+    'new.google.manualHint': 'Login com Google: ative manualmente no Console (provedor Google):',
+    'new.google.manualHint.noEmail': 'Login com Google: não consegui detectar um e-mail de suporte (gcloud sem conta). Ative manualmente no Console:',
     'new.sha1.registering': 'Registrando SHA-1 para Google Sign-In (Android)…',
     'new.sha1.failed': 'SHA-1 não adicionado automaticamente: {error}',
     'new.sha1.manual': 'Adicione manualmente para o Google Sign-In funcionar no Android:',
@@ -654,7 +705,8 @@ module.exports = {
     'new.apns.warning': '⚠  Push iOS: configure a APNs Key no Firebase Console',
     'new.apns.step1': '1. Apple Developer Portal → Keys → criar APNs Key (.p8)',
     'new.apns.step2': '2. Firebase Console → Cloud Messaging → app iOS → fazer upload da APNs Key',
-    'new.firebase.create.estimatedTime': '(geralmente 3-5 min — não feche o terminal)',
+    'new.apns.hint': 'Push pra iOS (APNs Key) só funciona depois que você publicar pra iOS. Passo a passo: https://kasy.dev/docs/apns',
+    'new.firebase.create.estimatedTime': '(3-5 min — precisa de internet estável, não feche o terminal)',
     'new.internet.warning': '📶  Verifique se você está com uma internet estável — esta etapa precisa de conexão.',
 
     // run command
@@ -715,6 +767,7 @@ module.exports = {
     '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',
+    'run.log.savedTo': 'Saída completa em {path} (útil para colar em IA/assistente)',
 
     // doctor project checks
     'doctor.project.title': 'Projeto',