kasy-cli 1.5.3 → 1.7.0

package/lib/commands/docs.js

@@ -2,6 +2,8 @@ const path = require('node:path');
 const { exec } = require('node:child_process');
 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 DOCS_FILE = path.join(__dirname, '..', '..', 'docs', 'cli-reference.md');
@@ -18,30 +20,29 @@ function openInBrowser(url) {
 async function runDocs(options = {}) {
   const t = createTranslator(options.language || detectDefaultLanguage());
 
-  console.log(kleur.bold(`\n  Kasy CLI — Documentação\n`));
+  printCompactHeader(t);
+  ui.intro('Kasy CLI — Documentação');
 
-  // Show local CLI reference
   if (await fs.pathExists(DOCS_FILE)) {
     const content = await fs.readFile(DOCS_FILE, 'utf8');
-    // Show the first section (commands overview)
     const lines = content.split('\n').slice(0, 60);
-    console.log(kleur.dim(lines.join('\n')));
-    console.log(kleur.dim(`\n  ... (arquivo completo: ${DOCS_FILE})\n`));
+    ui.note(`${kleur.dim(lines.join('\n'))}\n\n${kleur.dim(`... (arquivo completo: ${DOCS_FILE})`)}`);
   }
 
-  console.log(kleur.cyan(`  Comandos disponíveis:`));
-  console.log(`    ${kleur.bold('kasy new')}       — Criar novo projeto`);
-  console.log(`    ${kleur.bold('kasy add')}       — Adicionar módulo`);
-  console.log(`    ${kleur.bold('kasy doctor')}    — Verificar ambiente`);
-  console.log(`    ${kleur.bold('kasy run')}       — Executar app`);
-  console.log(`    ${kleur.bold('kasy deploy')}    — Deploy do projeto`);
-  console.log(`    ${kleur.bold('kasy ios')}       — Release iOS (configure / release / build)`);
-  console.log(`    ${kleur.bold('kasy codemagic')} — Build iOS na nuvem`);
-  console.log(`    ${kleur.bold('kasy features')}   — Listar features`);
-  console.log(`    ${kleur.bold('kasy validate')}  — Validar projeto`);
-  console.log('');
-  console.log(kleur.dim(`  Para detalhes de um comando: kasy help <comando>`));
-  console.log('');
+  const commandsBody = [
+    `${kleur.bold('kasy new')}       — Criar novo projeto`,
+    `${kleur.bold('kasy add')}       — Adicionar módulo`,
+    `${kleur.bold('kasy doctor')}    — Verificar ambiente`,
+    `${kleur.bold('kasy run')}       — Executar app`,
+    `${kleur.bold('kasy deploy')}    — Deploy do projeto`,
+    `${kleur.bold('kasy ios')}       — Release iOS (configure / release / build)`,
+    `${kleur.bold('kasy codemagic')} — Build iOS na nuvem`,
+    `${kleur.bold('kasy features')}  — Listar features`,
+    `${kleur.bold('kasy validate')}  — Validar projeto`,
+  ].join('\n');
+  ui.note(commandsBody, kleur.cyan('Comandos disponíveis'));
+
+  ui.outro(kleur.dim('Para detalhes de um comando: kasy help <comando>'));
 }
 
 module.exports = { runDocs };

package/lib/commands/doctor.js

@@ -1,6 +1,7 @@
 const path = require('node:path');
 const fs = require('fs-extra');
 const kleur = require('kleur');
+const ui = require('../utils/ui');
 const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
 const {
   getBaseChecks,
@@ -17,6 +18,7 @@ const {
 } = require('../utils/apple-release');
 const { validateCodemagicSetup, codemagicReleaseDocPath } = require('../utils/codemagic-release');
 const { validateGoogleIosUrlScheme, validateAppleSignInEntitlement, validateFacebookInfoPlist, validateFacebookAndroidStrings, validateRevenueCat } = require('../scaffold/shared/post-build');
+const { printCompactHeader } = require('../utils/brand');
 
 function collectOptionalBackendChecks() {
   return [
@@ -62,26 +64,26 @@ async function runProjectChecks(projectDir, t, options = {}) {
     return;
   }
 
-  console.log(kleur.bold(`\n${t('doctor.project.title')}`));
+  ui.log.step(kleur.bold(t('doctor.project.title')));
 
-  console.log(`  ${kleur.green('✓')} ${t('doctor.project.appName')}: ${kleur.cyan(config.appName || '—')}`);
-  console.log(`  ${kleur.green('✓')} ${t('doctor.project.backend')}: ${kleur.cyan(config.backendProvider || '—')}`);
-  console.log(`  ${kleur.green('✓')} ${t('doctor.project.bundleId')}: ${kleur.dim(config.bundleId || '—')}`);
+  ui.log.success(`${t('doctor.project.appName')}: ${kleur.cyan(config.appName || '—')}`);
+  ui.log.success(`${t('doctor.project.backend')}: ${kleur.cyan(config.backendProvider || '—')}`);
+  ui.log.success(`${t('doctor.project.bundleId')}: ${kleur.dim(config.bundleId || '—')}`);
 
   // pub get check
   const lockExists = await fs.pathExists(path.join(projectDir, 'pubspec.lock'));
   if (lockExists) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.project.pubGet')}`);
+    ui.log.success(t('doctor.project.pubGet'));
   } else {
-    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.project.pubGetMissing')}`);
+    ui.log.warn(t('doctor.project.pubGetMissing'));
   }
 
   // Active modules
   const modules = await getActiveModules(config, projectDir);
   if (modules.length > 0) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.project.modules')}: ${kleur.cyan(modules.join(', '))}`);
+    ui.log.success(`${t('doctor.project.modules')}: ${kleur.cyan(modules.join(', '))}`);
   } else {
-    console.log(`  ${kleur.dim('–')} ${t('doctor.project.noModules')}`);
+    ui.log.message(kleur.dim(`– ${t('doctor.project.noModules')}`));
   }
 
   await runIosReleaseChecks(projectDir, t, options.language, config);
@@ -92,106 +94,101 @@ async function runIosReleaseChecks(projectDir, t, language, config = {}) {
   if (!(await isKasyFlutterProject(projectDir))) return;
 
   const lang = language || detectDefaultLanguage();
-  console.log(kleur.bold(`\n${t('doctor.ios.title')}`));
+  ui.log.step(kleur.bold(t('doctor.ios.title')));
 
   if (process.platform !== 'darwin') {
-    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.notMac')}`);
+    ui.log.warn(t('doctor.ios.notMac'));
   } else {
     const signing = await checkIosSigning(projectDir);
     if (signing.ok) {
-      console.log(`  ${kleur.green('✓')} ${t('doctor.ios.signingOk')}`);
+      ui.log.success(t('doctor.ios.signingOk'));
     } else {
-      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.signingMissing')}`);
+      ui.log.warn(t('doctor.ios.signingMissing'));
     }
   }
 
   const googleScheme = await validateGoogleIosUrlScheme(projectDir);
   if (googleScheme.skipped) {
-    console.log(`  ${kleur.dim('–')} ${t('doctor.ios.googleUrlSchemeSkipped')}`);
+    ui.log.message(kleur.dim(`– ${t('doctor.ios.googleUrlSchemeSkipped')}`));
   } else if (googleScheme.ok) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.googleUrlSchemeOk')}`);
+    ui.log.success(t('doctor.ios.googleUrlSchemeOk'));
   } else {
-    console.log(`  ${kleur.red('✗')} ${t('doctor.ios.googleUrlSchemeMissing')}`);
-    console.log(kleur.dim(`     ${googleScheme.error}`));
+    ui.log.error(`${t('doctor.ios.googleUrlSchemeMissing')}\n${kleur.dim(googleScheme.error)}`);
   }
 
   const appleEntitlement = await validateAppleSignInEntitlement(projectDir);
   if (appleEntitlement.ok) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.appleSignInEntitlementOk')}`);
+    ui.log.success(t('doctor.ios.appleSignInEntitlementOk'));
   } else {
-    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.appleSignInEntitlementMissing')}`);
-    console.log(kleur.dim(`     ${appleEntitlement.error}`));
+    ui.log.warn(`${t('doctor.ios.appleSignInEntitlementMissing')}\n${kleur.dim(appleEntitlement.error)}`);
   }
 
   if (config.withFacebookPixel) {
     const facebook = await validateFacebookInfoPlist(projectDir);
     if (facebook.skipped) {
-      console.log(`  ${kleur.dim('–')} ${t('doctor.ios.facebookSkipped')}`);
+      ui.log.message(kleur.dim(`– ${t('doctor.ios.facebookSkipped')}`));
     } else if (facebook.ok) {
-      console.log(`  ${kleur.green('✓')} ${t('doctor.ios.facebookOk')}`);
+      ui.log.success(t('doctor.ios.facebookOk'));
     } else {
-      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.facebookPlaceholders')}`);
-      console.log(kleur.dim(`     ${facebook.error}`));
+      ui.log.warn(`${t('doctor.ios.facebookPlaceholders')}\n${kleur.dim(facebook.error)}`);
     }
 
     const facebookAndroid = await validateFacebookAndroidStrings(projectDir);
     if (!facebookAndroid.skipped) {
       if (facebookAndroid.ok) {
-        console.log(`  ${kleur.green('✓')} ${t('doctor.android.facebookOk')}`);
+        ui.log.success(t('doctor.android.facebookOk'));
       } else {
-        console.log(`  ${kleur.yellow('⚠')} ${t('doctor.android.facebookPlaceholders')}`);
-        console.log(kleur.dim(`     ${facebookAndroid.error}`));
+        ui.log.warn(`${t('doctor.android.facebookPlaceholders')}\n${kleur.dim(facebookAndroid.error)}`);
       }
     }
   }
 
   const apple = await validateAppleSetup(projectDir);
   if (apple.ok) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.appleOk')}`);
-    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.p8Ok')}`);
+    ui.log.success(t('doctor.ios.appleOk'));
+    ui.log.success(t('doctor.ios.p8Ok'));
   } else {
     if (apple.issues.includes('missing_env') || apple.issues.includes('missing_credentials')) {
-      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.appleMissing')}`);
+      ui.log.warn(t('doctor.ios.appleMissing'));
     }
     if (apple.issues.includes('missing_p8')) {
-      console.log(`  ${kleur.yellow('⚠')} ${t('doctor.ios.p8Missing')}`);
+      ui.log.warn(t('doctor.ios.p8Missing'));
     }
   }
 
   const cm = await validateCodemagicSetup(projectDir);
   if (cm.ok) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.ios.codemagicOk')}`);
+    ui.log.success(t('doctor.ios.codemagicOk'));
   } else if (cm.issues.includes('missing_env')) {
-    console.log(`  ${kleur.dim('–')} ${t('doctor.ios.codemagicMissing')}`);
+    ui.log.message(kleur.dim(`– ${t('doctor.ios.codemagicMissing')}`));
   }
 
   const docPath = iosReleaseDocPath(lang);
-  console.log(`  ${kleur.dim('–')} ${t('doctor.ios.doc')}: ${docPath}, ${codemagicReleaseDocPath(lang)}`);
+  ui.log.message(kleur.dim(`– ${t('doctor.ios.doc')}: ${docPath}, ${codemagicReleaseDocPath(lang)}`));
 }
 
 async function runRevenueCatChecks(projectDir, t, config) {
   if (!config.subscriptionModule) return;
 
-  console.log(kleur.bold(`\n${t('doctor.revenuecat.title')}`));
+  ui.log.step(kleur.bold(t('doctor.revenuecat.title')));
 
   const rc = await validateRevenueCat(projectDir, config);
   if (rc.skipped) return;
 
   if (!rc.iosEmpty && !rc.androidEmpty) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.revenuecat.keysOk')}`);
+    ui.log.success(t('doctor.revenuecat.keysOk'));
   } else {
-    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.revenuecat.keysEmpty')}`);
+    ui.log.warn(t('doctor.revenuecat.keysEmpty'));
   }
 
   if (rc.bothTest) {
-    console.log(`  ${kleur.yellow('⚠')} ${t('doctor.revenuecat.keysTest')}`);
+    ui.log.warn(t('doctor.revenuecat.keysTest'));
   }
 
   if (rc.webhookUrl) {
-    console.log(`  ${kleur.green('✓')} ${t('doctor.revenuecat.webhookUrlSupabase')}:`);
-    console.log(kleur.cyan(`     ${rc.webhookUrl}`));
+    ui.log.success(`${t('doctor.revenuecat.webhookUrlSupabase')}:\n${kleur.cyan(rc.webhookUrl)}`);
   } else if (config.backendProvider === 'firebase' || config.firebaseProjectId) {
-    console.log(`  ${kleur.dim('–')} ${t('doctor.revenuecat.webhookUrlFirebase')}`);
+    ui.log.message(kleur.dim(`– ${t('doctor.revenuecat.webhookUrlFirebase')}`));
   }
 }
 
@@ -199,27 +196,32 @@ async function runDoctor(options = {}) {
   const language = options.language || detectDefaultLanguage();
   const t = createTranslator(language);
   const projectDir = path.resolve(options.directory || '.');
-  console.log(kleur.bold(`\n${t('doctor.title')}\n`));
+  printCompactHeader(t);
+  ui.intro(t('doctor.title'));
 
   // Project-specific checks (only when inside a kasy project)
   await runProjectChecks(projectDir, t, { language });
 
+  // Compact mode integrates with the Clack rail (│). Non-compact mode uses
+  // legacy `ora` which would break the visual flow opened by ui.intro above.
   const baseResults = await runChecks(
     [...getBaseChecks(), ...getPlatformChecks()],
     t('doctor.baseEnvironment'),
-    { t }
+    { t, compact: true, spinnerLabel: t('doctor.baseEnvironment'), doneLabel: t('doctor.baseEnvironment') }
   );
 
   const optionalBackend = collectOptionalBackendChecks();
   if (optionalBackend.length > 0) {
-    await runChecks(optionalBackend, t('doctor.optionalBackend'), { t });
+    await runChecks(optionalBackend, t('doctor.optionalBackend'), {
+      t, compact: true, spinnerLabel: t('doctor.optionalBackend'), doneLabel: t('doctor.optionalBackend'),
+    });
   }
 
   if (hasRequiredFailures(baseResults)) {
     throw new Error(t('doctor.requiredMissing'));
   }
 
-  console.log(kleur.green(`\n${t('doctor.requiredPassed')}`));
+  ui.outro(t('doctor.requiredPassed'));
 }
 
 module.exports = {

package/lib/commands/features.js

@@ -1,33 +1,55 @@
 const kleur = require('kleur');
+const ui = require('../utils/ui');
+const { printCompactHeader } = require('../utils/brand');
 const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
 const {
   AVAILABLE_BACKENDS,
-  getVisibleFeatures
+  getVisibleFeatures,
+  getBaseFeatures,
+  BASE_FEATURES
 } = require('../scaffold/catalog');
 
+function findBaseDisplayName(id) {
+  const base = BASE_FEATURES.find((f) => f.id === id);
+  return base ? base.displayName : id;
+}
+
 const KASY_AUDIENCE = process.env.KASY_INTERNAL === '1' ? 'internal' : 'public';
 
 function runFeatures(options = {}) {
   const t = createTranslator(options.language || detectDefaultLanguage());
-  console.log(kleur.bold(`\n${t('modules.backends')}\n`));
-  for (const backend of AVAILABLE_BACKENDS) {
-    console.log(
-      `${kleur.green('✓')} ${kleur.white(backend.id)} - ${kleur.gray(
-        t(`modules.backend.${backend.id}.description`)
-      )}`
-    );
-  }
-
-  console.log(kleur.bold(`\n${t('modules.features')}\n`));
-  for (const feature of getVisibleFeatures({ audience: KASY_AUDIENCE })) {
-    const badge = feature.status === 'internal' ? kleur.yellow(' [beta]') : '';
-    console.log(
-      `${kleur.cyan('•')} ${kleur.white(feature.id)}${badge} - ${kleur.gray(
-        t(`modules.feature.${feature.id}.description`)
-      )}`
-    );
-  }
-  console.log('');
+  printCompactHeader(t);
+  ui.intro(t('modules.backends'));
+
+  const backendLines = AVAILABLE_BACKENDS.map((backend) =>
+    `${kleur.green('✓')} ${kleur.white(backend.id)} - ${kleur.gray(
+      t(`modules.backend.${backend.id}.description`)
+    )}`
+  );
+  ui.log.message(backendLines.join('\n'));
+
+  ui.log.step(kleur.bold(t('modules.featuresBase')));
+  const baseLines = getBaseFeatures().map((feature) =>
+    `${kleur.green('✓')} ${kleur.white(feature.displayName)} - ${kleur.gray(
+      t(`modules.feature.base.${feature.id}.description`)
+    )}`
+  );
+  ui.log.message(baseLines.join('\n'));
+
+  ui.log.step(kleur.bold(t('modules.features')));
+  const featureLines = getVisibleFeatures({ audience: KASY_AUDIENCE }).map((feature) => {
+    const betaBadge = feature.status === 'internal' ? kleur.yellow(' [beta]') : '';
+    const tagBadge = feature.tag ? kleur.yellow(` [${t(`modules.tag.${feature.tag}`)}]`) : '';
+    const enhancesBadge = feature.enhances
+      ? kleur.magenta(` [${t('modules.tag.enhances', { target: findBaseDisplayName(feature.enhances) })}]`)
+      : '';
+    return `${kleur.cyan('○')} ${kleur.white(feature.displayName)}${tagBadge}${enhancesBadge}${betaBadge} - ${kleur.gray(
+      t(`modules.feature.${feature.id}.description`)
+    )}`;
+  });
+  ui.log.message(featureLines.join('\n'));
+
+  ui.outro('');
 }
 
 module.exports = {

package/lib/commands/ios.js

@@ -3,7 +3,8 @@
 const path = require('node:path');
 const fs = require('fs-extra');
 const kleur = require('kleur');
-const prompts = require('prompts');
+const ui = require('../utils/ui');
+const { printCompactHeader } = require('../utils/brand');
 const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
 const {
   isKasyFlutterProject,
@@ -39,65 +40,61 @@ async function runConfigure(directory, options = {}) {
   await assertProject(projectDir, t);
 
   const bundleId = await readBundleId(projectDir);
-  console.log(kleur.bold(`\n${t('ios.configure.title')}\n`));
+  printCompactHeader(t);
+  ui.intro(t('ios.configure.title'));
+
   if (bundleId) {
-    console.log(`  ${t('ios.configure.bundleId')}: ${kleur.cyan(bundleId)}`);
+    ui.log.info(`${t('ios.configure.bundleId')}: ${kleur.cyan(bundleId)}`);
   }
-  console.log(kleur.dim(`  ${t('ios.configure.doc')}: ${iosReleaseDocPath(options.language || detectDefaultLanguage())}\n`));
+  ui.log.message(kleur.dim(`${t('ios.configure.doc')}: ${iosReleaseDocPath(options.language || detectDefaultLanguage())}`));
 
-  console.log(kleur.cyan(t('ios.configure.openingLinks')));
+  ui.log.info(t('ios.configure.openingLinks'));
   openUrl(URL_APP_STORE_CONNECT_API);
   openUrl(URL_APP_STORE_CONNECT_APPS);
 
-  const response = await prompts(
-    [
-      {
-        type: 'text',
-        name: 'apiKey',
-        message: t('ios.configure.q.apiKey'),
-        validate: (v) => (v && v.trim().length > 0 ? true : t('ios.configure.q.required')),
-      },
-      {
-        type: 'text',
-        name: 'issuerId',
-        message: t('ios.configure.q.issuerId'),
-        validate: (v) => (v && v.trim().length > 0 ? true : t('ios.configure.q.required')),
-      },
-      {
-        type: 'text',
-        name: 'p8Path',
-        message: t('ios.configure.q.p8Path'),
-        validate: async (v) => {
-          if (!v || !v.trim()) return t('ios.configure.q.required');
-          const resolved = path.resolve(v.trim().replace(/^~/, process.env.HOME || ''));
-          if (!(await fs.pathExists(resolved))) return t('ios.configure.q.p8NotFound');
-          return true;
-        },
-      },
-      {
-        type: 'text',
-        name: 'appId',
-        message: t('ios.configure.q.appId'),
-        initial: '',
-      },
-    ],
-    { onCancel: () => { throw new Error(t('ios.configure.cancelled')); } }
-  );
-
-  const apiKey = response.apiKey.trim();
-  const issuerId = response.issuerId.trim();
-  const p8Source = path.resolve(response.p8Path.trim().replace(/^~/, process.env.HOME || ''));
+  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'));
+
+  const apiKeyRaw = await ui.text({
+    message: t('ios.configure.q.apiKey'),
+    validate: required,
+    onCancel: cancel,
+  });
+  const issuerIdRaw = await ui.text({
+    message: t('ios.configure.q.issuerId'),
+    validate: required,
+    onCancel: cancel,
+  });
+  const p8PathRaw = await ui.text({
+    message: t('ios.configure.q.p8Path'),
+    validate: async (v) => {
+      if (!v || !v.trim()) return t('ios.configure.q.required');
+      const resolved = path.resolve(v.trim().replace(/^~/, process.env.HOME || ''));
+      if (!(await fs.pathExists(resolved))) return t('ios.configure.q.p8NotFound');
+      return undefined;
+    },
+    onCancel: cancel,
+  });
+  const appIdRaw = await ui.text({
+    message: t('ios.configure.q.appId'),
+    initialValue: '',
+    onCancel: cancel,
+  });
+
+  const apiKey = apiKeyRaw.trim();
+  const issuerId = issuerIdRaw.trim();
+  const p8Source = path.resolve(p8PathRaw.trim().replace(/^~/, process.env.HOME || ''));
 
   const destPath = await installPrivateKey(p8Source, apiKey);
   await writeAppleEnv(projectDir, {
     apiKey,
     issuerId,
-    appId: response.appId?.trim() || '',
+    appId: appIdRaw?.trim() || '',
   });
 
-  console.log(kleur.green(`\n✓ ${t('ios.configure.success')}`));
-  console.log(kleur.dim(`  ${t('ios.configure.p8Installed')}: ${destPath}`));
-  console.log(kleur.cyan(`\n  ${t('ios.configure.next')}: kasy ios release\n`));
+  ui.log.success(t('ios.configure.success'));
+  ui.log.message(kleur.dim(`${t('ios.configure.p8Installed')}: ${destPath}`));
+  ui.outro(kleur.cyan(`${t('ios.configure.next')}: kasy ios release`));
 }
 
 async function runBuildOrRelease(directory, options = {}, mode) {
@@ -107,8 +104,9 @@ async function runBuildOrRelease(directory, options = {}, mode) {
   await assertProject(projectDir, t);
 
   if (mode === 'release' && process.platform !== 'darwin') {
-    console.log(kleur.yellow(`\n${t('ios.error.notMac')}`));
-    console.log(kleur.cyan(`  ${t('ios.error.useCodemagic')}: kasy codemagic configure\n`));
+    printCompactHeader(t);
+    ui.log.warn(t('ios.error.notMac'));
+    ui.log.info(`${t('ios.error.useCodemagic')}: kasy codemagic configure`);
     process.exitCode = 1;
     return;
   }
@@ -116,8 +114,9 @@ async function runBuildOrRelease(directory, options = {}, mode) {
   if (process.platform === 'darwin') {
     const signing = await checkIosSigning(projectDir);
     if (!signing.ok) {
-      console.log(kleur.yellow(`\n⚠ ${t('ios.error.signing')}`));
-      console.log(kleur.dim(`  ${t('ios.error.signingHint')}\n`));
+      printCompactHeader(t);
+      ui.log.warn(t('ios.error.signing'));
+      ui.log.message(kleur.dim(t('ios.error.signingHint')));
       process.exitCode = 1;
       return;
     }
@@ -126,9 +125,10 @@ async function runBuildOrRelease(directory, options = {}, mode) {
   if (mode === 'release') {
     const validation = await validateAppleSetup(projectDir);
     if (!validation.ok) {
-      console.log(kleur.red(`\n✗ ${t('ios.error.notConfigured')}\n`));
+      printCompactHeader(t);
+      ui.log.error(t('ios.error.notConfigured'));
       if (validation.issues.includes('missing_env')) {
-        console.log(kleur.dim(`  ${t('ios.error.runConfigure')}\n`));
+        ui.log.message(kleur.dim(t('ios.error.runConfigure')));
       }
       process.exitCode = 1;
       return;
@@ -137,9 +137,10 @@ async function runBuildOrRelease(directory, options = {}, mode) {
 
   const googleScheme = await validateGoogleIosUrlScheme(projectDir);
   if (!googleScheme.ok) {
-    console.log(kleur.red(`\n✗ ${t('ios.error.googleUrlScheme')}\n`));
-    console.log(kleur.dim(`  ${googleScheme.error}`));
-    console.log(kleur.cyan(`  ${t('ios.error.googleUrlSchemeHint')}\n`));
+    printCompactHeader(t);
+    ui.log.error(t('ios.error.googleUrlScheme'));
+    ui.log.message(kleur.dim(googleScheme.error));
+    ui.log.info(t('ios.error.googleUrlSchemeHint'));
     process.exitCode = 1;
     return;
   }
@@ -152,22 +153,19 @@ async function runBuildOrRelease(directory, options = {}, mode) {
   if (process.platform === 'darwin') {
     const disk = await checkDiskSpaceForIosBuild(projectDir);
     if (!disk.ok && disk.freeGb !== null) {
-      console.log(
-        kleur.yellow(
-          `\n⚠ ${t('ios.warn.lowDisk', { gb: disk.freeGb, min: MIN_DISK_GB_FOR_IOS_BUILD })}\n`
-        )
-      );
+      ui.log.warn(t('ios.warn.lowDisk', { gb: disk.freeGb, min: MIN_DISK_GB_FOR_IOS_BUILD }));
     }
   }
 
-  console.log(kleur.bold(`\n${mode === 'build' ? t('ios.build.title') : t('ios.release.title')}\n`));
+  printCompactHeader(t);
+  ui.intro(mode === 'build' ? t('ios.build.title') : t('ios.release.title'));
 
   try {
     await runReleaseScript(projectDir, args, t);
-    console.log(kleur.green(`\n✓ ${mode === 'build' ? t('ios.build.success') : t('ios.release.success')}\n`));
+    ui.outro(mode === 'build' ? t('ios.build.success') : t('ios.release.success'));
   } catch (err) {
     const output = err.buildOutput || err.message;
-    console.error(kleur.red(`\n✗ ${output.slice(-4000)}\n`));
+    ui.log.error(output.slice(-4000));
     if (isXcodeCacheBuildError(output)) {
       printBuildFailureHints(t, projectDir);
     }
@@ -182,18 +180,20 @@ async function runClean(directory, options = {}) {
   await assertProject(projectDir, t);
 
   if (process.platform !== 'darwin') {
-    console.log(kleur.yellow(`\n${t('ios.clean.notMac')}\n`));
+    printCompactHeader(t);
+    ui.log.warn(t('ios.clean.notMac'));
     process.exitCode = 1;
     return;
   }
 
-  console.log(kleur.bold(`\n${t('ios.clean.title')}\n`));
+  printCompactHeader(t);
+  ui.intro(t('ios.clean.title'));
   try {
     await runIosClean(projectDir, t);
-    console.log(kleur.green(`\n✓ ${t('ios.clean.success')}\n`));
-    console.log(kleur.cyan(`  ${t('ios.configure.next')}: kasy ios release\n`));
+    ui.log.success(t('ios.clean.success'));
+    ui.outro(kleur.cyan(`${t('ios.configure.next')}: kasy ios release`));
   } catch (err) {
-    console.error(kleur.red(`\n✗ ${err.message}\n`));
+    ui.log.error(err.message);
     process.exitCode = 1;
   }
 }