kasy-cli 1.5.1 → 1.5.3

package/lib/commands/new.js

@@ -69,10 +69,12 @@ function openUrl(url) {
   } catch (_) {}
 }
 const prompts = require('prompts');
+const ui = require('../utils/ui');
 const fs = require('fs-extra');
 const { createTranslator } = require('../utils/i18n');
 const { getStoredLanguage, setStoredLanguage } = require('../utils/license');
 const { promptLanguage } = require('../utils/prompts');
+const { warnIfOutdatedBeforeNew } = require('../utils/updates');
 const {
   getBaseChecks,
   getPlatformChecks,
@@ -517,6 +519,11 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
   const tr = createTranslator(language);
   const cancel = () => onCancel(tr);
 
+  // ── 1b. Version check — warn if outdated, let user decide ───────────────
+  if (!yes) {
+    await warnIfOutdatedBeforeNew(tr);
+  }
+
   // ── 2. Environment checks (non-blocking — only warnings) ────────────────
   const envChecks = [...getBaseChecks(), ...getPlatformChecks()];
   await runChecks(envChecks, tr('new.checks.environment'), {
@@ -528,6 +535,8 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
 
   printBanner(tr);
 
+  ui.intro(kleur.bold(tr('new.subtitle2')));
+
   // Whether an explicit target directory was provided by the user
   const hasExplicitDir = directory && directory !== '.';
 
@@ -547,21 +556,16 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
   // ── 3. Backend selection (support pre-selection via --backend flag) ─────
   let backend = normalizeBackend(backendHint);
   if (!backend) {
-    const { backend: selectedBackend } = await prompts(
-      {
-        type: 'select',
-        name: 'backend',
-        message: tr('new.q.backend'),
-        choices: [
-          { title: '🔥 Firebase', description: tr('new.q.backend.firebase.desc'), value: 'firebase' },
-          { title: '🟢 Supabase', description: tr('new.q.backend.supabase.desc'), value: 'supabase' },
-          { title: '🔗 API REST', description: tr('new.q.backend.api.desc'),      value: 'api' },
-        ],
-        initial: 0,
-      },
-      { onCancel: cancel }
-    );
-    backend = selectedBackend;
+    backend = await ui.select({
+      message: tr('new.q.backend'),
+      initialValue: 'firebase',
+      options: [
+        { value: 'firebase', label: '🔥 Firebase', hint: tr('new.q.backend.firebase.desc') },
+        { value: 'supabase', label: '🟢 Supabase', hint: tr('new.q.backend.supabase.desc') },
+        { value: 'api',      label: '🔗 API REST', hint: tr('new.q.backend.api.desc') },
+      ],
+      onCancel: cancel,
+    });
   } else {
     const backendLabel = { firebase: '🔥 Firebase', supabase: '🟢 Supabase', api: '🔗 API REST' }[backend] || backend;
     console.log(kleur.gray(`  Backend: ${kleur.white(backendLabel)}`));
@@ -595,65 +599,160 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
     }
   }
 
-  // ── 3c. Wizard mode — Quick (few questions) or Full (all options) ──────────
-  let isQuick = yes; // --yes implies Quick mode
-  if (!yes) {
-    const { wizardMode } = await prompts(
-      {
-        type: 'select',
-        name: 'wizardMode',
-        message: tr('new.q.mode'),
-        choices: [
-          { title: tr('new.q.mode.quick'),    value: 'quick' },
-          { title: tr('new.q.mode.advanced'), value: 'advanced' },
-        ],
-        initial: 0,
+  // ── App identity: name + bundle ID — first things first ────────────────────
+  let core;
+  if (yes) {
+    if (!hasExplicitDir) {
+      console.error(kleur.red(`\n  ✗ --yes requires an app name: kasy new MyApp --yes\n`));
+      process.exit(1);
+    }
+    const appName = path.basename(targetDir);
+    const slug = appName
+      .normalize('NFD')
+      .replace(/[̀-ͯ]/g, '')
+      .toLowerCase()
+      .replace(/[^a-z0-9]/g, '');
+    const bundleId = (slug && !/^\d/.test(slug)) ? `com.${slug}.app` : 'com.example.app';
+    core = { appName, bundleId };
+    console.log(kleur.gray(`  App:      ${kleur.white(appName)}`));
+    console.log(kleur.gray(`  Bundle:   ${kleur.white(bundleId)}`));
+  } else {
+    const appName = await ui.text({
+      message: tr('new.firebase.q.appName'),
+      placeholder: tr('new.firebase.q.appName.hint'),
+      initialValue: hasExplicitDir ? path.basename(targetDir) : '',
+      validate: (v) => (v && v.trim() ? undefined : tr('new.firebase.q.appName.required')),
+      onCancel: cancel,
+    });
+
+    const defaultBundleId = (() => {
+      const name = (appName || '').trim();
+      if (!name) return 'com.example.app';
+      const slug = name
+        .normalize('NFD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, '');
+      if (!slug || /^\d/.test(slug)) return 'com.example.app';
+      return `com.${slug}.app`;
+    })();
+
+    const bundleId = await ui.text({
+      message: tr('new.firebase.q.bundleId'),
+      placeholder: tr('new.firebase.q.bundleId.hint'),
+      initialValue: defaultBundleId,
+      validate: (v) => {
+        if (!v || !v.trim()) return tr('new.firebase.q.bundleId.required');
+        return /^[a-zA-Z][\w]*(\.[a-zA-Z][\w]*)+$/.test(v.trim())
+          ? undefined
+          : tr('new.firebase.q.bundleId.invalid');
       },
-      { onCancel: cancel }
-    );
-    isQuick = wizardMode === 'quick';
+      onCancel: cancel,
+    });
+
+    core = { appName, bundleId };
   }
 
-  // ── 4b. Firebase setup mode (create vs existing) — ask first so prereqs are correct ─
+  // Resolve targetDir now that we have the app name
+  if (!targetDir) {
+    const folderName = toPackageName(core.appName.trim());
+    targetDir = path.resolve(process.cwd(), folderName);
+    if (await fs.pathExists(targetDir)) {
+      const contents = await fs.readdir(targetDir);
+      if (contents.length > 0) {
+        throw new Error(tr('new.firebase.error.dirNotEmpty', { path: targetDir }));
+      }
+    }
+  }
+
+  // ── Firebase setup mode (create vs existing) ────────────────────────────────
   // Firebase backend: full setup. Supabase/API: Firebase only for push notifications (FCM).
   let firebaseSetupMode = 'existing';
   if (!yes) {
     if (backend === 'firebase') {
-      const { setupMode } = await prompts(
-        {
-          type: 'select',
-          name: 'setupMode',
-          message: tr('new.firebase.q.setupMode'),
-          choices: [
-            { title: tr('new.firebase.q.setupMode.create'), value: 'create' },
-            { title: tr('new.firebase.q.setupMode.existing'), value: 'existing' },
-          ],
-          initial: 0,
-        },
-        { onCancel: cancel }
-      );
-      firebaseSetupMode = setupMode;
+      firebaseSetupMode = await ui.select({
+        message: tr('new.firebase.q.setupMode'),
+        initialValue: 'create',
+        options: [
+          { value: 'create',   label: tr('new.firebase.q.setupMode.create') },
+          { value: 'existing', label: tr('new.firebase.q.setupMode.existing') },
+        ],
+        onCancel: cancel,
+      });
     } else if (backend === 'supabase' || backend === 'api') {
-      const { setupMode } = await prompts(
+      ui.note(tr('new.firebase.q.setupMode.push.explain'));
+      firebaseSetupMode = await ui.select({
+        message: tr('new.firebase.q.setupMode.push'),
+        initialValue: 'create',
+        options: [
+          { value: 'create',   label: tr('new.firebase.q.setupMode.create') },
+          { value: 'existing', label: tr('new.firebase.q.setupMode.existing') },
+        ],
+        onCancel: cancel,
+      });
+    }
+  }
+
+  // ── Wizard mode — Quick (few questions) or Full (all options) ───────────────
+  // Asked after app name + setup context are clear, so the user understands what it controls.
+  let isQuick = yes; // --yes implies Quick mode
+  if (!yes) {
+    const wizardMode = await ui.select({
+      message: tr('new.q.mode'),
+      initialValue: 'quick',
+      options: [
+        { value: 'quick',    label: tr('new.q.mode.quick') },
+        { value: 'advanced', label: tr('new.q.mode.advanced') },
+      ],
+      onCancel: cancel,
+    });
+    isQuick = wizardMode === 'quick';
+  }
+
+  // ── Backend-specific prerequisites (dynamic: only show what's not yet verified) ─
+  printPrerequisites(tr, backend, firebaseSetupMode, backendCheckResults);
+
+  // ── Firebase project ID (if using an existing project) ──────────────────────
+  if (!yes) {
+    const needFirebaseProjectId =
+      (backend === 'firebase' && firebaseSetupMode === 'existing') ||
+      ((backend === 'supabase' || backend === 'api') && firebaseSetupMode === 'existing');
+    if (needFirebaseProjectId) {
+      const firebaseProjectId = await ui.text({
+        message: tr('new.firebase.q.projectId'),
+        placeholder: tr('new.firebase.q.projectId.hint') + (backend !== 'firebase' ? ' (FCM + Remote Config)' : ''),
+        validate: (v) => {
+          if (!v || !v.trim()) return tr('new.firebase.q.projectId.required');
+          const id = v.trim();
+          if (id.length < 6 || id.length > 30) return 'ID deve ter entre 6 e 30 caracteres (ex: meu-app-123)';
+          if (!/^[a-z][a-z0-9-]*[a-z0-9]$/.test(id)) return 'ID inválido: use letras minúsculas, números e hífens, começando com letra (ex: meu-app-123)';
+          return undefined;
+        },
+        onCancel: cancel,
+      });
+      core.firebaseProjectId = firebaseProjectId;
+    }
+  } else {
+    let firebaseProjectId = projectHint?.trim() || '';
+    if (!firebaseProjectId && backend === 'firebase') {
+      const { pid } = await prompts(
         {
-          type: 'select',
-          name: 'setupMode',
-          message: tr('new.firebase.q.setupMode.push'),
-          choices: [
-            { title: tr('new.firebase.q.setupMode.create'), value: 'create' },
-            { title: tr('new.firebase.q.setupMode.existing'), value: 'existing' },
-          ],
-          initial: 0,
+          type: 'text',
+          name: 'pid',
+          message: tr('new.firebase.q.projectId'),
+          hint: tr('new.firebase.q.projectId.hint'),
+          validate: (v) => (v && v.trim() ? true : tr('new.firebase.q.projectId.required')),
         },
         { onCancel: cancel }
       );
-      firebaseSetupMode = setupMode;
+      firebaseProjectId = pid?.trim() || '';
+    }
+    if (firebaseProjectId) {
+      core.firebaseProjectId = firebaseProjectId;
+      console.log(kleur.gray(`  Project:  ${kleur.white(firebaseProjectId)}`));
     }
   }
 
-  // ── 4c. Backend-specific prerequisites (dynamic: only show what's not yet verified) ─
-  printPrerequisites(tr, backend, firebaseSetupMode, backendCheckResults);
-
   // ── Firebase region — Quick mode uses default (us-central1) ──────────
   let firebaseRegion = 'us-central1';
   if (backend === 'firebase' && !isQuick) {
@@ -674,93 +773,6 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
     firebaseRegion = region || 'us-central1';
   }
 
-  // ── Core questions (appName, bundleId) ────────────────────────────────────
-  const coreQuestions = [
-    {
-      type: 'text',
-      name: 'appName',
-      message: tr('new.firebase.q.appName'),
-      hint: tr('new.firebase.q.appName.hint'),
-      initial: hasExplicitDir ? path.basename(targetDir) : '',
-      validate: (v) => (v && v.trim() ? true : tr('new.firebase.q.appName.required')),
-    },
-    {
-      type: 'text',
-      name: 'bundleId',
-      message: tr('new.firebase.q.bundleId'),
-      hint: tr('new.firebase.q.bundleId.hint'),
-      initial: (prev, values) => {
-        const name = (values?.appName || prev || '').trim();
-        if (!name) return 'com.example.app';
-        const slug = name
-          .normalize('NFD')
-          .replace(/[\u0300-\u036f]/g, '')
-          .toLowerCase()
-          .replace(/[^a-z0-9]/g, '');
-        if (!slug || /^\d/.test(slug)) return 'com.example.app';
-        return `com.${slug}.app`;
-      },
-      validate: (v) => {
-        if (!v || !v.trim()) return tr('new.firebase.q.bundleId.required');
-        return /^[a-zA-Z][\w]*(\.[a-zA-Z][\w]*)+$/.test(v.trim())
-          ? true
-          : tr('new.firebase.q.bundleId.invalid');
-      },
-    },
-  ];
-  const needFirebaseProjectIdNow =
-    (backend === 'firebase' && firebaseSetupMode === 'existing') ||
-    ((backend === 'supabase' || backend === 'api') && firebaseSetupMode === 'existing');
-  if (needFirebaseProjectIdNow) {
-    coreQuestions.push({
-      type: 'text',
-      name: 'firebaseProjectId',
-      message: tr('new.firebase.q.projectId'),
-      hint: tr('new.firebase.q.projectId.hint') + (backend !== 'firebase' ? ' (FCM + Remote Config)' : ''),
-      validate: (v) => {
-        if (!v || !v.trim()) return tr('new.firebase.q.projectId.required');
-        const id = v.trim();
-        if (id.length < 6 || id.length > 30) return 'ID deve ter entre 6 e 30 caracteres (ex: meu-app-123)';
-        if (!/^[a-z][a-z0-9-]*[a-z0-9]$/.test(id)) return 'ID inválido: use letras minúsculas, números e hífens, começando com letra (ex: meu-app-123)';
-        return true;
-      },
-    });
-  }
-  let core;
-  if (yes) {
-    if (!hasExplicitDir) {
-      console.error(kleur.red(`\n  ✗ --yes requires an app name: kasy new MyApp --yes\n`));
-      process.exit(1);
-    }
-    const appName = path.basename(targetDir);
-    const slug = appName
-      .normalize('NFD')
-      .replace(/[\u0300-\u036f]/g, '')
-      .toLowerCase()
-      .replace(/[^a-z0-9]/g, '');
-    const bundleId = (slug && !/^\d/.test(slug)) ? `com.${slug}.app` : 'com.example.app';
-    let firebaseProjectId = projectHint?.trim() || '';
-    if (!firebaseProjectId && backend === 'firebase') {
-      const { pid } = await prompts(
-        {
-          type: 'text',
-          name: 'pid',
-          message: tr('new.firebase.q.projectId'),
-          hint: tr('new.firebase.q.projectId.hint'),
-          validate: (v) => (v && v.trim() ? true : tr('new.firebase.q.projectId.required')),
-        },
-        { onCancel: cancel }
-      );
-      firebaseProjectId = pid?.trim() || '';
-    }
-    core = { appName, bundleId, firebaseProjectId };
-    console.log(kleur.gray(`  App:      ${kleur.white(appName)}`));
-    console.log(kleur.gray(`  Bundle:   ${kleur.white(bundleId)}`));
-    if (firebaseProjectId) console.log(kleur.gray(`  Project:  ${kleur.white(firebaseProjectId)}`));
-  } else {
-    core = await prompts(coreQuestions, { onCancel: cancel });
-  }
-
   // ── Firebase: create from scratch (when selected) ─────────────────────────
   let firebaseIncludeWeb = true;
   if (backend === 'firebase' && firebaseSetupMode === 'create') {
@@ -1243,19 +1255,6 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
     Object.assign(core, api);
   }
 
-  // Resolve targetDir now that we have the app name
-  if (!targetDir) {
-    const folderName = toPackageName(core.appName.trim());
-    targetDir = path.resolve(process.cwd(), folderName);
-    // Guard: derived dir must not already exist
-    if (await fs.pathExists(targetDir)) {
-      const contents = await fs.readdir(targetDir);
-      if (contents.length > 0) {
-        throw new Error(tr('new.firebase.error.dirNotEmpty', { path: targetDir }));
-      }
-    }
-  }
-
   // ── Firebase existing project: enable APIs + create Firestore/Storage ───
   if (backend === 'firebase' && firebaseSetupMode === 'existing' && core.firebaseProjectId) {
     const ps4 = makeProgressSpinner();
@@ -1266,7 +1265,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
           ps4.next(stepProgress('enable-apis', language));
         } else if (key === 'enable-apis-warn') {
           ps4.warn(`${tr('new.firebase.create.failed')}: APIs`);
-          console.log(kleur.yellow(`  ⚠ Não foi possível ativar APIs: ${(data?.error || '').slice(0, 80)}`));
+          console.log(kleur.yellow(`  ⚠ ${tr('new.firebase.existing.apisFailed')} ${(data?.error || '').slice(0, 80)}`));
         } else if (key === 'firestore') {
           ps4.next(stepProgress('firestore', language));
         } else if (key === 'storage') {
@@ -1277,7 +1276,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
           console.log(kleur.cyan(`     ${data?.url || ''}`));
         } else if (key === 'auth-google-warn') {
           ps4.stop();
-          console.log(kleur.yellow(`  ⚠ Google Sign-In: ative manualmente em Authentication → Sign-in method → Google`));
+          console.log(kleur.yellow(`  ⚠ ${tr('new.firebase.existing.googleSignInManual')}`));
           console.log(kleur.cyan(`     ${data?.url || ''}`));
         }
       },

package/lib/commands/run.js

@@ -54,7 +54,8 @@ async function runRun(directory, options = {}) {
   const args = ['run', ...deviceArgs, ...dartDefines];
 
   console.log(kleur.bold(`\n${t('run.launching')}`));
-  console.log(kleur.dim(`  flutter ${args.join(' ')}\n`));
+  console.log(kleur.dim(`  flutter ${args.join(' ')}`));
+  console.log(kleur.dim(`  ✦ ${t('run.updateHint.prefix')} `) + kleur.cyan('kasy update') + kleur.dim(` ${t('run.updateHint.suffix')}\n`));
 
   return new Promise((resolve, reject) => {
     const proc = spawn('flutter', args, { cwd: projectDir, stdio: 'inherit' });

package/lib/utils/checks.js

@@ -144,6 +144,17 @@ function getBackendChecks(backend) {
   return [...(BACKEND_CHECKS[backend] || [])];
 }
 
+function diagnoseFailure(err) {
+  const text = `${err?.stderr || ''}\n${err?.stdout || ''}\n${err?.message || ''}`.toLowerCase();
+  if (text.includes('xcode') && text.includes('license')) {
+    return 'xcodeLicense';
+  }
+  if (text.includes('xcode-select') || text.includes('command line tools') || text.includes('no developer tools')) {
+    return 'xcodeCli';
+  }
+  return null;
+}
+
 function extractVersion(stdout, checkName) {
   const raw = (stdout || '').trim();
   if (!raw) return null;
@@ -200,7 +211,8 @@ async function runSingleCheck(check, options = {}) {
       }
     }
     return { ...check, ok: true, version: version || null };
-  } catch {
+  } catch (err) {
+    const diagnosis = diagnoseFailure(err);
     if (check.tryInstall) {
       if (!silent) spinner.text = t(check.tryInstallMessageKey || 'setup.flutterfire.installing');
       try {
@@ -242,7 +254,10 @@ async function runSingleCheck(check, options = {}) {
     if (!silent) {
       if (check.required) {
         const detail = autoInstallFailed ? ` — ${t('checks.install.failed')}` : '';
-        spinner.fail(t('checks.missing', { name: check.name }) + detail);
+        const diagSuffix = diagnosis ? `\n    ${kleur.dim(`→ ${t(`checks.diagnostic.${diagnosis}`, { name: check.name })}`)}` : '';
+        spinner.fail(t('checks.missing', { name: check.name }) + detail + diagSuffix);
+      } else if (diagnosis) {
+        spinner.warn(t(`checks.diagnostic.${diagnosis}`, { name: check.name }));
       } else {
         const hint = !check.waitPrompt && check.failHint ? `\n    ${kleur.dim(`→ ${check.failHint}`)}` : '';
         if (check.warnMessage) {
@@ -255,7 +270,7 @@ async function runSingleCheck(check, options = {}) {
       }
     }
 
-    return { ...check, ok: false, autoInstallFailed };
+    return { ...check, ok: false, autoInstallFailed, diagnosis };
   }
 }
 
@@ -293,7 +308,10 @@ async function runChecks(checks, title, options = {}) {
     const hint = result.failHint ? `\n    ${kleur.dim(`→ ${result.failHint}`)}` : '';
     if (result.required) {
       const detail = result.autoInstallFailed ? ` — ${t('checks.install.failed')}` : '';
-      console.log(kleur.red(`  ✖ ${t('checks.missing', { name: result.name })}${detail}${hint}`));
+      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}`));
+    } else if (result.diagnosis) {
+      console.log(kleur.yellow(`  ⚠ ${t(`checks.diagnostic.${result.diagnosis}`, { name: result.name })}`));
     } else if (result.warnMessage) {
       console.log(kleur.yellow(`  ⚠ ${result.warnMessage}${hint}`));
     } else if (result.warnMessageKey) {

package/lib/utils/i18n.js

@@ -96,6 +96,8 @@ const MESSAGES = {
     'checks.notFound': '{name} not found',
     'checks.flutter.warn': 'Flutter SDK not found. Install Flutter to build and run apps: https://docs.flutter.dev/get-started/install',
     'checks.install.failed': 'auto-install failed — run the command manually',
+    'checks.diagnostic.xcodeLicense': '{name} is installed, but Xcode needs the license accepted. Run: sudo xcodebuild -license',
+    'checks.diagnostic.xcodeCli': '{name} is installed, but Xcode Command Line Tools are missing. Run: xcode-select --install',
     'banner.title': 'Kasy CLI · Flutter SaaS Generator',
     'welcome.firstRun': 'Welcome to Kasy CLI!',
     'welcome.chooseLanguage': 'First, choose your language:',
@@ -132,6 +134,7 @@ const MESSAGES = {
     'new.supabase.q.create.existing': '📂 Use existing project',
     'new.firebase.q.setupMode': 'How do you want to set up Firebase?',
     'new.firebase.q.setupMode.push': 'Firebase project for push notifications (FCM):',
+    'new.firebase.q.setupMode.push.explain': 'Push notifications (FCM) require a Firebase project, even when your main backend is Supabase or API REST.',
     'new.firebase.q.setupMode.create': '✨ Create from scratch (recommended for beginners)',
     'new.firebase.q.setupMode.existing': '📂 Use existing project',
     'new.firebase.q.region': 'Where are most of your app users located?',
@@ -510,6 +513,8 @@ const MESSAGES = {
     'new.firebase.interactive.billingWaiting': 'Checking Blaze status...',
     'new.firebase.interactive.billingTimeout': 'Blaze plan not confirmed after timeout. Deploy skipped — run manually when ready.',
     'new.firebase.interactive.authWarn': 'Could not enable Email/Password and Anonymous auth automatically. Enable manually:',
+    'new.firebase.existing.apisFailed': 'Could not activate APIs:',
+    'new.firebase.existing.googleSignInManual': 'Google Sign-In: enable manually in Authentication → Sign-in method → Google',
 
     'new.firebase.interactive.ready': 'Ready to deploy Push Notifications + Security Rules now?',
     'new.firebase.interactive.deploying': 'Deploying Cloud Functions + Firestore/Storage rules...',
@@ -548,6 +553,9 @@ const MESSAGES = {
     'new.api.success.fcm': '• Firebase is required for push notifications (FCM) — configure APNs key in Firebase console',
     'new.api.success.auth': '• Implement the social auth endpoints (Google, Apple) on your backend',
 
+    'new.outdated.hint': "projects created now won't include the latest improvements.",
+    '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.nextSteps': 'Next steps:',
     'new.success.step.cd': 'Go to your project folder:',
@@ -580,6 +588,8 @@ const MESSAGES = {
     // run command
     'cli.command.run.description': '▶ Run the Flutter app using .env (launch.json dart-defines fallback)',
     'run.launching': 'Launching Flutter app...',
+    'run.updateHint.prefix': 'Project improvements available —',
+    'run.updateHint.suffix': 'to see what\'s new',
     'run.error.notFlutterProject': 'No pubspec.yaml found. Run this command from inside a Flutter project.',
     'run.error.flutterNotFound': 'Flutter not found. Make sure Flutter is installed and on your PATH.',
 
@@ -811,6 +821,8 @@ const MESSAGES = {
     'checks.notFound': '{name} nao encontrado',
     'checks.flutter.warn': 'Flutter SDK nao encontrado. Instale o Flutter para compilar e executar apps: https://docs.flutter.dev/get-started/install',
     'checks.install.failed': 'instalacao automatica falhou — execute o comando manualmente',
+    'checks.diagnostic.xcodeLicense': '{name} esta instalado, mas o Xcode precisa que a licenca seja aceita. Execute: sudo xcodebuild -license',
+    'checks.diagnostic.xcodeCli': '{name} esta instalado, mas faltam as Command Line Tools do Xcode. Execute: xcode-select --install',
     'banner.title': 'Kasy CLI · Gerador Flutter SaaS',
     'welcome.firstRun': 'Bem-vindo ao Kasy CLI!',
     'welcome.chooseLanguage': 'Primeiro, escolha seu idioma:',
@@ -847,6 +859,7 @@ const MESSAGES = {
     'new.supabase.q.create.existing': '📂 Usar projeto existente',
     'new.firebase.q.setupMode': 'Como deseja configurar o Firebase?',
     'new.firebase.q.setupMode.push': 'Projeto Firebase para notificações push (FCM):',
+    'new.firebase.q.setupMode.push.explain': 'Notificações push (FCM) precisam de um projeto Firebase, mesmo quando seu backend principal é Supabase ou API REST.',
     'new.firebase.q.setupMode.create': '✨ Criar do zero (recomendado para iniciantes)',
     'new.firebase.q.setupMode.existing': '📂 Usar projeto existente',
     'new.firebase.q.region': 'Onde está a maioria dos usuários do seu app?',
@@ -1225,6 +1238,8 @@ const MESSAGES = {
     'new.firebase.interactive.billingWaiting': 'Verificando status do Blaze...',
     'new.firebase.interactive.billingTimeout': 'Plano Blaze nao confirmado apos o tempo limite. Deploy ignorado — rode manualmente quando estiver pronto.',
     'new.firebase.interactive.authWarn': 'Nao foi possivel ativar Email/Senha e Anonimo automaticamente. Ative manualmente:',
+    'new.firebase.existing.apisFailed': 'Nao foi possivel ativar APIs:',
+    'new.firebase.existing.googleSignInManual': 'Google Sign-In: ative manualmente em Authentication → Sign-in method → Google',
 
     'new.firebase.interactive.ready': 'Pronto para publicar Push Notifications + Regras agora?',
     'new.firebase.interactive.deploying': 'Fazendo deploy das Cloud Functions + Regras (Storage e Firestore)...',
@@ -1263,6 +1278,9 @@ const MESSAGES = {
     'new.api.success.fcm': '• Firebase e necessario para notificacoes push (FCM) — configure a chave APNs no console do Firebase',
     'new.api.success.auth': '• Implemente os endpoints de auth social (Google, Apple) no seu backend',
 
+    'new.outdated.hint': 'projetos criados agora não terão as últimas melhorias.',
+    '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.nextSteps': 'Proximos passos:',
     'new.success.step.cd': 'Entre na pasta do projeto:',
@@ -1295,6 +1313,8 @@ const MESSAGES = {
     // run command
     'cli.command.run.description': '▶ Executa o app Flutter usando .env (fallback para dart-defines do launch.json)',
     'run.launching': 'Iniciando app Flutter...',
+    'run.updateHint.prefix': 'Melhorias disponíveis para o projeto —',
+    'run.updateHint.suffix': 'para ver o que há de novo',
     'run.error.notFlutterProject': 'Nenhum pubspec.yaml encontrado. Execute este comando dentro de um projeto Flutter.',
     'run.error.flutterNotFound': 'Flutter nao encontrado. Verifique se o Flutter esta instalado e no PATH.',
 
@@ -1526,6 +1546,8 @@ const MESSAGES = {
     'checks.notFound': '{name} no encontrado',
     'checks.flutter.warn': 'Flutter SDK no encontrado. Instala Flutter para compilar y ejecutar apps: https://docs.flutter.dev/get-started/install',
     'checks.install.failed': 'instalación automática falló — ejecuta el comando manualmente',
+    'checks.diagnostic.xcodeLicense': '{name} está instalado, pero Xcode necesita que aceptes la licencia. Ejecuta: sudo xcodebuild -license',
+    'checks.diagnostic.xcodeCli': '{name} está instalado, pero faltan las Command Line Tools de Xcode. Ejecuta: xcode-select --install',
     'banner.title': 'Kasy CLI · Generador Flutter SaaS',
     'welcome.firstRun': '¡Bienvenido a Kasy CLI!',
     'welcome.chooseLanguage': 'Primero, elige tu idioma:',
@@ -1562,6 +1584,7 @@ const MESSAGES = {
     'new.supabase.q.create.existing': '📂 Usar proyecto existente',
     'new.firebase.q.setupMode': '¿Cómo quieres configurar Firebase?',
     'new.firebase.q.setupMode.push': 'Proyecto Firebase para notificaciones push (FCM):',
+    'new.firebase.q.setupMode.push.explain': 'Las notificaciones push (FCM) requieren un proyecto Firebase, incluso cuando tu backend principal es Supabase o API REST.',
     'new.firebase.q.setupMode.create': '✨ Crear desde cero (recomendado para principiantes)',
     'new.firebase.q.setupMode.existing': '📂 Usar proyecto existente',
     'new.firebase.q.region': '¿Dónde están la mayoría de los usuarios de tu app?',
@@ -1940,6 +1963,8 @@ const MESSAGES = {
     'new.firebase.interactive.billingWaiting': 'Verificando estado del Blaze...',
     'new.firebase.interactive.billingTimeout': 'Plan Blaze no confirmado tras el tiempo límite. Despliegue omitido — ejecuta manualmente cuando estés listo.',
     'new.firebase.interactive.authWarn': 'No se pudo activar Email/Contraseña y Anónimo automáticamente. Actívalos manualmente:',
+    'new.firebase.existing.apisFailed': 'No se pudieron activar las APIs:',
+    'new.firebase.existing.googleSignInManual': 'Google Sign-In: activa manualmente en Authentication → Sign-in method → Google',
 
     'new.firebase.interactive.ready': '¿Listo para publicar Push Notifications + Reglas ahora?',
     'new.firebase.interactive.deploying': 'Desplegando Cloud Functions + Reglas (Storage y Firestore)...',
@@ -1978,6 +2003,9 @@ const MESSAGES = {
     'new.api.success.fcm': '• Firebase es necesario para notificaciones push (FCM) — configura la clave APNs en la consola de Firebase',
     'new.api.success.auth': '• Implementa los endpoints de auth social (Google, Apple) en tu backend',
 
+    'new.outdated.hint': 'los proyectos creados ahora no tendrán las últimas mejoras.',
+    '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.nextSteps': 'Proximos pasos:',
     'new.success.step.cd': 'Ve a la carpeta del proyecto:',
@@ -2010,6 +2038,8 @@ const MESSAGES = {
     // run command
     'cli.command.run.description': '▶ Ejecuta el app Flutter usando .env (fallback a dart-defines del launch.json)',
     'run.launching': 'Iniciando app Flutter...',
+    'run.updateHint.prefix': 'Mejoras disponibles para el proyecto —',
+    'run.updateHint.suffix': 'para ver las novedades',
     'run.error.notFlutterProject': 'No se encontro pubspec.yaml. Ejecuta este comando dentro de un proyecto Flutter.',
     'run.error.flutterNotFound': 'Flutter no encontrado. Verifica que Flutter este instalado y en el PATH.',
 

package/lib/utils/ui.js

@@ -0,0 +1,82 @@
+/**
+ * UI wrapper around @clack/prompts.
+ *
+ * Goal: centralize prompt/styling primitives so commands don't import
+ * `@clack/prompts` directly. This keeps the migration from the legacy
+ * `prompts` package incremental — commands can adopt this module one
+ * by one without touching the rest.
+ *
+ * Cancel handling: every prompt auto-detects Ctrl+C via `isCancel`
+ * and calls the optional `onCancel` callback (or exits with code 0
+ * and a friendly message). Callers don't need to wire `onCancel`
+ * in each call like they did with the old `prompts` library.
+ */
+
+const clack = require('@clack/prompts');
+
+function handleCancel(result, onCancel) {
+  if (clack.isCancel(result)) {
+    if (typeof onCancel === 'function') {
+      onCancel();
+    } else {
+      clack.cancel('Operação cancelada.');
+    }
+    process.exit(0);
+  }
+  return result;
+}
+
+async function select({ message, options, initialValue, onCancel }) {
+  const result = await clack.select({ message, options, initialValue });
+  return handleCancel(result, onCancel);
+}
+
+async function text({ message, placeholder, initialValue, defaultValue, validate, onCancel }) {
+  const result = await clack.text({
+    message,
+    placeholder,
+    initialValue,
+    defaultValue,
+    validate: validate
+      ? (value) => {
+          const out = validate(value);
+          if (out === true || out == null) return undefined;
+          return out;
+        }
+      : undefined,
+  });
+  return handleCancel(result, onCancel);
+}
+
+async function confirm({ message, initialValue = true, onCancel }) {
+  const result = await clack.confirm({ message, initialValue });
+  return handleCancel(result, onCancel);
+}
+
+async function multiselect({ message, options, initialValues, required = false, onCancel }) {
+  const result = await clack.multiselect({ message, options, initialValues, required });
+  return handleCancel(result, onCancel);
+}
+
+function intro(title) { clack.intro(title); }
+function outro(message) { clack.outro(message); }
+function note(message, title) { clack.note(message, title); }
+function cancel(message) { clack.cancel(message); }
+
+function spinner() { return clack.spinner(); }
+
+const log = clack.log;
+
+module.exports = {
+  select,
+  text,
+  confirm,
+  multiselect,
+  intro,
+  outro,
+  note,
+  cancel,
+  spinner,
+  log,
+  isCancel: clack.isCancel,
+};

package/lib/utils/updates.js

@@ -4,6 +4,7 @@ const https = require('node:https');
 const path = require('node:path');
 const { existsSync, readJsonSync, writeJsonSync, ensureDirSync } = require('fs-extra');
 const kleur = require('kleur');
+const prompts = require('prompts');
 const pkg = require('../../package.json');
 const { CONFIG_PATH } = require('./license');
 
@@ -94,4 +95,40 @@ async function checkForUpdates() {
   }
 }
 
-module.exports = { checkForUpdates };
+/**
+ * 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.
+ */
+async function warnIfOutdatedBeforeNew(t) {
+  try {
+    const cache = (readConfig().updateCheck) || {};
+    if (!cache.latestVersion || !isNewer(cache.latestVersion, pkg.version)) return;
+
+    const hint = t ? t('new.outdated.hint') : 'projetos criados agora não terão as últimas melhorias.';
+    console.log('');
+    console.log(
+      kleur.bgYellow().black(' UPDATE ') + '  ' +
+      kleur.bold(`v${cache.latestVersion} disponível`) +
+      kleur.dim(`  — ${hint}`)
+    );
+    console.log('');
+
+    const { upgrade } = await prompts({
+      type: 'confirm',
+      name: 'upgrade',
+      message: t ? t('new.outdated.upgradeNow') : 'Atualizar antes de criar? (requer assinatura ativa)',
+      initial: false,
+    });
+
+    if (upgrade) {
+      const { spawnSync } = require('node:child_process');
+      const result = spawnSync('kasy', ['upgrade'], { stdio: 'inherit', shell: true });
+      process.exit(result.status ?? 0);
+    }
+  } catch {
+    // Nunca travar o kasy new por causa do aviso de versão
+  }
+}
+
+module.exports = { checkForUpdates, warnIfOutdatedBeforeNew };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"
@@ -44,6 +44,7 @@
     "test:localize-docs": "node ./test/localize-release-docs.test.js"
   },
   "dependencies": {
+    "@clack/prompts": "^1.4.0",
     "commander": "^12.0.0",
     "fs-extra": "^11.2.0",
     "gradient-string": "^1.2.0",