kasy-cli 1.5.3 → 1.7.0

package/bin/kasy.js

@@ -35,6 +35,7 @@ const { getStoredLanguage, setStoredLanguage } = require('../lib/utils/license')
 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');
 
 function createLocalizedHelpConfig(t) {
   return {
@@ -276,7 +277,7 @@ function buildProgram(language) {
   applyLocalizedHelp(
     program
       .command('add')
-      .argument('[module]', 'Module to add (e.g. sentry, analytics, revenuecat, onboarding, camera, ci...)')
+      .argument('[module]', 'Module to add (e.g. sentry, analytics, revenuecat, onboarding, llm_chat, ci...)')
       .option('--list', 'List all available modules and their current status')
       .option('--yes', 'Skip interactive prompts (use placeholder values)')
       .option('-d, --directory <path>', 'Project folder (default: current directory)', '.')
@@ -290,7 +291,7 @@ function buildProgram(language) {
   applyLocalizedHelp(
     program
       .command('remove')
-      .argument('[module]', 'Module to remove (e.g. sentry, analytics, camera, ci...)')
+      .argument('[module]', 'Module to remove (e.g. sentry, analytics, llm_chat, ci...)')
       .option('--yes', 'Skip confirmation prompt')
       .option('-d, --directory <path>', 'Project folder (default: current directory)', '.')
       .description(t('cli.command.remove.description'))
@@ -322,7 +323,8 @@ function buildProgram(language) {
       .description(t('cli.command.upgrade.description'))
       .action(() => {
         const { spawnSync } = require('node:child_process');
-        console.log('\n' + kleur.cyan(t('cli.command.upgrade.running')) + '\n');
+        printCompactHeader(t);
+        console.log(kleur.cyan(t('cli.command.upgrade.running')) + '\n');
         const result = spawnSync('npm', ['install', '-g', 'kasy-cli'], { stdio: 'inherit', shell: true });
         if (result.status === 0) {
           console.log('\n' + kleur.green('✓ ' + t('cli.command.upgrade.done')) + '\n');
@@ -339,7 +341,8 @@ function buildProgram(language) {
       .description(t('cli.command.uninstall.description'))
       .action(() => {
         const { spawnSync } = require('node:child_process');
-        console.log('\n' + kleur.cyan(t('cli.command.uninstall.running')) + '\n');
+        printCompactHeader(t);
+        console.log(kleur.cyan(t('cli.command.uninstall.running')) + '\n');
         const result = spawnSync('npm', ['uninstall', '-g', 'kasy-cli'], { stdio: 'inherit', shell: true });
         if (result.status === 0) {
           console.log('\n' + kleur.green('✓ ' + t('cli.command.uninstall.done')) + '\n');

package/docs/cli-reference.md

@@ -17,7 +17,7 @@ kasy new                        # interativo — pergunta tudo
 kasy new meu-app               # cria na pasta meu-app
 kasy new --yes                 # modo rápido, preset Starter
 kasy new --backend supabase    # define backend sem perguntar
-kasy new --with camera,sentry  # pré-seleciona features
+kasy new --with llm_chat,sentry  # pré-seleciona features
 ```
 
 **Opções:**
@@ -36,12 +36,12 @@ kasy new --with camera,sentry  # pré-seleciona features
 Adiciona uma feature a um projeto Kasy existente.
 
 ```bash
-kasy add camera
+kasy add llm_chat
 kasy add sentry
 kasy add revenuecat
 kasy add --list               # lista features disponíveis e status
-kasy add --yes camera         # sem perguntas interativas
-kasy add -d ./outro-app camera
+kasy add --yes llm_chat       # sem perguntas interativas
+kasy add -d ./outro-app llm_chat
 ```
 
 **Features disponíveis:**
@@ -54,7 +54,6 @@ kasy add -d ./outro-app camera
 | `onboarding` | Fluxo de onboarding customizável |
 | `web` | Suporte a Flutter Web |
 | `widget` | Home widgets para iOS e Android |
-| `camera` | Câmera com CameraAwesome |
 | `llm_chat` | Chat com IA via Cloud/Edge Functions |
 | `feedback` | Sistema de feedback e feature requests |
 | `ci` | CI/CD com GitHub Actions / Codemagic |
@@ -202,7 +201,6 @@ lib/
     home/           # tela principal
     notifications/  # notificações locais e push
     settings/       # configurações do app
-    camera/         # [feature] câmera
     llm_chat/       # [feature] chat com IA
     feedbacks/      # [feature] feedback e feature requests
     onboarding/     # [feature] onboarding

package/lib/commands/add.js

@@ -5,23 +5,29 @@ const os = require('node:os');
 const fs = require('fs-extra');
 const pkg = require('../../package.json');
 const kleur = require('kleur');
-const prompts = require('prompts');
-const oraPackage = require('ora');
+const ui = require('../utils/ui');
+const { printCompactHeader } = require('../utils/brand');
 const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
 const {
   AVAILABLE_FEATURES,
   FEATURES_PATCH_DIR,
   normalizeFeature,
   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';
 const { applyPatch } = require('../scaffold/engine');
 const { writeRouter, writeNoOpAnalyticsApi, writeNoOpTrackingApi, writeNoOpAdminHomeWidgets, writeNoOpFeatureRequestRepository, writeMainDart, addPubspecDep, localizeReleaseDocs } = require('../scaffold/shared/generator-utils');
 const { toPackageName, buildTokens } = require('../scaffold/backends/firebase/tokens');
 
 const execAsync = promisify(exec);
-const ora = oraPackage.default || oraPackage;
 
 /** URL do endpoint LLM no app (espelha defineUpdates de llm_chat). */
 function resolveLlmChatEndpoint(answers, kitSetup) {
@@ -317,58 +323,48 @@ const MODULE_META = {
   },
 };
 
+/**
+ * Each entry returns a fn (t, cancel) -> Promise<value> that asks the user.
+ * Secret-like values (DSNs, API keys, tokens) use ui.password to mask input.
+ */
 const PROMPT_QUESTIONS = {
-  sentryDsn: (t) => ({
-    type: 'text',
-    name: 'sentryDsn',
+  sentryDsn: (t, cancel) => ui.password({
     message: t('add.prompt.sentryDsn'),
-    initial: '',
+    onCancel: cancel,
   }),
-  mixpanelToken: (t) => ({
-    type: 'text',
-    name: 'mixpanelToken',
+  mixpanelToken: (t, cancel) => ui.password({
     message: t('add.prompt.mixpanelToken'),
-    initial: '',
+    onCancel: cancel,
   }),
-  rcAndroidKey: (t) => ({
-    type: 'text',
-    name: 'rcAndroidKey',
+  // RevenueCat SDK keys ship inside the client binary — not real secrets, plain text input.
+  rcAndroidKey: (t, cancel) => ui.text({
     message: t('add.prompt.rcAndroidKey'),
-    initial: '',
+    onCancel: cancel,
   }),
-  rcIosKey: (t) => ({
-    type: 'text',
-    name: 'rcIosKey',
+  rcIosKey: (t, cancel) => ui.text({
     message: t('add.prompt.rcIosKey'),
-    initial: '',
+    onCancel: cancel,
   }),
-  llmProvider: (t) => ({
-    type: 'select',
-    name: 'llmProvider',
+  llmProvider: (t, cancel) => ui.select({
     message: t('add.prompt.llmProvider'),
-    choices: [
-      { title: 'OpenAI (gpt-4o-mini)', value: 'openai' },
-      { title: 'Google Gemini (gemini-1.5-flash)', value: 'gemini' },
+    initialValue: 'openai',
+    options: [
+      { value: 'openai', label: 'OpenAI (gpt-4o-mini)' },
+      { value: 'gemini', label: 'Google Gemini (gemini-1.5-flash)' },
     ],
-    initial: 0,
+    onCancel: cancel,
   }),
-  llmSystemPrompt: (t) => ({
-    type: 'text',
-    name: 'llmSystemPrompt',
+  llmSystemPrompt: (t, cancel) => ui.text({
     message: t('add.prompt.llmSystemPrompt'),
-    initial: '',
+    onCancel: cancel,
   }),
-  llmApiKey: (t) => ({
-    type: 'text',
-    name: 'llmApiKey',
+  llmApiKey: (t, cancel) => ui.password({
     message: t('add.prompt.llmApiKey'),
-    initial: '',
+    onCancel: cancel,
   }),
-  llmEndpoint: (t) => ({
-    type: 'text',
-    name: 'llmEndpoint',
+  llmEndpoint: (t, cancel) => ui.text({
     message: t('add.prompt.llmEndpoint'),
-    initial: '',
+    onCancel: cancel,
   }),
 };
 
@@ -411,7 +407,7 @@ async function postAddLlmChat(projectDir, kitSetup, answers, t) {
 
   // 2. Set API key as secret (skip if blank)
   if (!apiKey) {
-    console.log(kleur.yellow(`\n  ${t('add.llm_chat.skipSecret')}\n`));
+    ui.log.warn(t('add.llm_chat.skipSecret'));
     return { deployOk: false, deployAttempted: false };
   }
 
@@ -419,21 +415,23 @@ async function postAddLlmChat(projectDir, kitSetup, answers, t) {
   const refFlag = backend === 'supabase' && projectRef ? ` --project-ref ${projectRef}` : '';
 
   if (backend === 'firebase') {
-    const spinner = ora(t('add.llm_chat.settingSecret')).start();
+    const spinner = ui.spinner();
+    spinner.start(t('add.llm_chat.settingSecret'));
     try {
       // Write to temp file — avoids trailing newline (echo) and shell injection risks
       const tmpFile = path.join(os.tmpdir(), `llm_api_key_${Date.now()}.tmp`);
       await fs.outputFile(tmpFile, apiKey, 'utf8');
       await execAsync(`firebase functions:secrets:set LLM_API_KEY --data-file="${tmpFile}"`, { cwd: projectDir });
       await fs.remove(tmpFile);
-      spinner.succeed(t('add.llm_chat.secretSet'));
+      spinner.stop(t('add.llm_chat.secretSet'));
       secretsOk = true;
     } catch {
-      spinner.warn(t('add.llm_chat.secretFailed'));
-      console.log(kleur.dim(`  Run manually: firebase functions:secrets:set LLM_API_KEY`));
+      spinner.stop(`⚠ ${t('add.llm_chat.secretFailed')}`);
+      ui.log.message(kleur.dim('Run manually: firebase functions:secrets:set LLM_API_KEY'));
     }
   } else if (backend === 'supabase') {
-    const spinner = ora(t('add.llm_chat.settingSecret')).start();
+    const spinner = ui.spinner();
+    spinner.start(t('add.llm_chat.settingSecret'));
     // Set LLM_API_KEY, LLM_PROVIDER and LLM_SYSTEM_PROMPT all as Supabase Secrets.
     // Deployed Edge Functions read from Deno.env.get() = Supabase Secrets, NOT from .env files.
     const esc = (v) => String(v).replace(/"/g, '\\"');
@@ -451,32 +449,33 @@ async function postAddLlmChat(projectDir, kitSetup, answers, t) {
       if (r && r.ok === false) allOk = false;
     }
     if (allOk) {
-      spinner.succeed(t('add.llm_chat.secretSet'));
+      spinner.stop(t('add.llm_chat.secretSet'));
       secretsOk = true;
     } else {
-      spinner.warn(t('add.llm_chat.secretFailed'));
-      console.log(kleur.dim(`  Run manually: supabase secrets set LLM_API_KEY=YOUR_KEY LLM_PROVIDER=${provider}${refFlag}`));
+      spinner.stop(`⚠ ${t('add.llm_chat.secretFailed')}`);
+      ui.log.message(kleur.dim(`Run manually: supabase secrets set LLM_API_KEY=YOUR_KEY LLM_PROVIDER=${provider}${refFlag}`));
     }
   }
 
   // 3. Deploy the LLM function automatically
   if (backend === 'api') return { deployOk: false, deployAttempted: false };
 
-  const deploySpinner = ora(t('add.llm_chat.deploying')).start();
+  const deploySpinner = ui.spinner();
+  deploySpinner.start(t('add.llm_chat.deploying'));
   try {
     if (backend === 'firebase') {
       await execAsync('firebase deploy --only functions:llmChat', { cwd: projectDir, timeout: 180_000 });
     } else if (backend === 'supabase') {
       await execAsync(`supabase functions deploy llm-chat --no-verify-jwt${refFlag}`, { cwd: projectDir, timeout: 180_000 });
     }
-    deploySpinner.succeed(t('add.llm_chat.deployed'));
+    deploySpinner.stop(t('add.llm_chat.deployed'));
     return { deployOk: true, deployAttempted: true };
   } catch {
-    deploySpinner.warn(t('add.llm_chat.deployFailed'));
+    deploySpinner.stop(`⚠ ${t('add.llm_chat.deployFailed')}`);
     if (backend === 'firebase') {
-      console.log(kleur.dim(`  Run manually: firebase deploy --only functions:llmChat`));
+      ui.log.message(kleur.dim('Run manually: firebase deploy --only functions:llmChat'));
     } else {
-      console.log(kleur.dim(`  Run manually: supabase functions deploy llm-chat --no-verify-jwt${refFlag}`));
+      ui.log.message(kleur.dim(`Run manually: supabase functions deploy llm-chat --no-verify-jwt${refFlag}`));
     }
     return { deployOk: false, deployAttempted: true };
   }
@@ -485,8 +484,6 @@ async function postAddLlmChat(projectDir, kitSetup, answers, t) {
 // ── List command ──────────────────────────────────────────────────────────────
 
 async function listModules(projectDir, t) {
-  console.log(kleur.bold(`\n${t('add.list.title')}\n`));
-
   let activeModules = [];
   const kitSetupPath = path.join(projectDir, 'kit_setup.json');
   if (await fs.pathExists(kitSetupPath)) {
@@ -498,14 +495,33 @@ async function listModules(projectDir, t) {
     }
   }
 
+  const lines = [];
+
+  lines.push(kleur.bold(t('modules.featuresBase')));
+  for (const feature of getBaseFeatures()) {
+    lines.push(`${kleur.green('✓')}  ${kleur.green(feature.displayName)}`);
+  }
+
+  // Subscriptions is base, but inactive until RevenueCat is added.
+  if (!activeModules.includes('revenuecat')) {
+    lines.push('');
+    lines.push(kleur.dim(t('modules.hint.subscriptionNoRc')));
+  }
+
+  lines.push('');
+  lines.push(kleur.bold(t('modules.features')));
   for (const feature of getVisibleFeatures({ audience: KASY_AUDIENCE })) {
     const active = activeModules.includes(feature.id);
-    const badge = feature.status === 'internal' ? kleur.yellow(' [beta]') : '';
+    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) })}]`)
+      : '';
     const icon = active ? kleur.green('✓') : kleur.dim('○');
-    const label = active ? kleur.green(feature.id) : kleur.white(feature.id);
-    console.log(`  ${icon}  ${label}${badge}`);
+    const label = active ? kleur.green(feature.displayName) : kleur.white(feature.displayName);
+    lines.push(`${icon}  ${label}${tagBadge}${enhancesBadge}${betaBadge}`);
   }
-  console.log('');
+  ui.note(lines.join('\n'), t('add.list.title'));
 }
 
 // ── Main command ──────────────────────────────────────────────────────────────
@@ -513,16 +529,23 @@ async function listModules(projectDir, t) {
 async function runAdd(module, options = {}) {
   const t = createTranslator(options.language || detectDefaultLanguage());
   const projectDir = path.resolve(options.directory || '.');
+  const cancel = () => { ui.cancel(t('add.cancelled')); process.exit(0); };
 
   // --list flag
   if (options.list) {
+    printCompactHeader(t);
+    ui.intro(t('add.list.title'));
     await listModules(projectDir, t);
+    ui.outro('');
     return;
   }
 
   if (!module) {
-    console.log(kleur.yellow(t('add.error.noModule')));
+    printCompactHeader(t);
+    ui.intro(t('add.list.title'));
+    ui.log.warn(t('add.error.noModule'));
     await listModules(projectDir, t);
+    ui.outro('');
     return;
   }
 
@@ -542,13 +565,16 @@ async function runAdd(module, options = {}) {
   if (moduleLower === 'ios-release' || moduleLower === 'ios_release' || moduleLower === 'iosrelease') {
     const scriptPath = path.join(projectDir, 'scripts', 'release-ios.sh');
     if (await fs.pathExists(scriptPath)) {
-      console.log(kleur.yellow(`\n${t('add.iosRelease.already')}\n`));
+      printCompactHeader(t);
+      ui.log.warn(t('add.iosRelease.already'));
       return;
     }
     const patchDir = path.join(FEATURES_PATCH_DIR, 'ios-release');
     if (!(await fs.pathExists(patchDir))) {
       throw new Error(t('add.error.unknownModule', { module, list: 'ios-release' }));
     }
+    printCompactHeader(t);
+    ui.intro(t('add.applying', { module: 'ios-release' }));
     const { tokens, pathReplacements } = buildTokens({
       appName: kitSetup.appName,
       bundleId: kitSetup.bundleId,
@@ -557,8 +583,8 @@ async function runAdd(module, options = {}) {
     await localizeReleaseDocs(projectDir, options.language || detectDefaultLanguage());
     await ensureIosReleaseMakefile(projectDir);
     await ensureGitignoreKasyEnv(projectDir);
-    console.log(kleur.green(`\n✓ ${t('add.iosRelease.success')}\n`));
-    console.log(kleur.cyan(`  kasy ios configure\n`));
+    ui.log.success(t('add.iosRelease.success'));
+    ui.outro(kleur.cyan('kasy ios configure'));
     return;
   }
 
@@ -578,23 +604,22 @@ async function runAdd(module, options = {}) {
   if (activeModules.includes(normalized)) {
     // llm_chat can be re-run to reconfigure credentials even when already active
     if (normalized !== 'llm_chat') {
-      console.log(kleur.yellow(`\n${t('add.alreadyActive', { module: normalized })}\n`));
+      printCompactHeader(t);
+      ui.log.warn(t('add.alreadyActive', { module: normalized }));
       return;
     }
-    console.log(kleur.yellow(`\n${t('add.llm_chat.reconfigure')}\n`));
+    printCompactHeader(t);
+    ui.intro(t('add.llm_chat.reconfigure'));
     // Skip to credential-only flow: prompt → postAdd → done
     const answers = {};
     if (!options.yes) {
-      console.log('');
       for (const key of ['llmProvider', 'llmSystemPrompt', 'llmApiKey']) {
-        const question = PROMPT_QUESTIONS[key]?.(t);
-        if (!question) continue;
-        const response = await prompts(question, { onCancel: () => { throw new Error(t('add.cancelled')); } });
-        answers[key] = response[key] ?? '';
+        const ask = PROMPT_QUESTIONS[key];
+        if (!ask) continue;
+        answers[key] = (await ask(t, cancel)) ?? '';
       }
       if (kitSetup.backendProvider === 'api') {
-        const response = await prompts(PROMPT_QUESTIONS.llmEndpoint(t), { onCancel: () => { throw new Error(t('add.cancelled')); } });
-        answers.llmEndpoint = response.llmEndpoint || '';
+        answers.llmEndpoint = (await PROMPT_QUESTIONS.llmEndpoint(t, cancel)) || '';
       }
     }
     const defines = MODULE_META.llm_chat.defineUpdates(answers, kitSetup);
@@ -610,41 +635,37 @@ async function runAdd(module, options = {}) {
     const { deployOk, deployAttempted } = await postAddLlmChat(projectDir, kitSetup, answers, t);
     const backend = kitSetup?.backendProvider ?? 'firebase';
     const needsManualDeploy = deployAttempted && !deployOk;
+    let nextStepsMsg;
     if (backend === 'firebase') {
-      console.log(kleur.cyan(t(needsManualDeploy ? 'add.llm_chat.nextSteps.firebase.deployFailed' : 'add.llm_chat.nextSteps.firebase')));
+      nextStepsMsg = t(needsManualDeploy ? 'add.llm_chat.nextSteps.firebase.deployFailed' : 'add.llm_chat.nextSteps.firebase');
     } else if (backend === 'supabase') {
-      console.log(kleur.cyan(t(needsManualDeploy ? 'add.llm_chat.nextSteps.supabase.deployFailed' : 'add.llm_chat.nextSteps.supabase')));
+      nextStepsMsg = t(needsManualDeploy ? 'add.llm_chat.nextSteps.supabase.deployFailed' : 'add.llm_chat.nextSteps.supabase');
     } else {
-      console.log(kleur.cyan(t('add.llm_chat.nextSteps.api')));
+      nextStepsMsg = t('add.llm_chat.nextSteps.api');
     }
+    ui.outro(kleur.cyan(nextStepsMsg));
     return;
   }
 
   const meta = MODULE_META[normalized] || { promptKeys: [], defineUpdates: () => ({}), envLines: () => [], featureFlag: null };
 
+  printCompactHeader(t);
+  ui.intro(t('add.applying', { module: normalized }));
+
   // 4. Prompt for API keys (skip if --yes)
   const answers = {};
   if (!options.yes && meta.promptKeys.length > 0) {
-    console.log('');
     for (const key of meta.promptKeys) {
-      const question = PROMPT_QUESTIONS[key]?.(t);
-      if (!question) continue;
-      const response = await prompts(question, {
-        onCancel: () => { throw new Error(t('add.cancelled')); },
-      });
-      answers[key] = response[key] ?? '';
+      const ask = PROMPT_QUESTIONS[key];
+      if (!ask) continue;
+      answers[key] = (await ask(t, cancel)) ?? '';
     }
     // Extra prompt for API backend (custom LLM endpoint)
     if (normalized === 'llm_chat' && kitSetup.backendProvider === 'api') {
-      const response = await prompts(PROMPT_QUESTIONS.llmEndpoint(t), {
-        onCancel: () => { throw new Error(t('add.cancelled')); },
-      });
-      answers.llmEndpoint = response.llmEndpoint || '';
+      answers.llmEndpoint = (await PROMPT_QUESTIONS.llmEndpoint(t, cancel)) || '';
     }
   }
 
-  console.log(kleur.bold(`\n${t('add.applying', { module: normalized })}\n`));
-
   // 5. Enable feature flag in features.dart
   if (meta.featureFlag) {
     await enableFeatureFlag(projectDir, meta.featureFlag);
@@ -667,16 +688,17 @@ async function runAdd(module, options = {}) {
   // 8. Apply patch if it exists under features/<module>/
   const patchDir = path.join(FEATURES_PATCH_DIR, normalized);
   if (await fs.pathExists(patchDir)) {
-    const spinner = ora(t('add.applyingPatch')).start();
+    const spinner = ui.spinner();
+    spinner.start(t('add.applyingPatch'));
     try {
       const { tokens: patchTokens, pathReplacements: patchPathReplacements } = buildTokens({
         appName: kitSetup.appName,
         bundleId: kitSetup.bundleId,
       });
       await applyPatch(patchDir, projectDir, patchTokens, patchPathReplacements);
-      spinner.succeed(t('add.patchApplied'));
+      spinner.stop(t('add.patchApplied'));
     } catch (err) {
-      spinner.fail(t('add.patchFailed'));
+      spinner.error(t('add.patchFailed'));
       throw err;
     }
   }
@@ -726,24 +748,26 @@ async function runAdd(module, options = {}) {
 
   // 10. flutter pub get
   {
-    const spinner = ora(t('add.pubGet')).start();
+    const spinner = ui.spinner();
+    spinner.start(t('add.pubGet'));
     try {
       await execAsync('flutter pub get', { cwd: projectDir, timeout: 300_000 });
-      spinner.succeed(t('add.pubGetDone'));
+      spinner.stop(t('add.pubGetDone'));
     } catch {
-      spinner.warn(t('add.pubGetFailed'));
+      spinner.stop(`⚠ ${t('add.pubGetFailed')}`);
     }
   }
 
   // 11. build_runner (only when needed: features with codegen)
   const needsBuildRunner = ['revenuecat', 'analytics', 'sentry', 'onboarding', 'llm_chat', 'feedback'].includes(normalized);
   if (needsBuildRunner) {
-    const spinner = ora(t('add.buildRunner')).start();
+    const spinner = ui.spinner();
+    spinner.start(t('add.buildRunner'));
     try {
       await execAsync('dart run build_runner build --delete-conflicting-outputs', { cwd: projectDir, timeout: 600_000 });
-      spinner.succeed(t('add.buildRunnerDone'));
+      spinner.stop(t('add.buildRunnerDone'));
     } catch {
-      spinner.warn(t('add.buildRunnerFailed'));
+      spinner.stop(`⚠ ${t('add.buildRunnerFailed')}`);
     }
   }
 
@@ -755,23 +779,25 @@ async function runAdd(module, options = {}) {
 
   // Show note if any
   if (meta.note) {
-    console.log(kleur.dim(`\n  ${t(meta.note)}\n`));
+    ui.log.message(kleur.dim(t(meta.note)));
   }
 
-  console.log(kleur.green(`\n✓ ${t('add.success', { module: normalized })}\n`));
-
   // LLM Chat: show next steps (adjust based on whether deploy succeeded)
   if (normalized === 'llm_chat') {
     const backend = kitSetup?.backendProvider ?? 'firebase';
     const needsManualDeploy = llmDeployResult?.deployAttempted && !llmDeployResult?.deployOk;
+    let nextStepsMsg;
     if (backend === 'firebase') {
-      console.log(kleur.cyan(t(needsManualDeploy ? 'add.llm_chat.nextSteps.firebase.deployFailed' : 'add.llm_chat.nextSteps.firebase')));
+      nextStepsMsg = t(needsManualDeploy ? 'add.llm_chat.nextSteps.firebase.deployFailed' : 'add.llm_chat.nextSteps.firebase');
     } else if (backend === 'supabase') {
-      console.log(kleur.cyan(t(needsManualDeploy ? 'add.llm_chat.nextSteps.supabase.deployFailed' : 'add.llm_chat.nextSteps.supabase')));
+      nextStepsMsg = t(needsManualDeploy ? 'add.llm_chat.nextSteps.supabase.deployFailed' : 'add.llm_chat.nextSteps.supabase');
     } else {
-      console.log(kleur.cyan(t('add.llm_chat.nextSteps.api')));
+      nextStepsMsg = t('add.llm_chat.nextSteps.api');
     }
+    ui.log.info(nextStepsMsg);
   }
+
+  ui.outro(t('add.success', { module: normalized }));
 }
 
 module.exports = { runAdd };