kasy-cli 1.5.3 → 1.7.0

package/lib/commands/update.js

@@ -6,8 +6,8 @@ const path = require('node:path');
 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,
@@ -22,7 +22,6 @@ const { buildTokens } = require('../scaffold/backends/firebase/tokens');
 const { localizeReleaseDocs } = require('../scaffold/shared/generator-utils');
 
 const execAsync = promisify(exec);
-const ora = oraPackage.default || oraPackage;
 
 const CHANGELOG_PATH = path.join(__dirname, '..', 'scaffold', 'CHANGELOG.json');
 
@@ -146,6 +145,7 @@ async function getActiveModules(kitSetup, projectDir) {
 async function runUpdate(module, options = {}) {
   const t = createTranslator(options.language || detectDefaultLanguage());
   const projectDir = path.resolve(options.directory || '.');
+  const cancel = () => { ui.cancel(t('update.cancelled')); process.exit(0); };
 
   // 1. Must be inside a kasy project
   const kitSetupPath = path.join(projectDir, 'kit_setup.json');
@@ -170,93 +170,98 @@ async function runUpdate(module, options = {}) {
   if (module) {
     const normalizedTarget = normalizeUpdateTarget(module);
     if (normalizedTarget === COMPONENTS_UPDATE_TARGET) {
+      printCompactHeader(t);
+      ui.intro(t('update.applyingComponents'));
       if (!options.yes) {
-        console.log(kleur.yellow(`\n  ⚠  ${t('update.warn.commitComponents')}\n`));
-        const { confirmed } = await prompts(
-          {
-            type: 'confirm',
-            name: 'confirmed',
-            message: t('update.confirmComponents'),
-            initial: false,
-          },
-          { onCancel: () => { throw new Error(t('update.cancelled')); } }
-        );
+        ui.log.warn(t('update.warn.commitComponents'));
+        const confirmed = await ui.confirm({
+          message: t('update.confirmComponents'),
+          initialValue: false,
+          onCancel: cancel,
+        });
         if (!confirmed) {
-          console.log(kleur.dim(`\n${t('update.cancelled')}\n`));
+          ui.outro(t('update.cancelled'));
           return;
         }
       }
 
-      console.log('');
-      const spinner = ora(t('update.applyingComponents')).start();
+      const spinner = ui.spinner();
+      spinner.start(t('update.applyingComponents'));
       try {
         const filesApplied = await applyBaseComponents(projectDir);
         if (filesApplied === 0) {
-          spinner.warn(t('update.noComponentFiles'));
+          spinner.stop(`⚠ ${t('update.noComponentFiles')}`);
+          ui.outro(t('update.cancelled'));
           return;
         }
-        spinner.succeed(t('update.appliedComponents', { count: filesApplied }));
+        spinner.stop(t('update.appliedComponents', { count: filesApplied }));
       } catch (err) {
-        spinner.fail(t('update.applyComponentsFailed'));
+        spinner.error(t('update.applyComponentsFailed'));
         throw err;
       }
 
       {
-        const spinnerPubGet = ora(t('update.pubGet')).start();
+        const spinnerPubGet = ui.spinner();
+        spinnerPubGet.start(t('update.pubGet'));
         try {
           await execAsync('flutter pub get', { cwd: projectDir, timeout: 300_000 });
-          spinnerPubGet.succeed(t('update.pubGetDone'));
+          spinnerPubGet.stop(t('update.pubGetDone'));
         } catch {
-          spinnerPubGet.warn(t('update.pubGetFailed'));
+          spinnerPubGet.stop(`⚠ ${t('update.pubGetFailed')}`);
         }
       }
 
       kitSetup.cliVersion = currentVersion;
       await fs.outputFile(kitSetupPath, JSON.stringify(kitSetup, null, 2) + '\n', 'utf8');
-      console.log(kleur.green(`\n✓ ${t('update.componentsSuccess')}\n`));
+      ui.outro(t('update.componentsSuccess'));
       return;
     }
 
     if (normalizedTarget === CORE_UPDATE_TARGET) {
+      printCompactHeader(t);
+      ui.intro(t('update.applyingCore'));
       if (!options.yes) {
-        console.log(kleur.yellow(`\n  ⚠  ${t('update.warn.commitComponents')}\n`));
-        const { confirmed } = await prompts(
-          { type: 'confirm', name: 'confirmed', message: t('update.confirmCore'), initial: false },
-          { onCancel: () => { throw new Error(t('update.cancelled')); } }
-        );
+        ui.log.warn(t('update.warn.commitComponents'));
+        const confirmed = await ui.confirm({
+          message: t('update.confirmCore'),
+          initialValue: false,
+          onCancel: cancel,
+        });
         if (!confirmed) {
-          console.log(kleur.dim(`\n${t('update.cancelled')}\n`));
+          ui.outro(t('update.cancelled'));
           return;
         }
       }
 
-      console.log('');
-      const spinner = ora(t('update.applyingCore')).start();
+      const spinner = ui.spinner();
+      spinner.start(t('update.applyingCore'));
       try {
         const filesApplied = await applyCoreFiles(projectDir);
         if (filesApplied === 0) {
-          spinner.warn(t('update.noComponentFiles'));
+          spinner.stop(`⚠ ${t('update.noComponentFiles')}`);
+          ui.outro(t('update.cancelled'));
           return;
         }
-        spinner.succeed(t('update.appliedCore', { count: filesApplied }));
+        spinner.stop(t('update.appliedCore', { count: filesApplied }));
       } catch (err) {
-        spinner.fail(t('update.applyComponentsFailed'));
+        spinner.error(t('update.applyComponentsFailed'));
         throw err;
       }
 
       {
-        const spinnerPubGet = ora(t('update.pubGet')).start();
+        const spinnerPubGet = ui.spinner();
+        spinnerPubGet.start(t('update.pubGet'));
         try {
           await execAsync('flutter pub get', { cwd: projectDir, timeout: 300_000 });
-          spinnerPubGet.succeed(t('update.pubGetDone'));
+          spinnerPubGet.stop(t('update.pubGetDone'));
         } catch {
-          spinnerPubGet.warn(t('update.pubGetFailed'));
+          spinnerPubGet.stop(`⚠ ${t('update.pubGetFailed')}`);
         }
       }
 
       kitSetup.cliVersion = currentVersion;
       await fs.outputFile(kitSetupPath, JSON.stringify(kitSetup, null, 2) + '\n', 'utf8');
-      console.log(kleur.green(`\n✓ ${t('update.coreSuccess')}\n`));
+      ui.outro(t('update.coreSuccess'));
       return;
     }
 
@@ -265,24 +270,22 @@ async function runUpdate(module, options = {}) {
       if (!(await fs.pathExists(patchDir))) {
         throw new Error(t('update.error.noIosReleasePatch'));
       }
+      printCompactHeader(t);
+      ui.intro(t('update.applying', { module: IOS_RELEASE_UPDATE_TARGET }));
       if (!options.yes) {
-        console.log(kleur.yellow(`\n  ⚠  ${t('update.warn.commit', { module: IOS_RELEASE_UPDATE_TARGET })}\n`));
-        const { confirmed } = await prompts(
-          {
-            type: 'confirm',
-            name: 'confirmed',
-            message: t('update.confirm', { module: IOS_RELEASE_UPDATE_TARGET }),
-            initial: false,
-          },
-          { onCancel: () => { throw new Error(t('update.cancelled')); } }
-        );
+        ui.log.warn(t('update.warn.commit', { module: IOS_RELEASE_UPDATE_TARGET }));
+        const confirmed = await ui.confirm({
+          message: t('update.confirm', { module: IOS_RELEASE_UPDATE_TARGET }),
+          initialValue: false,
+          onCancel: cancel,
+        });
         if (!confirmed) {
-          console.log(kleur.dim(`\n${t('update.cancelled')}\n`));
+          ui.outro(t('update.cancelled'));
           return;
         }
       }
-      console.log('');
-      const spinner = ora(t('update.applying', { module: IOS_RELEASE_UPDATE_TARGET })).start();
+      const spinner = ui.spinner();
+      spinner.start(t('update.applying', { module: IOS_RELEASE_UPDATE_TARGET }));
       try {
         const { tokens, pathReplacements } = buildTokens({
           appName: kitSetup.appName,
@@ -290,14 +293,14 @@ async function runUpdate(module, options = {}) {
         });
         await applyPatch(patchDir, projectDir, tokens, pathReplacements);
         await localizeReleaseDocs(projectDir, options.language || detectDefaultLanguage());
-        spinner.succeed(t('update.iosRelease.success'));
+        spinner.stop(t('update.iosRelease.success'));
       } catch (err) {
-        spinner.fail(t('update.applyFailed', { module: IOS_RELEASE_UPDATE_TARGET }));
+        spinner.error(t('update.applyFailed', { module: IOS_RELEASE_UPDATE_TARGET }));
         throw err;
       }
       kitSetup.cliVersion = currentVersion;
       await fs.outputFile(kitSetupPath, JSON.stringify(kitSetup, null, 2) + '\n', 'utf8');
-      console.log('');
+      ui.outro(t('update.iosRelease.success'));
       return;
     }
 
@@ -311,74 +314,76 @@ async function runUpdate(module, options = {}) {
       );
     }
     if (!activeModules.includes(normalized)) {
-      console.log(kleur.yellow(`\n${t('update.error.notActive', { module: normalized })}\n`));
+      printCompactHeader(t);
+      ui.log.warn(t('update.error.notActive', { module: normalized }));
       return;
     }
 
     const patchDir = path.join(FEATURES_PATCH_DIR, normalized);
     if (!(await fs.pathExists(patchDir))) {
-      console.log(kleur.dim(`\n  ${t('update.noPatch', { module: normalized })}\n`));
+      printCompactHeader(t);
+      ui.log.message(kleur.dim(t('update.noPatch', { module: normalized })));
       return;
     }
 
+    printCompactHeader(t);
+    ui.intro(t('update.applying', { module: normalized }));
+
     // Warn and confirm
     if (!options.yes) {
-      console.log(kleur.yellow(`\n  ⚠  ${t('update.warn.commit', { module: normalized })}\n`));
-      const { confirmed } = await prompts(
-        {
-          type: 'confirm',
-          name: 'confirmed',
-          message: t('update.confirm', { module: normalized }),
-          initial: false,
-        },
-        { onCancel: () => { throw new Error(t('update.cancelled')); } }
-      );
+      ui.log.warn(t('update.warn.commit', { module: normalized }));
+      const confirmed = await ui.confirm({
+        message: t('update.confirm', { module: normalized }),
+        initialValue: false,
+        onCancel: cancel,
+      });
       if (!confirmed) {
-        console.log(kleur.dim(`\n${t('update.cancelled')}\n`));
+        ui.outro(t('update.cancelled'));
         return;
       }
     }
 
-    console.log('');
-
     // Re-apply patch
     {
-      const spinner = ora(t('update.applying', { module: normalized })).start();
+      const spinner = ui.spinner();
+      spinner.start(t('update.applying', { module: normalized }));
       try {
         const { tokens, pathReplacements } = buildTokens({
           appName: kitSetup.appName,
           bundleId: kitSetup.bundleId,
         });
         await applyPatch(patchDir, projectDir, tokens, pathReplacements);
-        spinner.succeed(t('update.applied', { module: normalized }));
+        spinner.stop(t('update.applied', { module: normalized }));
       } catch (err) {
-        spinner.fail(t('update.applyFailed', { module: normalized }));
+        spinner.error(t('update.applyFailed', { module: normalized }));
         throw err;
       }
     }
 
     // flutter pub get
     {
-      const spinner = ora(t('update.pubGet')).start();
+      const spinner = ui.spinner();
+      spinner.start(t('update.pubGet'));
       try {
         await execAsync('flutter pub get', { cwd: projectDir, timeout: 300_000 });
-        spinner.succeed(t('update.pubGetDone'));
+        spinner.stop(t('update.pubGetDone'));
       } catch {
-        spinner.warn(t('update.pubGetFailed'));
+        spinner.stop(`⚠ ${t('update.pubGetFailed')}`);
       }
     }
 
     // build_runner (only for modules that generate code)
     if (NEEDS_BUILD_RUNNER.includes(normalized)) {
-      const spinner = ora(t('update.buildRunner')).start();
+      const spinner = ui.spinner();
+      spinner.start(t('update.buildRunner'));
       try {
         await execAsync(
           'dart run build_runner build --delete-conflicting-outputs',
           { cwd: projectDir, timeout: 600_000 }
         );
-        spinner.succeed(t('update.buildRunnerDone'));
+        spinner.stop(t('update.buildRunnerDone'));
       } catch {
-        spinner.warn(t('update.buildRunnerFailed'));
+        spinner.stop(`⚠ ${t('update.buildRunnerFailed')}`);
       }
     }
 
@@ -386,7 +391,7 @@ async function runUpdate(module, options = {}) {
     kitSetup.cliVersion = currentVersion;
     await fs.outputFile(kitSetupPath, JSON.stringify(kitSetup, null, 2) + '\n', 'utf8');
 
-    console.log(kleur.green(`\n✓ ${t('update.success', { module: normalized })}\n`));
+    ui.outro(t('update.success', { module: normalized }));
     return;
   }
 
@@ -404,25 +409,26 @@ async function runUpdate(module, options = {}) {
   }
 
   if (alreadyUpToDate && Object.keys(changes).length === 0) {
-    console.log(kleur.green(`\n✓ ${t('update.alreadyUpToDate', { version: currentVersion })}\n`));
+    printCompactHeader(t);
+    ui.outro(t('update.alreadyUpToDate', { version: currentVersion }));
     return;
   }
 
-  // Header
+  printCompactHeader(t);
   const fromLabel = projectVersion || '?';
-  console.log(`\n${t('update.status', { from: fromLabel, to: currentVersion })}\n`);
+  ui.intro(t('update.status', { from: fromLabel, to: currentVersion }));
 
   // Modules/components with actual changelog entries — show what improved + the command
   const modulesWithChanges = Object.keys(changes);
   if (modulesWithChanges.length > 0) {
-    console.log(kleur.bold(t('update.changesTitle')));
+    const lines = [kleur.bold(t('update.changesTitle'))];
     for (const mod of modulesWithChanges) {
       for (const { description } of changes[mod]) {
-        console.log(`  ${kleur.cyan('✦')} ${kleur.bold(mod)}  ${kleur.dim('→')}  ${kleur.cyan(`kasy update ${mod}`)}`);
-        console.log(`    ${kleur.dim(description)}`);
+        lines.push(`${kleur.cyan('✦')} ${kleur.bold(mod)}  ${kleur.dim('→')}  ${kleur.cyan(`kasy update ${mod}`)}`);
+        lines.push(`  ${kleur.dim(description)}`);
       }
     }
-    console.log('');
+    ui.log.message(lines.join('\n'));
   }
 
   // Modules without changelog entries that can still be re-applied (advanced / recovery)
@@ -431,27 +437,29 @@ async function runUpdate(module, options = {}) {
 
   if (modulesWithChanges.length === 0 && !hasComponentChanges) {
     // Nothing new — show everything available
+    const lines = [];
     if (patchableModules.length > 0) {
-      console.log(t('update.howToUpdate'));
+      lines.push(t('update.howToUpdate'));
       for (const m of patchableModules) {
-        console.log(kleur.cyan(`  kasy update ${m}`));
+        lines.push(kleur.cyan(`  kasy update ${m}`));
       }
-      console.log('');
+      lines.push('');
     }
-    console.log(t('update.howToUpdateComponents'));
-    console.log(kleur.cyan(`  kasy update ${COMPONENTS_UPDATE_TARGET}`));
-    console.log('');
+    lines.push(t('update.howToUpdateComponents'));
+    lines.push(kleur.cyan(`  kasy update ${COMPONENTS_UPDATE_TARGET}`));
+    ui.log.message(lines.join('\n'));
   } else if (modulesWithoutChanges.length > 0) {
     // Some modules have no new changes — show as secondary info
-    console.log(kleur.dim(t('update.reapplyTitle')));
+    const lines = [kleur.dim(t('update.reapplyTitle'))];
     for (const m of modulesWithoutChanges) {
-      console.log(kleur.dim(`  kasy update ${m}`));
+      lines.push(kleur.dim(`  kasy update ${m}`));
     }
     if (!hasComponentChanges) {
-      console.log(kleur.dim(`  kasy update ${COMPONENTS_UPDATE_TARGET}`));
+      lines.push(kleur.dim(`  kasy update ${COMPONENTS_UPDATE_TARGET}`));
     }
-    console.log('');
+    ui.log.message(lines.join('\n'));
   }
+  ui.outro('');
 }
 
 module.exports = { runUpdate };

package/lib/commands/validate.js

@@ -2,6 +2,8 @@ const path = require('node:path');
 const { promisify } = require('node:util');
 const { execFile } = require('node:child_process');
 const kleur = require('kleur');
+const ui = require('../utils/ui');
+const { printCompactHeader } = require('../utils/brand');
 const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
 const { pathExists } = require('../utils/fs');
 
@@ -58,12 +60,16 @@ async function runValidate({ language, analyzeOnly = false } = {}) {
   ).then(() => true).catch(() => false);
 
   if (!anyExists) {
-    console.log(kleur.yellow('\n⚠ kasy validate is only available in the Kasy development environment.'));
-    console.log(kleur.gray('  Generate test projects with `kasy new` first, then run this command.\n'));
+    printCompactHeader(t);
+    ui.intro(t('validate.title'));
+    ui.log.warn('kasy validate is only available in the Kasy development environment.');
+    ui.log.message(kleur.dim('Generate test projects with `kasy new` first, then run this command.'));
+    ui.outro('Skipped');
     return;
   }
 
-  console.log(kleur.bold(`\n${t('validate.title')}\n`));
+  printCompactHeader(t);
+  ui.intro(t('validate.title'));
 
   const commands = buildCommandsForPlatform(analyzeOnly);
   const failures = [];
@@ -75,54 +81,53 @@ async function runValidate({ language, analyzeOnly = false } = {}) {
     if (!exists) {
       const projectName = path.basename(combo.projectPath);
       failures.push({ combo: combo.id, reason: `${t('validate.projectNotFound')}: ${combo.projectPath}` });
-      console.log(kleur.red(`✗ ${label}`));
-      console.log(kleur.gray(`  ${combo.projectPath}`));
-      console.log(
+      ui.log.error(label);
+      ui.log.message(
+        `${kleur.dim(combo.projectPath)}\n` +
         kleur.yellow(
-          `  ⚠ Projeto base não encontrado. Gere-o antes de validar:\n` +
-          `    kasy new ${projectName} --backend ${combo.backend}\n` +
-          `  O projeto deve ser gerado uma vez e mantido localmente para CI.`
+          `⚠ Projeto base não encontrado. Gere-o antes de validar:\n` +
+          `   kasy new ${projectName} --backend ${combo.backend}\n` +
+          `   O projeto deve ser gerado uma vez e mantido localmente para CI.`
         )
       );
       continue;
     }
 
-    console.log(kleur.cyan(`• ${label}`));
-    console.log(kleur.gray(`  ${combo.projectPath}`));
+    ui.log.step(`${kleur.cyan('•')} ${label}\n${kleur.dim(combo.projectPath)}`);
 
     let comboFailed = false;
     for (const [cmd, args] of commands) {
       const printable = `${cmd} ${args.join(' ')}`;
-      process.stdout.write(kleur.gray(`  - ${printable} ... `));
-
+      const spinner = ui.spinner();
+      spinner.start(printable);
       try {
         await runCommand(cmd, args, combo.projectPath);
-        process.stdout.write(`${kleur.green(t('validate.ok'))}\n`);
+        spinner.stop(`${printable} ${kleur.green(t('validate.ok'))}`);
       } catch (error) {
         comboFailed = true;
         failures.push({
           combo: combo.id,
           reason: `${printable} ${t('validate.fail')}`
         });
-        process.stdout.write(`${kleur.red(t('validate.fail'))}\n`);
+        spinner.error(`${printable} ${t('validate.fail')}`);
         break;
       }
     }
 
     if (!comboFailed) {
-      console.log(kleur.green(`  ✓ ${combo.id} ${t('validate.passed')}`));
+      ui.log.success(`${combo.id} ${t('validate.passed')}`);
     }
   }
 
   if (failures.length > 0) {
-    console.log(kleur.red(`\n${t('validate.failed')}`));
+    ui.log.error(t('validate.failed'));
     failures.forEach((failure) => {
-      console.log(kleur.red(`- ${failure.combo}: ${failure.reason}`));
+      ui.log.error(`- ${failure.combo}: ${failure.reason}`);
     });
     throw new Error(t('validate.error'));
   }
 
-  console.log(kleur.green(`\n${t('validate.success')}`));
+  ui.outro(t('validate.success'));
 }
 
 module.exports = {

package/lib/scaffold/catalog.js

@@ -25,26 +25,58 @@ const AVAILABLE_BACKENDS = [
  *
  * availableIn: backends that support this feature
  * defaultInPresets: which named presets include this feature by default
+ * displayName:    user-facing label shown in CLI listings (Title Case, English)
+ * tag:            optional restriction tag — `firebaseOnly` or `requiresDb` —
+ *                 rendered as a colored badge in CLI listings
+ * enhances:       id of a base feature this optional feature activates real
+ *                 functionality for. Example: `revenuecat` enhances
+ *                 `subscription` — the Subscriptions screen exists in the base
+ *                 project but only sells real plans once RevenueCat is added.
+ *
+ * Note on id vs folder name (intentional, not a bug):
+ *   - id `local_notifications` → folder `lib/features/local_reminder/`
+ *   - id `feedback`            → folder `lib/features/feedbacks/`
+ *   The id describes the user-facing capability; the folder describes the
+ *   Dart component. The generator (see generator-utils.js writeRouter and
+ *   the cleanup step around feature dirs) removes these folders when the
+ *   feature is not selected.
  */
 const FEATURE_CATALOG = [
   // integrations
-  { id: 'sentry',              status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['starter', 'saas', 'content', 'full'] },
-  { id: 'analytics',           status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['starter', 'saas', 'content', 'full'] },
-  { id: 'facebook',            status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['full'] },
+  { id: 'sentry',              displayName: 'Crash Reports (Sentry)', status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['starter', 'saas', 'content', 'full'] },
+  { id: 'analytics',           displayName: 'Analytics',              status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['starter', 'saas', 'content', 'full'] },
+  { id: 'facebook',            displayName: 'Facebook (Login + Ads)', status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['full'] },
   // monetization
-  { id: 'revenuecat',          status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['saas', 'full'] },
+  { id: 'revenuecat',          displayName: 'RevenueCat',             status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['saas', 'full'], enhances: 'subscription' },
   // features
-  { id: 'onboarding',          status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['starter', 'saas', 'content', 'full'] },
-  { id: 'web',                 status: 'public',   availableIn: ['firebase'],                    defaultInPresets: [] },
-  { id: 'widget',              status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['full'] },
-  { id: 'llm_chat',            status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['content', 'full'] },
-  { id: 'local_notifications', status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: [] },
+  { id: 'onboarding',          displayName: 'Onboarding',             status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['starter', 'saas', 'content', 'full'] },
+  { id: 'web',                 displayName: 'Web Support (PWA)',      status: 'public',   availableIn: ['firebase'],                    defaultInPresets: [], tag: 'firebaseOnly' },
+  { id: 'widget',              displayName: 'Home Widget',            status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['full'] },
+  { id: 'llm_chat',            displayName: 'AI Chat',                status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['content', 'full'] },
+  { id: 'local_notifications', displayName: 'Local Reminders',        status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: [] },
   // feedback (Firebase/Supabase only)
-  { id: 'feedback',            status: 'public',   availableIn: ['firebase', 'supabase'],        defaultInPresets: ['saas', 'full'] },
+  { id: 'feedback',            displayName: 'Feature Requests',       status: 'public',   availableIn: ['firebase', 'supabase'],        defaultInPresets: ['saas', 'full'], tag: 'requiresDb' },
   // ci/cd
-  { id: 'ci',                  status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['full'] },
+  { id: 'ci',                  displayName: 'CI/CD',                  status: 'public',   availableIn: ['firebase', 'supabase', 'api'], defaultInPresets: ['full'] },
 ];
 
+/**
+ * Base features — always present in every generated project.
+ * These cannot be added or removed via `kasy add` / `kasy remove`.
+ * Listed in the CLI so users understand what ships with every project.
+ */
+const BASE_FEATURES = [
+  { id: 'authentication', displayName: 'Auth' },
+  { id: 'home',           displayName: 'Home Screen' },
+  { id: 'settings',       displayName: 'Settings Screen' },
+  { id: 'notifications',  displayName: 'Push Notifications' },
+  { id: 'subscription',   displayName: 'Subscriptions' },
+];
+
+function getBaseFeatures() {
+  return BASE_FEATURES;
+}
+
 /**
  * Returns features visible to the given audience, optionally filtered by backend.
  *
@@ -215,6 +247,7 @@ module.exports = {
   FEATURES_PATCH_DIR,
   AVAILABLE_BACKENDS,
   FEATURE_CATALOG,
+  BASE_FEATURES,
   AVAILABLE_FEATURES,
   DEFAULT_FEATURES,
   BASE_COMPONENT_FILES,
@@ -223,4 +256,5 @@ module.exports = {
   normalizeFeature,
   parseFeatureList,
   getVisibleFeatures,
+  getBaseFeatures,
 };

package/lib/scaffold/features/README.md

@@ -21,7 +21,7 @@ features/
       ...
 ```
 
-Cada subdiretório tem o **mesmo nome** que o valor do módulo em `new.js` (`sentry`, `analytics`, `facebook`, `revenuecat`, `onboarding`, `web`, `widget`, `camera`, `llm_chat`, `feedback`, `ci`).
+Cada subdiretório tem o **mesmo nome** que o valor do módulo em `new.js` (`sentry`, `analytics`, `facebook`, `revenuecat`, `onboarding`, `web`, `widget`, `llm_chat`, `local_notifications`, `feedback`, `ci`).
 
 Ao gerar um projeto, o engine copia recursivamente o conteúdo de `features/{modulo}/` para a raiz do projeto, sobrescrevendo ou acrescentando arquivos.
 
@@ -32,7 +32,6 @@ Ao gerar um projeto, o engine copia recursivamente o conteúdo de `features/{mod
 | `ci`        | ✅ Sim            | Adiciona `.github/`, `.gitlab-ci.yml`, etc.         |
 | `web`       | ✅ Sim            | Adiciona pasta `web/` e configurações de plataforma |
 | `widget`    | ✅ Sim            | Adiciona configurações Android para home widgets    |
-| `camera`    | Opcional          | Permissões extras no AndroidManifest / Info.plist   |
 | `llm_chat`  | Não               | Apenas `LLM_CHAT_ENDPOINT` via dart-define. A chave da API LLM fica no servidor (Firebase Secret / Supabase Secret) — nunca no app. |
 | `sentry`    | Não               | Apenas dart-define (`SENTRY_DSN`)                   |
 | `analytics` | Não               | Apenas dart-define                                  |

package/lib/scaffold/shared/generator-utils.js

@@ -985,7 +985,7 @@ async function writeMainDart(projectDir, backend, modules, packageName, options
  * directories for modules the user did not select to avoid dead code.
  *
  * @param {string} projectDir
- * @param {string[]} modules - Selected modules (e.g. ['camera', 'analytics'])
+ * @param {string[]} modules - Selected modules (e.g. ['analytics', 'sentry'])
  */
 async function removeModuleDirs(projectDir, modules) {
   const removable = [