kasy-cli 1.13.0 → 1.14.0

package/bin/kasy.js

@@ -10,12 +10,15 @@ const { runValidate } = require('../lib/commands/validate');
 const { runDeployCommand } = require('../lib/commands/deploy');
 const { runCheck } = require('../lib/commands/check');
 const { runRun } = require('../lib/commands/run');
+const { runReset } = require('../lib/commands/reset');
 const { runAdd } = require('../lib/commands/add');
 const { runRemove } = require('../lib/commands/remove');
 const { runUpdate } = require('../lib/commands/update');
 const { runDocs } = require('../lib/commands/docs');
 const { runNotificationsText } = require('../lib/commands/notifications');
 const { runSplash } = require('../lib/commands/splash');
+const { runIcon } = require('../lib/commands/icon');
+const { runFavicon } = require('../lib/commands/favicon');
 const {
   runConfigure: runIosConfigure,
   runBuild: runIosBuild,
@@ -37,6 +40,7 @@ const { promptLanguage } = require('../lib/utils/prompts');
 const { ensureLicenseKey, shouldRequireLicenseForArgv } = require('../lib/utils/license-gate');
 const { checkForUpdates } = require('../lib/utils/updates');
 const { printCompactHeader } = require('../lib/utils/brand');
+const ui = require('../lib/utils/ui');
 
 function createLocalizedHelpConfig(t) {
   return {
@@ -131,11 +135,15 @@ function createLocalizedHelpConfig(t) {
           // Group root commands by intent for easier scanning by non-devs.
           const groups = [
             { id: 'start',       ids: ['new', 'doctor', 'features'] },
-            { id: 'work',        ids: ['add', 'remove', 'update', 'run'] },
+            { id: 'work',        ids: ['add', 'remove', 'update', 'run', 'reset', 'splash', 'icon', 'favicon', 'notifications'] },
             { id: 'publish',     ids: ['deploy', 'check', 'ios', 'codemagic'] },
-            { id: 'maintenance', ids: ['upgrade', 'version', 'uninstall', 'docs', 'notifications'] },
+            { id: 'maintenance', ids: ['upgrade', 'version', 'uninstall', 'docs'] },
             { id: 'advanced',    ids: ['setup', 'validate'] },
           ];
+          // Commander auto-generates a `help` subcommand. Hide it from the
+          // "Other" section — the tip line at the bottom already teaches users
+          // how to get per-command help.
+          const HIDDEN_FROM_OTHER = new Set(['help']);
           const knownIds = new Set(groups.flatMap((g) => g.ids));
           const byName = new Map(visibleCommands.map((c) => [c.name(), c]));
           for (const group of groups) {
@@ -157,7 +165,7 @@ function createLocalizedHelpConfig(t) {
             ]);
           }
           const otherItems = visibleCommands
-            .filter((c) => !knownIds.has(c.name()))
+            .filter((c) => !knownIds.has(c.name()) && !HIDDEN_FROM_OTHER.has(c.name()))
             .map((sub) =>
               formatItem(
                 localizeSubcommandTerm(helper.subcommandTerm(sub)),
@@ -221,7 +229,7 @@ function buildProgram(language) {
   program.addHelpText('beforeAll', `${kleur.bold().cyan(t('cli.tagline'))}\n`);
   program.addHelpText(
     'after',
-    `\n${t('cli.help.quickStart')} ${kleur.cyan('kasy new')}\n\n${t('cli.help.more', { command: kleur.cyan(`kasy help <${helpParam}>`) })}\n`
+    `${t('cli.help.quickStart')} ${kleur.cyan('kasy new')}\n`
   );
 
   applyLocalizedHelp(
@@ -343,6 +351,22 @@ function buildProgram(language) {
     t
   );
 
+  applyLocalizedHelp(
+    program
+      .command('reset')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .option('--ios', 'Reset on iOS simulator/device only')
+      .option('--android', 'Reset on Android emulator/device only')
+      .option('--web', 'Show web reset instructions only')
+      .option('-d, --device <id>', 'Reset specific device ID')
+      .option('--no-reinstall', 'Only uninstall, skip reinstall')
+      .description(t('cli.command.reset.description'))
+      .action(async (directory, options) => {
+        await runReset(directory, { language, ...options });
+      }),
+    t
+  );
+
   applyLocalizedHelp(
     program
       .command('add')
@@ -422,7 +446,27 @@ function buildProgram(language) {
     t
   );
 
-  const iosCmd = program.command('ios').description(t('cli.command.ios.description'));
+  const iosCmd = program
+    .command('ios')
+    .description(t('cli.command.ios.description'))
+    .addHelpText('before', `\n${t('cli.command.ios.help.before')}`)
+    .action(async () => {
+      printCompactHeader(t);
+      ui.intro(kleur.cyan(t('cli.command.ios.picker.intro')));
+      const sub = await ui.select({
+        message: t('cli.command.ios.picker.message'),
+        options: [
+          { value: 'configure', label: t('cli.command.ios.configure.description') },
+          { value: 'release',   label: t('cli.command.ios.release.description') },
+          { value: 'build',     label: t('cli.command.ios.build.description') },
+          { value: 'clean',     label: t('cli.command.ios.clean.description') },
+        ],
+      });
+      if (sub === 'configure') await runIosConfigure('.', { language });
+      else if (sub === 'release') await runIosRelease('.', { language });
+      else if (sub === 'build') await runIosBuild('.', { language });
+      else if (sub === 'clean') await runIosClean('.', { language });
+    });
   applyLocalizedHelp(
     iosCmd
       .command('configure')
@@ -468,7 +512,31 @@ function buildProgram(language) {
     t
   );
 
-  const codemagicCmd = program.command('codemagic').description(t('cli.command.codemagic.description'));
+  const codemagicCmd = program
+    .command('codemagic')
+    .description(t('cli.command.codemagic.description'))
+    .addHelpText('before', `\n${t('cli.command.codemagic.help.before')}`)
+    .action(async () => {
+      printCompactHeader(t);
+      ui.intro(kleur.cyan(t('cli.command.codemagic.picker.intro')));
+      const sub = await ui.select({
+        message: t('cli.command.codemagic.picker.message'),
+        options: [
+          { value: 'configure', label: t('cli.command.codemagic.configure.description') },
+          { value: 'release',   label: t('cli.command.codemagic.release.description') },
+          { value: 'status',    label: t('cli.command.codemagic.status.description'), hint: t('cli.command.codemagic.picker.statusHint') },
+        ],
+      });
+      if (sub === 'configure') await runCodemagicConfigure('.', { language });
+      else if (sub === 'release') await runCodemagicRelease('.', { language });
+      else if (sub === 'status') {
+        const buildId = await ui.text({
+          message: 'Build ID',
+          validate: (v) => (v && v.trim() ? undefined : 'Build ID is required'),
+        });
+        await runCodemagicStatus(buildId?.trim(), '.', { language });
+      }
+    });
   applyLocalizedHelp(
     codemagicCmd
       .command('configure')
@@ -531,9 +599,56 @@ function buildProgram(language) {
     t
   );
 
+  applyLocalizedHelp(
+    program
+      .command('icon')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .requiredOption('--image <path>', 'PNG with the app icon (square, 1024x1024 recommended)')
+      .option('--skip-generate', 'Only copy file, do not run flutter_launcher_icons', false)
+      .description(t('cli.command.icon.description'))
+      .action(async (directory, options) => {
+        const dir = directory || '.';
+        await runIcon(dir, {
+          language,
+          image: options.image,
+          skipGenerate: options.skipGenerate,
+        });
+      }),
+    t
+  );
+
+  applyLocalizedHelp(
+    program
+      .command('favicon')
+      .argument('[directory]', 'Project folder (default: current directory)', '.')
+      .requiredOption('--image <path>', 'PNG with the web favicon / PWA icon (square, 512x512+ recommended)')
+      .option('--skip-generate', 'Only copy file, do not run flutter_launcher_icons', false)
+      .description(t('cli.command.favicon.description'))
+      .action(async (directory, options) => {
+        const dir = directory || '.';
+        await runFavicon(dir, {
+          language,
+          image: options.image,
+          skipGenerate: options.skipGenerate,
+        });
+      }),
+    t
+  );
+
   const notificationsCmd = program
     .command('notifications')
-    .description(t('cli.command.notifications.description'));
+    .description(t('cli.command.notifications.description'))
+    .action(async () => {
+      printCompactHeader(t);
+      ui.intro(kleur.cyan(t('cli.command.notifications.picker.intro')));
+      const sub = await ui.select({
+        message: t('cli.command.notifications.picker.message'),
+        options: [
+          { value: 'text', label: t('cli.command.notifications.text.description') },
+        ],
+      });
+      if (sub === 'text') await runNotificationsText('.', { language, directory: '.', lang: 'all' });
+    });
   applyLocalizedHelp(
     notificationsCmd
       .command('text')

package/lib/commands/add.js

@@ -460,7 +460,7 @@ async function postAddLlmChat(projectDir, kitSetup, answers, t) {
   // 3. Deploy the LLM function automatically
   if (backend === 'api') return { deployOk: false, deployAttempted: false };
 
-  const deploySpinner = ui.spinner();
+  const deploySpinner = ui.timedSpinner();
   deploySpinner.start(t('add.llm_chat.deploying'));
   try {
     if (backend === 'firebase') {
@@ -761,7 +761,7 @@ async function runAdd(module, options = {}) {
   // 11. build_runner (only when needed: features with codegen)
   const needsBuildRunner = ['revenuecat', 'analytics', 'sentry', 'onboarding', 'llm_chat', 'feedback'].includes(normalized);
   if (needsBuildRunner) {
-    const spinner = ui.spinner();
+    const spinner = ui.timedSpinner();
     spinner.start(t('add.buildRunner'));
     try {
       await execAsync('dart run build_runner build --delete-conflicting-outputs', { cwd: projectDir, timeout: 600_000 });

package/lib/commands/codemagic.js

@@ -107,8 +107,11 @@ async function runRelease(directory, options = {}) {
   printCompactHeader(t);
   ui.intro(t('codemagic.release.title'));
 
+  const spinner = ui.spinner();
+  spinner.start(t('codemagic.release.spin'));
   try {
     const result = await triggerBuild(projectDir, validation.env);
+    spinner.stop(t('codemagic.release.spinDone'));
     const buildId = result.buildId || result._id;
     if (buildId) {
       ui.log.success(t('codemagic.release.triggered'));
@@ -119,7 +122,7 @@ async function runRelease(directory, options = {}) {
       ui.outro(t('codemagic.release.triggered'));
     }
   } catch (err) {
-    ui.log.error(err.message);
+    spinner.stop(err.message, 2);
     process.exitCode = 1;
   }
 }
@@ -145,14 +148,18 @@ async function runStatus(buildId, directory, options = {}) {
     return;
   }
 
+  printCompactHeader(t);
+  ui.intro(`${t('codemagic.status.title')}: ${buildId}`);
+
+  const spinner = ui.spinner();
+  spinner.start(t('codemagic.status.spin'));
   try {
     const result = await getBuildStatus(buildId, validation.env.CODEMAGIC_API_TOKEN);
-    printCompactHeader(t);
-    ui.intro(`${t('codemagic.status.title')}: ${buildId}`);
+    spinner.stop(t('codemagic.status.spinDone'));
     ui.note(JSON.stringify(result, null, 2));
     ui.outro('');
   } catch (err) {
-    ui.log.error(err.message);
+    spinner.stop(err.message, 2);
     process.exitCode = 1;
   }
 }

package/lib/commands/deploy.js

@@ -122,7 +122,7 @@ async function deployFirebase(projectDir, options, tr) {
     }
   }
 
-  const spinner = ui.spinner();
+  const spinner = ui.timedSpinner();
   spinner.start(tr('deploy.firebase.spin'));
   let steps;
   try {
@@ -173,7 +173,7 @@ async function deploySupabase(projectDir, tr) {
     const firebaseProjectId = await readFirebaseProjectId(projectDir);
 
     if (firebaseProjectId) {
-      const fcmSpinner = ui.spinner();
+      const fcmSpinner = ui.timedSpinner();
       fcmSpinner.start(tr('deploy.supabase.sakSpin'));
       const fcmResult = await createFcmServiceAccountKey(firebaseProjectId);
       fcmSpinner.stop(tr('deploy.supabase.sakSpinDone'));
@@ -194,7 +194,7 @@ async function deploySupabase(projectDir, tr) {
   }
 
   // ── 3. Deploy edge functions ────────────────────────────────────────────
-  const fnSpinner = ui.spinner();
+  const fnSpinner = ui.timedSpinner();
   fnSpinner.start(tr('deploy.supabase.fnSpin'));
   const fnResult = await deployFunctions(projectDir);
   fnSpinner.stop(tr('deploy.supabase.fnSpinDone'));

package/lib/commands/favicon.js

@@ -0,0 +1,115 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const kleur = require('kleur');
+const ui = require('../utils/ui');
+const { printCompactHeader } = require('../utils/brand');
+const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
+const { inspectPng } = require('./splash');
+const { runFlutterLauncherIcons } = require('./icon');
+
+const ASSETS_DIR = path.join('assets', 'images');
+const FAVICON_NAME = 'favicon.png';
+
+async function assertKasyProject(projectDir, t) {
+  const kitSetupPath = path.join(projectDir, 'kit_setup.json');
+  const pubspecPath = path.join(projectDir, 'pubspec.yaml');
+  if (!(await fs.pathExists(kitSetupPath)) && !(await fs.pathExists(pubspecPath))) {
+    throw new Error(t('favicon.error.notKasyProject'));
+  }
+  const assetsDir = path.join(projectDir, ASSETS_DIR);
+  await fs.ensureDir(assetsDir);
+}
+
+function resolveInputPath(flagValue) {
+  if (!flagValue) return null;
+  const expanded = flagValue.startsWith('~')
+    ? path.join(require('node:os').homedir(), flagValue.slice(1))
+    : flagValue;
+  return path.resolve(expanded);
+}
+
+async function runFavicon(projectDir, options = {}) {
+  const language = options.language || detectDefaultLanguage();
+  const t = createTranslator(language);
+
+  printCompactHeader();
+  ui.intro(kleur.bold().cyan(t('favicon.intro')));
+
+  await assertKasyProject(projectDir, t);
+
+  const imagePath = resolveInputPath(options.image);
+
+  if (!imagePath) {
+    ui.log.error(t('favicon.error.imageRequired'));
+    ui.log.message(kleur.dim('kasy favicon --image <favicon.png>'));
+    process.exit(1);
+  }
+
+  if (!(await fs.pathExists(imagePath))) {
+    ui.log.error(t('favicon.error.fileNotFound', { path: imagePath }));
+    process.exit(1);
+  }
+
+  const inspectSpinner = ui.spinner();
+  inspectSpinner.start(t('favicon.validating'));
+
+  let info;
+  try {
+    info = await inspectPng(imagePath);
+  } catch (err) {
+    inspectSpinner.stop(`✖ ${err.message || t('favicon.error.notPng')}`);
+    process.exit(1);
+  }
+
+  if (!info.valid) {
+    inspectSpinner.stop(`✖ ${t('favicon.error.notPng')}`);
+    process.exit(1);
+  }
+
+  inspectSpinner.stop(t('favicon.validated'));
+
+  const warnings = [];
+  if (info.width !== info.height) {
+    warnings.push(t('favicon.warn.notSquare', { w: info.width, h: info.height }));
+  }
+  if (info.width < 512 || info.height < 512) {
+    warnings.push(t('favicon.warn.small', { w: info.width, h: info.height }));
+  }
+  if (warnings.length > 0) {
+    ui.note(warnings.map((w) => `${kleur.yellow('⚠')} ${w}`).join('\n'), t('favicon.warn.title'));
+  }
+
+  const dest = path.join(projectDir, ASSETS_DIR, FAVICON_NAME);
+
+  const copySpinner = ui.spinner();
+  copySpinner.start(t('favicon.copying'));
+  await fs.copy(imagePath, dest, { overwrite: true });
+  copySpinner.stop(t('favicon.copied'));
+
+  if (options.skipGenerate) {
+    ui.note(t('favicon.skipGenerate.hint'), t('favicon.skipGenerate.title'));
+    ui.outro(t('favicon.done'));
+    return;
+  }
+
+  const genSpinner = ui.spinner();
+  genSpinner.start(t('favicon.generating'));
+  const result = await runFlutterLauncherIcons(projectDir);
+  if (result.ok) {
+    genSpinner.stop(t('favicon.generated'));
+  } else {
+    genSpinner.stop(`⚠ ${t('favicon.error.generateFailed')}`);
+    if (result.stderr) {
+      ui.log.message(kleur.dim(result.stderr.split('\n').slice(0, 8).join('\n')));
+    }
+    ui.log.message(kleur.dim('dart run flutter_launcher_icons'));
+    process.exit(1);
+  }
+
+  const summary = `${kleur.bold(t('favicon.summary.favicon'))}: ${kleur.white(FAVICON_NAME)} (${info.width}x${info.height})`;
+  ui.note(summary, t('favicon.summary.title'));
+
+  ui.outro(t('favicon.done'));
+}
+
+module.exports = { runFavicon };

package/lib/commands/icon.js

@@ -0,0 +1,143 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const { exec } = require('node:child_process');
+const { promisify } = require('node:util');
+const kleur = require('kleur');
+const ui = require('../utils/ui');
+const { printCompactHeader } = require('../utils/brand');
+const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
+const { inspectPng } = require('./splash');
+
+const execAsync = promisify(exec);
+
+const ASSETS_DIR = path.join('assets', 'images');
+const ICON_NAME = 'icon.png';
+
+async function assertKasyProject(projectDir, t) {
+  const kitSetupPath = path.join(projectDir, 'kit_setup.json');
+  const pubspecPath = path.join(projectDir, 'pubspec.yaml');
+  if (!(await fs.pathExists(kitSetupPath)) && !(await fs.pathExists(pubspecPath))) {
+    throw new Error(t('icon.error.notKasyProject'));
+  }
+  const assetsDir = path.join(projectDir, ASSETS_DIR);
+  await fs.ensureDir(assetsDir);
+}
+
+function resolveInputPath(flagValue) {
+  if (!flagValue) return null;
+  const expanded = flagValue.startsWith('~')
+    ? path.join(require('node:os').homedir(), flagValue.slice(1))
+    : flagValue;
+  return path.resolve(expanded);
+}
+
+async function runIcon(projectDir, options = {}) {
+  const language = options.language || detectDefaultLanguage();
+  const t = createTranslator(language);
+
+  printCompactHeader();
+  ui.intro(kleur.bold().cyan(t('icon.intro')));
+
+  await assertKasyProject(projectDir, t);
+
+  const imagePath = resolveInputPath(options.image);
+
+  if (!imagePath) {
+    ui.log.error(t('icon.error.imageRequired'));
+    ui.log.message(kleur.dim('kasy icon --image <icon.png>'));
+    process.exit(1);
+  }
+
+  if (!(await fs.pathExists(imagePath))) {
+    ui.log.error(t('icon.error.fileNotFound', { path: imagePath }));
+    process.exit(1);
+  }
+
+  const inspectSpinner = ui.spinner();
+  inspectSpinner.start(t('icon.validating'));
+
+  let info;
+  try {
+    info = await inspectPng(imagePath);
+  } catch (err) {
+    inspectSpinner.stop(`✖ ${err.message || t('icon.error.notPng')}`);
+    process.exit(1);
+  }
+
+  if (!info.valid) {
+    inspectSpinner.stop(`✖ ${t('icon.error.notPng')}`);
+    process.exit(1);
+  }
+
+  inspectSpinner.stop(t('icon.validated'));
+
+  const warnings = [];
+  if (info.width !== info.height) {
+    warnings.push(t('icon.warn.notSquare', { w: info.width, h: info.height }));
+  }
+  if (info.width < 1024 || info.height < 1024) {
+    warnings.push(t('icon.warn.small', { w: info.width, h: info.height }));
+  }
+  if (info.hasAlpha) {
+    warnings.push(t('icon.warn.hasAlpha'));
+  }
+  if (warnings.length > 0) {
+    ui.note(warnings.map((w) => `${kleur.yellow('⚠')} ${w}`).join('\n'), t('icon.warn.title'));
+  }
+
+  const dest = path.join(projectDir, ASSETS_DIR, ICON_NAME);
+
+  const copySpinner = ui.spinner();
+  copySpinner.start(t('icon.copying'));
+  await fs.copy(imagePath, dest, { overwrite: true });
+  copySpinner.stop(t('icon.copied'));
+
+  if (options.skipGenerate) {
+    ui.note(t('icon.skipGenerate.hint'), t('icon.skipGenerate.title'));
+    ui.outro(t('icon.done'));
+    return;
+  }
+
+  const genSpinner = ui.spinner();
+  genSpinner.start(t('icon.generating'));
+  const result = await runFlutterLauncherIcons(projectDir);
+  if (result.ok) {
+    genSpinner.stop(t('icon.generated'));
+  } else {
+    genSpinner.stop(`⚠ ${t('icon.error.generateFailed')}`);
+    if (result.stderr) {
+      ui.log.message(kleur.dim(result.stderr.split('\n').slice(0, 8).join('\n')));
+    }
+    ui.log.message(kleur.dim('dart run flutter_launcher_icons'));
+    process.exit(1);
+  }
+
+  const summary = `${kleur.bold(t('icon.summary.icon'))}: ${kleur.white(ICON_NAME)} (${info.width}x${info.height})`;
+  ui.note(summary, t('icon.summary.title'));
+  ui.note(t('icon.reinstall.hint'), t('icon.reinstall.title'));
+
+  ui.outro(t('icon.done'));
+}
+
+async function runFlutterLauncherIcons(projectDir) {
+  try {
+    const { stdout, stderr } = await execAsync(
+      'dart run flutter_launcher_icons',
+      {
+        cwd: projectDir,
+        maxBuffer: 16 * 1024 * 1024,
+        timeout: 240_000,
+      },
+    );
+    return { ok: true, stdout, stderr };
+  } catch (err) {
+    return {
+      ok: false,
+      error: err.message,
+      stdout: err.stdout || '',
+      stderr: err.stderr || '',
+    };
+  }
+}
+
+module.exports = { runIcon, runFlutterLauncherIcons };

package/lib/commands/ios.js

@@ -52,6 +52,8 @@ async function runConfigure(directory, options = {}) {
   openUrl(URL_APP_STORE_CONNECT_API);
   openUrl(URL_APP_STORE_CONNECT_APPS);
 
+  ui.note(t('ios.configure.note.body'), t('ios.configure.note.title'));
+
   const cancel = () => { ui.cancel(t('ios.configure.cancelled')); process.exit(0); };
   const required = (v) => (v && String(v).trim().length > 0 ? undefined : t('ios.configure.q.required'));
 
@@ -126,12 +128,25 @@ async function runBuildOrRelease(directory, options = {}, mode) {
     const validation = await validateAppleSetup(projectDir);
     if (!validation.ok) {
       printCompactHeader(t);
-      ui.log.error(t('ios.error.notConfigured'));
-      if (validation.issues.includes('missing_env')) {
-        ui.log.message(kleur.dim(t('ios.error.runConfigure')));
+      ui.log.warn(t('ios.error.notConfigured'));
+      const shouldConfigure = await ui.confirm({
+        message: t('ios.release.askConfigure'),
+        initialValue: true,
+      });
+      if (!shouldConfigure) {
+        if (validation.issues.includes('missing_env')) {
+          ui.log.message(kleur.dim(t('ios.error.runConfigure')));
+        }
+        process.exitCode = 1;
+        return;
+      }
+      await runConfigure(directory, options);
+      const recheck = await validateAppleSetup(projectDir);
+      if (!recheck.ok) {
+        ui.log.error(t('ios.error.notConfigured'));
+        process.exitCode = 1;
+        return;
       }
-      process.exitCode = 1;
-      return;
     }
   }
 

package/lib/commands/new.js

@@ -15,22 +15,10 @@ const path = require('node:path');
 const crypto = require('node:crypto');
 const kleur = require('kleur');
 
-function sleep(ms) { return new Promise((r) => setTimeout(r, ms)); }
-
 function generateWebhookKey() {
   return 'rc_wh_' + crypto.randomBytes(16).toString('hex');
 }
 
-
-
-async function waitWithCountdown(seconds, label) {
-  for (let i = seconds; i > 0; i--) {
-    process.stdout.write(`\r  ${label} ${i}s…   `);
-    await sleep(1000);
-  }
-  process.stdout.write(`\r  ${label} pronto!     \n`);
-}
-
 function openUrl(url) {
   try {
     const { exec } = require('node:child_process');
@@ -716,7 +704,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
       const selectedOrgId = await promptOrganizationIfNeeded(tr, cancel);
       let selectedBillingId = await promptBillingAccountIfNeeded(tr, cancel);
       ui.log.info(`${tr('new.firebase.create.estimatedTime')}\n${tr('new.internet.warning')}`);
-      const ps1 = ui.makeStepper();
+      const ps1 = ui.makeTimedStepper();
       ps1.next(tr('new.firebase.create.creating'));
       const setupResult = await setupFromScratch(core.appName.trim(), core.bundleId.trim(), {
         includeWeb: firebaseIncludeWeb,
@@ -796,7 +784,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
           }
           ui.log.message(tr('new.firebase.create.billingRetry.retrying'));
           selectedBillingId = await promptBillingAccountIfNeeded(tr, cancel);
-          const ps2 = ui.makeStepper();
+          const ps2 = ui.makeTimedStepper();
           ps2.next(tr('new.firebase.create.creating'));
           lastResult = await setupFromScratch(core.appName.trim(), core.bundleId.trim(), {
                 includeWeb: firebaseIncludeWeb,
@@ -889,7 +877,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
       const selectedOrgId = await promptOrganizationIfNeeded(tr, cancel);
       const selectedBillingId = await promptBillingAccountIfNeeded(tr, cancel);
       ui.log.info(tr('new.internet.warning'));
-      const ps3 = ui.makeStepper();
+      const ps3 = ui.makeTimedStepper();
       ps3.next(tr('new.firebase.create.creatingPush'));
       const setupResult = await setupFromScratch(core.appName.trim(), core.bundleId.trim(), {
         includeWeb: true,
@@ -990,7 +978,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
         });
         supabaseDbPassword = dbPassword;
         ui.log.info(tr('new.internet.warning'));
-        const createSpinner = ui.spinner();
+        const createSpinner = ui.timedSpinner();
         createSpinner.start(tr('new.supabase.creating'));
         supabaseCreateResult = await createProjectAndGetKeys(
           core.appName.trim().replace(/\s+/g, '-').toLowerCase(),
@@ -1087,7 +1075,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
 
   // ── Firebase existing project: enable APIs + create Firestore/Storage ───
   if (backend === 'firebase' && firebaseSetupMode === 'existing' && core.firebaseProjectId) {
-    const ps4 = ui.makeStepper();
+    const ps4 = ui.makeTimedStepper();
     ps4.next(stepProgress('enable-apis', language));
     const existingSetup = await setupExistingProject(core.firebaseProjectId, {
       onProgress: (key, data) => {
@@ -1388,7 +1376,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
   // Stepper shows each step closing as ✦ and the next starting as ⠙ — so the
   // user gets explicit "X done → Y starting" feedback instead of a single
   // spinner with a mutating message.
-  const stepper = ui.makeStepper();
+  const stepper = ui.makeTimedStepper();
   // First step started here so even silent prep work shows progress.
   stepper.next(stepProgress('project-setup', language));
 
@@ -1512,7 +1500,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
       // ── FCM Service Account key (best effort via gcloud — Firebase uses ADC, Supabase needs JSON) ──
       let fcmServiceAccountJson = null;
       if (answers.firebaseProjectId) {
-        const fcmSpinner = ui.spinner();
+        const fcmSpinner = ui.timedSpinner();
         fcmSpinner.start(tr('new.fcm.generating'));
         const fcmResult = await createFcmServiceAccountKey(answers.firebaseProjectId);
         fcmSpinner.stop(tr('new.fcm.generating'));
@@ -1562,7 +1550,7 @@ async function runNew(directory, { language: langHint = null, backend: backendHi
 
   // ── API: FCM Service Account key — save to .kasy/ for server configuration ──
   if (backend === 'api' && answers.firebaseProjectId) {
-    const fcmSpinner = ui.spinner();
+    const fcmSpinner = ui.timedSpinner();
     fcmSpinner.start(tr('new.fcm.generating'));
     const fcmResult = await createFcmServiceAccountKey(answers.firebaseProjectId);
     fcmSpinner.stop(tr('new.fcm.generating'));