kasy-cli 1.6.0 → 1.7.1

package/bin/kasy.js

@@ -277,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)', '.')
@@ -291,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'))

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

@@ -13,8 +13,15 @@ const {
   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');
@@ -489,12 +496,30 @@ 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);
-    lines.push(`${icon}  ${label}${badge}`);
+    const label = active ? kleur.green(feature.displayName) : kleur.white(feature.displayName);
+    lines.push(`${icon}  ${label}${tagBadge}${enhancesBadge}${betaBadge}`);
   }
   ui.note(lines.join('\n'), t('add.list.title'));
 }

package/lib/commands/features.js

@@ -4,9 +4,16 @@ 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 = {}) {
@@ -21,10 +28,22 @@ function runFeatures(options = {}) {
   );
   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 badge = feature.status === 'internal' ? kleur.yellow(' [beta]') : '';
-    return `${kleur.cyan('•')} ${kleur.white(feature.id)}${badge} - ${kleur.gray(
+    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`)
     )}`;
   });

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 = [

package/lib/utils/i18n.js

@@ -34,7 +34,7 @@ const MESSAGES = {
     'cli.command.setup.langName': 'lang',
     'cli.command.setup.langOption': 'Prompt language (en, pt, es)',
     'cli.command.setup.backendOption': 'Backend adapter (firebase, supabase, api)',
-    'cli.command.setup.featuresOption': 'Comma separated optional features (web,widget,camera,llm_chat,revenuecat,ci)',
+    'cli.command.setup.featuresOption': 'Comma separated optional features (web,widget,llm_chat,revenuecat,ci)',
     'cli.command.help.paramName': 'command',
     'cli.command.doctor.description': '🩺 Check environment and dependencies',
     'cli.command.modules.description': '🧩 List available backend and features',
@@ -73,22 +73,31 @@ const MESSAGES = {
     'doctor.requiredMissing': 'Missing required dependencies. Fix the errors above and rerun doctor.',
     'doctor.requiredPassed': '✓ Required environment checks passed.',
     'modules.backends': 'Available backends:',
-    'modules.features': 'Available optional features:',
+    'modules.featuresBase': 'Always included:',
+    'modules.features': 'Optional features:',
+    'modules.tag.firebaseOnly': 'Firebase only',
+    'modules.tag.requiresDb': 'requires Firebase or Supabase',
+    'modules.tag.enhances': 'enables {target}',
+    'modules.hint.subscriptionNoRc': 'Tip: Subscriptions screen is included but inactive. Run `kasy add revenuecat` to enable real payments.',
+    'modules.feature.base.authentication.description': 'Sign up, login and account management',
+    'modules.feature.base.home.description': 'Main app screen after login',
+    'modules.feature.base.settings.description': 'Theme, language, account and preferences',
+    'modules.feature.base.notifications.description': 'Push notifications via Firebase Cloud Messaging (works with any backend)',
+    'modules.feature.base.subscription.description': 'Premium subscription screen and data model (add RevenueCat to enable real payments)',
     'modules.backend.firebase.description': 'Firebase backend adapter',
     'modules.backend.supabase.description': 'Supabase backend adapter',
     'modules.backend.api.description': 'REST/GraphQL API backend adapter',
     'modules.feature.sentry.description': 'Sentry error tracking and crash reporting',
     'modules.feature.analytics.description': 'Analytics event tracking (Firebase Analytics)',
-    'modules.feature.facebook.description': 'Facebook Login integration',
-    'modules.feature.revenuecat.description': 'RevenueCat subscriptions integration',
-    'modules.feature.onboarding.description': 'Onboarding flow feature',
-    'modules.feature.web.description': 'Web compatibility layer',
-    'modules.feature.widget.description': 'iOS/Android home widget integration',
-    'modules.feature.camera.description': 'Camera feature template',
-    'modules.feature.llm_chat.description': 'LLM chat feature template',
-    'modules.feature.feedback.description': 'User feedback and feature requests feature',
-    'modules.feature.local_notifications.description': 'Local reminders — user-scheduled notifications (iOS & Android only)',
-    'modules.feature.ci.description': 'CI: GitHub/GitLab (tests + build) + Codemagic (publish to stores)',
+    'modules.feature.facebook.description': 'Facebook Login and Meta Ads event tracking (always bundled together)',
+    'modules.feature.revenuecat.description': 'Enables real in-app payments on the Subscriptions screen',
+    'modules.feature.onboarding.description': 'Welcome flow shown on first launch',
+    'modules.feature.web.description': 'Web/PWA support',
+    'modules.feature.widget.description': 'iOS/Android home screen widget integration',
+    'modules.feature.llm_chat.description': 'AI chat screen with OpenAI or Gemini',
+    'modules.feature.feedback.description': 'In-app feature requests and voting',
+    'modules.feature.local_notifications.description': 'Local reminders scheduled by the user (no server required)',
+    'modules.feature.ci.description': 'CI/CD: GitHub/GitLab (tests + build) + Codemagic (publish to stores)',
     'checks.checking': 'Checking {name}...',
     'checks.found': '{name} found',
     'checks.foundWithVersion': '{name} ready ({version})',
@@ -248,7 +257,7 @@ const MESSAGES = {
     'new.q.preset': 'Which features to include?',
     'new.q.preset.starter': '⚡ Starter — analytics + crash reports + onboarding',
     'new.q.preset.saas': '💰 SaaS — subscriptions + analytics + onboarding + feedback',
-    'new.q.preset.content': '📱 Content — analytics + onboarding + camera + LLM chat',
+    'new.q.preset.content': '📱 Content — crash reports + analytics + onboarding + AI chat',
     'new.q.preset.full': '🚀 Full — all features',
     'new.q.preset.custom': '⚙️  Custom — choose features one by one',
     'new.q.preset.none': '○  None — just the core',
@@ -411,18 +420,17 @@ const MESSAGES = {
     'new.modules.header.feedback': '── Feedback (Firebase + Supabase) ──',
     'new.modules.header.ci': '── CI/CD ──',
     'new.modules.header.monetization': '── Monetization ──',
-    'new.firebase.module.revenuecat': '💰 In-app subscriptions (RevenueCat)',
-    'new.firebase.module.sentry': '🚨 Crash reporting (Sentry)',
+    'new.firebase.module.revenuecat': '💰 RevenueCat (enables Subscriptions)',
+    'new.firebase.module.sentry': '🚨 Crash Reports (Sentry)',
     'new.firebase.module.analytics': '📊 Analytics (Mixpanel)',
-    'new.firebase.module.facebook': '👤 Facebook login (requires App ID + Token)',
-    'new.firebase.module.web': '🌐 Web (add browser support — iOS/Android always included)',
-    'new.firebase.module.widget': '📱 Home widget (iOS/Android)',
-    'new.firebase.module.camera': '📷 Camera feature',
-    'new.firebase.module.llm_chat': '🤖 LLM chat feature',
-    'new.firebase.module.local_notifications': '🔔 Local reminders — user-scheduled notifications (iOS & Android only)',
-    'new.firebase.module.feedback': '💬 Feedback / feature requests',
-    'new.firebase.module.ci': '⚙️ CI: GitHub/GitLab (tests + build) + Codemagic (publish to stores)',
-    'new.firebase.module.onboarding': '👋 Onboarding (welcome screens, profile questions)',
+    'new.firebase.module.facebook': '👤 Facebook (Login + Ads)',
+    'new.firebase.module.web': '🌐 Web Support (PWA, Firebase only)',
+    'new.firebase.module.widget': '📱 Home Widget (iOS/Android)',
+    'new.firebase.module.llm_chat': '🤖 AI Chat (OpenAI/Gemini)',
+    'new.firebase.module.local_notifications': '🔔 Local Reminders (no server)',
+    'new.firebase.module.feedback': '💬 Feature Requests (requires Firebase or Supabase)',
+    'new.firebase.module.ci': '⚙️ CI/CD (GitHub + Codemagic)',
+    'new.firebase.module.onboarding': '👋 Onboarding (welcome flow)',
 
     'new.firebase.q.secrets.configureNow': 'Configure server secrets now? (RevenueCat webhook, Meta Ads)',
     'new.firebase.q.secrets.configureNow.hint': 'If not now, see the README for commands to add them later',
@@ -633,7 +641,7 @@ const MESSAGES = {
     'notifications.summary.demo': 'Home → Features (demo):',
     'notifications.summary.reminder': 'Settings → Reminders (scheduled):',
 
-    'add.list.title': 'Available features (✓ = already active)',
+    'add.list.title': 'Project features',
     'add.error.noModule': 'Provide a feature name or use --list to see available features.',
     'add.error.notKasyProject': 'No kit_setup.json found. Run this command from inside a Kasy project.',
     'add.error.unknownModule': 'Unknown feature: {module}\nAvailable: {list}',
@@ -692,7 +700,7 @@ const MESSAGES = {
     'remove.warn.ci': 'CI files removed. If you had custom workflow files, restore them from git.',
     'remove.warn.sentry.shared': 'sentry_flutter kept — still required by active features (revenuecat/facebook).',
     'cli.command.update.description': '⬆️  Update features/components in an existing project',
-    'cli.command.update.targetArg': 'Target to update (e.g. camera, revenuecat, sentry, components)',
+    'cli.command.update.targetArg': 'Target to update (e.g. revenuecat, sentry, components)',
     'update.error.noProject': 'No kit_setup.json found. Run this command from inside a Kasy project.',
     'update.error.unknownModule': 'Unknown feature: {module}\nAvailable: {list}',
     'update.error.unknownTarget': 'Unknown update target: {module}\nAvailable: {list}',
@@ -759,7 +767,7 @@ const MESSAGES = {
     'cli.command.setup.langName': 'idioma',
     'cli.command.setup.langOption': 'Idioma dos prompts (en, pt, es)',
     'cli.command.setup.backendOption': 'Adapter de backend (firebase, supabase, api)',
-    'cli.command.setup.featuresOption': 'Features opcionais separadas por virgula (web,widget,camera,llm_chat,revenuecat,ci)',
+    'cli.command.setup.featuresOption': 'Features opcionais separadas por virgula (web,widget,llm_chat,revenuecat,ci)',
     'cli.command.help.paramName': 'comando',
     'cli.command.doctor.description': '🩺 Verifica ambiente e dependencias',
     'cli.command.modules.description': '🧩 Lista backends e features disponiveis',
@@ -798,22 +806,31 @@ const MESSAGES = {
     'doctor.requiredMissing': 'Dependencias obrigatorias ausentes. Corrija os erros acima e execute o doctor novamente.',
     'doctor.requiredPassed': '✓ Verificacoes obrigatorias de ambiente aprovadas.',
     'modules.backends': 'Backends disponiveis:',
-    'modules.features': 'Features opcionais disponiveis:',
+    'modules.featuresBase': 'Sempre incluido:',
+    'modules.features': 'Features opcionais:',
+    'modules.tag.firebaseOnly': 'somente Firebase',
+    'modules.tag.requiresDb': 'requer Firebase ou Supabase',
+    'modules.tag.enhances': 'ativa {target}',
+    'modules.hint.subscriptionNoRc': 'Dica: a tela de Subscriptions esta inclusa mas inativa. Rode `kasy add revenuecat` para habilitar pagamentos reais.',
+    'modules.feature.base.authentication.description': 'Cadastro, login e gerenciamento de conta',
+    'modules.feature.base.home.description': 'Tela principal do app apos o login',
+    'modules.feature.base.settings.description': 'Tema, idioma, conta e preferencias',
+    'modules.feature.base.notifications.description': 'Notificacoes push via Firebase Cloud Messaging (funciona com qualquer backend)',
+    'modules.feature.base.subscription.description': 'Tela e modelo de assinatura premium (adicione RevenueCat para habilitar pagamentos reais)',
     'modules.backend.firebase.description': 'Adapter de backend Firebase',
     'modules.backend.supabase.description': 'Adapter de backend Supabase',
     'modules.backend.api.description': 'Adapter de backend API REST/GraphQL',
     'modules.feature.sentry.description': 'Rastreamento de erros e crashes com Sentry',
     'modules.feature.analytics.description': 'Rastreamento de eventos de analytics (Firebase Analytics)',
-    'modules.feature.facebook.description': 'Integracao de Login com Facebook',
-    'modules.feature.revenuecat.description': 'Integracao de assinaturas com RevenueCat',
-    'modules.feature.onboarding.description': 'Feature de fluxo de onboarding',
-    'modules.feature.web.description': 'Camada de compatibilidade Web',
-    'modules.feature.widget.description': 'Integracao de widget iOS/Android',
-    'modules.feature.camera.description': 'Template da feature de camera',
-    'modules.feature.llm_chat.description': 'Template da feature de chat com LLM',
-    'modules.feature.feedback.description': 'Feature de feedback e sugestoes de funcionalidades',
-    'modules.feature.local_notifications.description': 'Lembretes locais — agendados pelo usuario (apenas iOS e Android)',
-    'modules.feature.ci.description': 'CI: GitHub/GitLab (testes + build) + Codemagic (publicacao nas lojas)',
+    'modules.feature.facebook.description': 'Login do Facebook e rastreamento de eventos Meta Ads (vem sempre junto)',
+    'modules.feature.revenuecat.description': 'Habilita pagamentos reais na tela de Subscriptions',
+    'modules.feature.onboarding.description': 'Fluxo de boas-vindas mostrado no primeiro acesso',
+    'modules.feature.web.description': 'Suporte Web/PWA',
+    'modules.feature.widget.description': 'Widget de tela inicial iOS/Android',
+    'modules.feature.llm_chat.description': 'Tela de chat com IA usando OpenAI ou Gemini',
+    'modules.feature.feedback.description': 'Pedidos e votacao de features dentro do app',
+    'modules.feature.local_notifications.description': 'Lembretes locais agendados pelo usuario (sem servidor)',
+    'modules.feature.ci.description': 'CI/CD: GitHub/GitLab (testes + build) + Codemagic (publicacao nas lojas)',
     'checks.checking': 'Verificando {name}...',
     'checks.found': '{name} encontrado',
     'checks.foundWithVersion': '{name} pronto ({version})',
@@ -973,7 +990,7 @@ const MESSAGES = {
     'new.q.preset': 'Quais features incluir?',
     'new.q.preset.starter': '⚡ Starter — analytics + erros + onboarding',
     'new.q.preset.saas': '💰 SaaS — assinaturas + analytics + onboarding + feedback',
-    'new.q.preset.content': '📱 Conteudo — analytics + onboarding + camera + chat LLM',
+    'new.q.preset.content': '📱 Conteudo — crash reports + analytics + onboarding + AI chat',
     'new.q.preset.full': '🚀 Completo — todas as features',
     'new.q.preset.custom': '⚙️  Personalizar — escolha feature a feature',
     'new.q.preset.none': '○  Nenhum — so o core',
@@ -1136,18 +1153,17 @@ const MESSAGES = {
     'new.modules.header.feedback': '── Feedback (Firebase + Supabase) ──',
     'new.modules.header.ci': '── CI/CD ──',
     'new.modules.header.monetization': '── Monetizacao ──',
-    'new.firebase.module.revenuecat': '💰 Assinaturas no app (RevenueCat)',
-    'new.firebase.module.sentry': '🚨 Relatorio de erros (Sentry)',
+    'new.firebase.module.revenuecat': '💰 RevenueCat (ativa Subscriptions)',
+    'new.firebase.module.sentry': '🚨 Crash Reports (Sentry)',
     'new.firebase.module.analytics': '📊 Analytics (Mixpanel)',
-    'new.firebase.module.facebook': '👤 Login com Facebook (requer App ID + Token)',
-    'new.firebase.module.web': '🌐 Web (adicional ao nativo — iOS/Android sempre incluidos)',
-    'new.firebase.module.widget': '📱 Widget na tela inicial (iOS/Android)',
-    'new.firebase.module.camera': '📷 Feature de camera',
-    'new.firebase.module.llm_chat': '🤖 Feature de chat com LLM',
-    'new.firebase.module.local_notifications': '🔔 Lembretes locais — agendados pelo usuario (apenas iOS e Android)',
-    'new.firebase.module.feedback': '💬 Feedback / sugestoes de features',
-    'new.firebase.module.ci': '⚙️ CI: GitHub/GitLab (testes + build) + Codemagic (publicacao nas lojas)',
-    'new.firebase.module.onboarding': '👋 Onboarding (telas de boas-vindas, perguntas de perfil)',
+    'new.firebase.module.facebook': '👤 Facebook (Login + Ads)',
+    'new.firebase.module.web': '🌐 Web Support (PWA, somente Firebase)',
+    'new.firebase.module.widget': '📱 Home Widget (iOS/Android)',
+    'new.firebase.module.llm_chat': '🤖 AI Chat (OpenAI/Gemini)',
+    'new.firebase.module.local_notifications': '🔔 Local Reminders (sem servidor)',
+    'new.firebase.module.feedback': '💬 Feature Requests (requer Firebase ou Supabase)',
+    'new.firebase.module.ci': '⚙️ CI/CD (GitHub + Codemagic)',
+    'new.firebase.module.onboarding': '👋 Onboarding (fluxo de boas-vindas)',
 
     'new.firebase.q.secrets.configureNow': 'Configurar as secrets do servidor agora? (webhook RevenueCat, Meta Ads)',
     'new.firebase.q.secrets.configureNow.hint': 'Se nao agora, veja o README para os comandos de configuracao depois',
@@ -1358,7 +1374,7 @@ const MESSAGES = {
     'notifications.summary.demo': 'Home → Features (demo):',
     'notifications.summary.reminder': 'Configuracoes → Lembretes (agendado):',
 
-    'add.list.title': 'Features disponiveis (✓ = ja ativa)',
+    'add.list.title': 'Features do projeto',
     'add.error.noModule': 'Informe o nome da feature ou use --list para ver as disponiveis.',
     'add.error.notKasyProject': 'kit_setup.json nao encontrado. Execute este comando dentro de um projeto Kasy.',
     'add.error.unknownModule': 'Feature desconhecida: {module}\nDisponiveis: {list}',
@@ -1417,7 +1433,7 @@ const MESSAGES = {
     'remove.warn.ci': 'Arquivos de CI removidos. Se tinha workflows customizados, restaure-os pelo git.',
     'remove.warn.sentry.shared': 'sentry_flutter mantido — ainda necessario para features ativas (revenuecat/facebook).',
     'cli.command.update.description': '⬆️  Atualiza features/componentes em um projeto existente',
-    'cli.command.update.targetArg': 'Alvo para atualizar (ex.: camera, revenuecat, sentry, components)',
+    'cli.command.update.targetArg': 'Alvo para atualizar (ex.: revenuecat, sentry, components)',
     'update.error.noProject': 'kit_setup.json nao encontrado. Execute dentro de um projeto Kasy.',
     'update.error.unknownModule': 'Modulo desconhecido: {module}\nDisponiveis: {list}',
     'update.error.unknownTarget': 'Alvo de atualizacao desconhecido: {module}\nDisponiveis: {list}',
@@ -1484,7 +1500,7 @@ const MESSAGES = {
     'cli.command.setup.langName': 'idioma',
     'cli.command.setup.langOption': 'Idioma de prompts (en, pt, es)',
     'cli.command.setup.backendOption': 'Adapter de backend (firebase, supabase, api)',
-    'cli.command.setup.featuresOption': 'Features opcionales separadas por coma (web,widget,camera,llm_chat,revenuecat,ci)',
+    'cli.command.setup.featuresOption': 'Features opcionales separadas por coma (web,widget,llm_chat,revenuecat,ci)',
     'cli.command.help.paramName': 'comando',
     'cli.command.doctor.description': '🩺 Verifica entorno y dependencias',
     'cli.command.modules.description': '🧩 Lista backends y features disponibles',
@@ -1523,22 +1539,31 @@ const MESSAGES = {
     'doctor.requiredMissing': 'Faltan dependencias obligatorias. Corrige los errores anteriores y ejecuta doctor nuevamente.',
     'doctor.requiredPassed': '✓ Verificaciones obligatorias de entorno aprobadas.',
     'modules.backends': 'Backends disponibles:',
-    'modules.features': 'Features opcionales disponibles:',
+    'modules.featuresBase': 'Siempre incluido:',
+    'modules.features': 'Features opcionales:',
+    'modules.tag.firebaseOnly': 'solo Firebase',
+    'modules.tag.requiresDb': 'requiere Firebase o Supabase',
+    'modules.tag.enhances': 'activa {target}',
+    'modules.hint.subscriptionNoRc': 'Tip: la pantalla de Subscriptions esta incluida pero inactiva. Ejecuta `kasy add revenuecat` para habilitar pagos reales.',
+    'modules.feature.base.authentication.description': 'Registro, inicio de sesion y gestion de cuenta',
+    'modules.feature.base.home.description': 'Pantalla principal de la app despues del login',
+    'modules.feature.base.settings.description': 'Tema, idioma, cuenta y preferencias',
+    'modules.feature.base.notifications.description': 'Notificaciones push via Firebase Cloud Messaging (funciona con cualquier backend)',
+    'modules.feature.base.subscription.description': 'Pantalla y modelo de suscripcion premium (anade RevenueCat para habilitar pagos reales)',
     'modules.backend.firebase.description': 'Adapter de backend Firebase',
     'modules.backend.supabase.description': 'Adapter de backend Supabase',
     'modules.backend.api.description': 'Adapter de backend API REST/GraphQL',
     'modules.feature.sentry.description': 'Seguimiento de errores y crashes con Sentry',
     'modules.feature.analytics.description': 'Seguimiento de eventos de analytics (Firebase Analytics)',
-    'modules.feature.facebook.description': 'Integracion de inicio de sesion con Facebook',
-    'modules.feature.revenuecat.description': 'Integracion de suscripciones con RevenueCat',
-    'modules.feature.onboarding.description': 'Feature de flujo de onboarding',
-    'modules.feature.web.description': 'Capa de compatibilidad Web',
-    'modules.feature.widget.description': 'Integracion de widget iOS/Android',
-    'modules.feature.camera.description': 'Plantilla de la feature de camara',
-    'modules.feature.llm_chat.description': 'Plantilla de la feature de chat con LLM',
-    'modules.feature.feedback.description': 'Feature de feedback y sugerencias de funcionalidades',
-    'modules.feature.local_notifications.description': 'Recordatorios locales — programados por el usuario (solo iOS y Android)',
-    'modules.feature.ci.description': 'CI: GitHub/GitLab (tests + build) + Codemagic (publicacion en tiendas)',
+    'modules.feature.facebook.description': 'Login de Facebook y seguimiento de eventos Meta Ads (siempre juntos)',
+    'modules.feature.revenuecat.description': 'Habilita pagos reales en la pantalla de Subscriptions',
+    'modules.feature.onboarding.description': 'Flujo de bienvenida mostrado en el primer acceso',
+    'modules.feature.web.description': 'Soporte Web/PWA',
+    'modules.feature.widget.description': 'Widget de pantalla inicial iOS/Android',
+    'modules.feature.llm_chat.description': 'Pantalla de chat con IA usando OpenAI o Gemini',
+    'modules.feature.feedback.description': 'Solicitudes y votacion de features dentro de la app',
+    'modules.feature.local_notifications.description': 'Recordatorios locales programados por el usuario (sin servidor)',
+    'modules.feature.ci.description': 'CI/CD: GitHub/GitLab (tests + build) + Codemagic (publicacion en tiendas)',
     'checks.checking': 'Verificando {name}...',
     'checks.found': '{name} encontrado',
     'checks.foundWithVersion': '{name} listo ({version})',
@@ -1700,7 +1725,7 @@ const MESSAGES = {
     'new.q.preset': '¿Qué features incluir?',
     'new.q.preset.starter': '⚡ Starter — analytics + errores + onboarding',
     'new.q.preset.saas': '💰 SaaS — suscripciones + analytics + onboarding + feedback',
-    'new.q.preset.content': '📱 Contenido — analytics + onboarding + camara + chat LLM',
+    'new.q.preset.content': '📱 Contenido — crash reports + analytics + onboarding + AI chat',
     'new.q.preset.full': '🚀 Completo — todas las features',
     'new.q.preset.custom': '⚙️  Personalizar — elige feature a feature',
     'new.q.preset.none': '○  Ninguno — solo el core',
@@ -1861,18 +1886,17 @@ const MESSAGES = {
     'new.modules.header.feedback': '── Feedback (Firebase + Supabase) ──',
     'new.modules.header.ci': '── CI/CD ──',
     'new.modules.header.monetization': '── Monetizacion ──',
-    'new.firebase.module.revenuecat': '💰 Suscripciones en app (RevenueCat)',
-    'new.firebase.module.sentry': '🚨 Reporte de errores (Sentry)',
+    'new.firebase.module.revenuecat': '💰 RevenueCat (activa Subscriptions)',
+    'new.firebase.module.sentry': '🚨 Crash Reports (Sentry)',
     'new.firebase.module.analytics': '📊 Analytics (Mixpanel)',
-    'new.firebase.module.facebook': '👤 Login con Facebook (requiere App ID + Token)',
-    'new.firebase.module.web': '🌐 Web (adicional al nativo — iOS/Android siempre incluidos)',
-    'new.firebase.module.widget': '📱 Widget de inicio (iOS/Android)',
-    'new.firebase.module.camera': '📷 Feature de camara',
-    'new.firebase.module.llm_chat': '🤖 Feature de chat con LLM',
-    'new.firebase.module.local_notifications': '🔔 Recordatorios locales — programados por el usuario (solo iOS y Android)',
-    'new.firebase.module.feedback': '💬 Feedback / sugerencias de features',
-    'new.firebase.module.ci': '⚙️ CI: GitHub/GitLab (tests + build) + Codemagic (publicacion en tiendas)',
-    'new.firebase.module.onboarding': '👋 Onboarding (pantallas de bienvenida, preguntas de perfil)',
+    'new.firebase.module.facebook': '👤 Facebook (Login + Ads)',
+    'new.firebase.module.web': '🌐 Web Support (PWA, solo Firebase)',
+    'new.firebase.module.widget': '📱 Home Widget (iOS/Android)',
+    'new.firebase.module.llm_chat': '🤖 AI Chat (OpenAI/Gemini)',
+    'new.firebase.module.local_notifications': '🔔 Local Reminders (sin servidor)',
+    'new.firebase.module.feedback': '💬 Feature Requests (requiere Firebase o Supabase)',
+    'new.firebase.module.ci': '⚙️ CI/CD (GitHub + Codemagic)',
+    'new.firebase.module.onboarding': '👋 Onboarding (flujo de bienvenida)',
 
     'new.firebase.q.secrets.configureNow': '¿Configurar los secrets del servidor ahora? (webhook RevenueCat, Meta Ads)',
     'new.firebase.q.secrets.configureNow.hint': 'Si no ahora, vea el README para los comandos de configuración después',
@@ -2083,7 +2107,7 @@ const MESSAGES = {
     'notifications.summary.demo': 'Home → Features (demo):',
     'notifications.summary.reminder': 'Ajustes → Recordatorios (programado):',
 
-    'add.list.title': 'Features disponibles (✓ = ya activa)',
+    'add.list.title': 'Features del proyecto',
     'add.error.noModule': 'Indica el nombre de la feature o usa --list para ver las disponibles.',
     'add.error.notKasyProject': 'kit_setup.json no encontrado. Ejecuta este comando dentro de un proyecto Kasy.',
     'add.error.unknownModule': 'Feature desconocida: {module}\nDisponibles: {list}',
@@ -2142,7 +2166,7 @@ const MESSAGES = {
     'remove.warn.ci': 'Archivos de CI eliminados. Si tenias workflows personalizados, restauralos desde git.',
     'remove.warn.sentry.shared': 'sentry_flutter conservado — todavia requerido por features activas (revenuecat/facebook).',
     'cli.command.update.description': '⬆️  Actualiza features/componentes en un proyecto existente',
-    'cli.command.update.targetArg': 'Objetivo a actualizar (ej.: camera, revenuecat, sentry, components)',
+    'cli.command.update.targetArg': 'Objetivo a actualizar (ej.: revenuecat, sentry, components)',
     'update.error.noProject': 'kit_setup.json no encontrado. Ejecuta dentro de un proyecto Kasy.',
     'update.error.unknownModule': 'Modulo desconocido: {module}\nDisponibles: {list}',
     'update.error.unknownTarget': 'Objetivo de actualizacion desconocido: {module}\nDisponibles: {list}',

package/lib/utils/prompts.js

@@ -6,14 +6,6 @@ const {
   detectDefaultLanguage,
   normalizeLanguage
 } = require('./i18n');
-const {
-  AVAILABLE_BACKENDS,
-  getVisibleFeatures,
-  normalizeBackend,
-  parseFeatureList
-} = require('../scaffold/catalog');
-
-const KASY_AUDIENCE = process.env.KASY_INTERNAL === '1' ? 'internal' : 'public';
 
 function makeCancel(t) {
   return () => {
@@ -65,89 +57,9 @@ async function promptProjectName(options = {}) {
   return String(value).trim();
 }
 
-async function runSetupWizard(options = {}) {
-  const t = options.t || createTranslator(options.language);
-  const cancel = makeCancel(t);
-  const defaultAppName = options.defaultAppName || 'MyApp';
-  const selectedFeaturesFromArgv = parseFeatureList(options.selectedFeatures);
-
-  const appName = await ui.text({
-    message: t('prompt.appName.enter'),
-    initialValue: defaultAppName,
-    validate: (v) => (v && v.trim() ? undefined : t('prompt.appName.required')),
-    onCancel: cancel,
-  });
-  const bundleId = await ui.text({
-    message: t('prompt.bundleId.enter'),
-    initialValue: 'com.example.app',
-    validate: (v) => {
-      if (!v || !v.trim()) return t('prompt.bundleId.required');
-      const valid = /^[a-zA-Z][\w]*(\.[a-zA-Z][\w]*)+$/.test(v.trim());
-      return valid ? undefined : t('prompt.bundleId.invalid');
-    },
-    onCancel: cancel,
-  });
-
-  const core = { appName, bundleId };
-
-  const backendFromArgv = normalizeBackend(options.selectedBackend);
-  let backend = backendFromArgv;
-  if (!backend) {
-    backend = await ui.select({
-      message: t('prompt.backend.select'),
-      initialValue: AVAILABLE_BACKENDS[0]?.id,
-      options: AVAILABLE_BACKENDS.map((b) => ({ value: b.id, label: b.id })),
-      onCancel: cancel,
-    });
-  }
-
-  let features;
-  if (selectedFeaturesFromArgv.length > 0) {
-    features = selectedFeaturesFromArgv;
-  } else {
-    const selected = await ui.multiselect({
-      message: t('prompt.features.select'),
-      options: getVisibleFeatures({ audience: KASY_AUDIENCE }).map((feature) => ({
-        value: feature.id,
-        label: feature.status === 'internal' ? `${feature.id} [beta]` : feature.id,
-      })),
-      initialValues: [],
-      required: false,
-      onCancel: cancel,
-    });
-    features = parseFeatureList(selected);
-  }
-
-  if (backend === 'firebase') {
-    const firebaseProjectId = await ui.text({
-      message: t('prompt.firebase.projectId.enter'),
-      validate: (v) => (v && v.trim() ? undefined : t('prompt.firebase.projectId.required')),
-      onCancel: cancel,
-    });
-    return { ...core, backend, features, firebaseProjectId };
-  }
-
-  if (backend === 'supabase') {
-    const supabaseUrl = await ui.text({
-      message: t('prompt.supabase.url.enter'),
-      validate: (v) => (v && v.trim() ? undefined : t('prompt.supabase.url.required')),
-      onCancel: cancel,
-    });
-    const supabaseAnonKey = await ui.text({
-      message: t('prompt.supabase.anonKey.enter'),
-      validate: (v) => (v && v.trim() ? undefined : t('prompt.supabase.anonKey.required')),
-      onCancel: cancel,
-    });
-    return { ...core, backend, features, supabaseUrl, supabaseAnonKey };
-  }
-
-  return { ...core, backend, features };
-}
-
 module.exports = {
   createTranslator,
   promptLicenseKey,
   promptLanguage,
   promptProjectName,
-  runSetupWizard
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"

package/templates/firebase/lib/features/home/home_page.dart

@@ -1,7 +1,5 @@
-import 'package:flutter/foundation.dart' show kDebugMode;
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
 import 'package:kasy_kit/components/kasy_app_bar.dart';
 import 'package:kasy_kit/core/bottom_menu/bart_inner_paths.dart';
 import 'package:kasy_kit/core/bottom_menu/kasy_bart_navigation.dart';
@@ -15,7 +13,6 @@ import 'package:kasy_kit/features/home/home_components_page.dart';
 import 'package:kasy_kit/features/home/home_features_page.dart';
 import 'package:kasy_kit/features/notifications/shared/att_permission.dart';
 import 'package:kasy_kit/features/notifications/shared/notification_permission_bottom_sheet.dart';
-import 'package:kasy_kit/features/settings/ui/components/admin/admin_routes.dart';
 import 'package:kasy_kit/features/subscription/shared/maybeshow_premium.dart';
 import 'package:kasy_kit/i18n/translations.g.dart';
 
@@ -118,22 +115,6 @@ class HomePage extends ConsumerWidget {
                           );
                         },
                       ),
-                      if (kDebugMode) ...[
-                        const SizedBox(height: KasySpacing.md),
-                        FilledButton.icon(
-                          onPressed: () =>
-                              context.push(adminRouteKeyboardTest),
-                          icon: const Icon(Icons.keyboard, size: 18),
-                          label: const Text('Keyboard Test'),
-                          style: FilledButton.styleFrom(
-                            backgroundColor: Colors.deepOrange,
-                            minimumSize: const Size(double.infinity, 48),
-                            shape: RoundedRectangleBorder(
-                              borderRadius: BorderRadius.circular(12),
-                            ),
-                          ),
-                        ),
-                      ],
                       const SizedBox(height: KasySpacing.xl),
                     ]),
                   ),

package/templates/firebase/lib/features/notifications/ui/notifications_page.dart

@@ -1,3 +1,5 @@
+import 'dart:async';
+
 import 'package:flutter/material.dart';
 import 'package:flutter/rendering.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
@@ -5,6 +7,7 @@ import 'package:kasy_kit/components/kasy_app_bar.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
 import 'package:kasy_kit/features/notifications/providers/models/notification.dart'
     as app;
+import 'package:kasy_kit/features/notifications/providers/models/notification_list.dart';
 import 'package:kasy_kit/features/notifications/providers/notifications_provider.dart';
 import 'package:kasy_kit/features/notifications/ui/components/notification_settings_sheet.dart';
 import 'package:kasy_kit/features/notifications/ui/components/notification_tile.dart';
@@ -19,6 +22,7 @@ class NotificationsPage extends ConsumerStatefulWidget {
 
 class _NotificationsPageState extends ConsumerState<NotificationsPage> {
   final ScrollController _scrollController = ScrollController();
+  Timer? _autoReadTimer;
 
   @override
   void initState() {
@@ -29,6 +33,7 @@ class _NotificationsPageState extends ConsumerState<NotificationsPage> {
 
   @override
   void dispose() {
+    _autoReadTimer?.cancel();
     _scrollController.removeListener(_onScrollChange);
     _scrollController.dispose();
     super.dispose();
@@ -47,27 +52,50 @@ class _NotificationsPageState extends ConsumerState<NotificationsPage> {
   }
 
   void requestReadAll() {
-    Future.delayed(const Duration(seconds: 3), () {
-      if (!ref.context.mounted) return;
+    _autoReadTimer?.cancel();
+    _autoReadTimer = Timer(const Duration(milliseconds: 1500), () {
+      if (!mounted) return;
       ref.read(notificationsProvider.notifier).readAll();
     });
   }
 
+  bool _hasUnread(AsyncValue<NotificationsList> state) {
+    if (!state.hasValue) return false;
+    return state.value!.data.any((n) => !n.seen);
+  }
+
   @override
   Widget build(BuildContext context) {
     final notificationsState = ref.watch(notificationsProvider);
+    final hasUnread = _hasUnread(notificationsState);
 
     return KasyOverlayScaffold(
       title: t.notifications.title,
       appBarStyle: KasyAppBarStyle.rootTab,
       scrollController: _scrollController,
       trailing: Builder(
-        builder: (ctx) => KasyChromeOrbIconButton(
-          icon: KasyIcons.moreVert,
-          iconSize: 18,
-          foregroundColor: ctx.colors.onSurface,
-          onPressed: () => showNotificationSettingsSheet(ctx),
-          tooltip: 'Opções',
+        builder: (ctx) => Row(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            if (hasUnread)
+              KasyChromeOrbIconButton(
+                key: const Key('mark_all_read_button'),
+                icon: KasyIcons.check,
+                iconSize: 18,
+                foregroundColor: ctx.colors.onSurface,
+                onPressed: () =>
+                    ref.read(notificationsProvider.notifier).readAll(),
+                tooltip: t.notifications.mark_all_read,
+              ),
+            if (hasUnread) const SizedBox(width: KasySpacing.xs),
+            KasyChromeOrbIconButton(
+              icon: KasyIcons.moreVert,
+              iconSize: 18,
+              foregroundColor: ctx.colors.onSurface,
+              onPressed: () => showNotificationSettingsSheet(ctx),
+              tooltip: 'Opções',
+            ),
+          ],
         ),
       ),
       onRefresh: () async {

package/templates/firebase/lib/features/settings/ui/components/admin/admin_routes.dart

@@ -7,7 +7,6 @@ import 'package:kasy_kit/features/subscription/ui/component/premium_page_factory
 const String adminRoutePaywalls = '/admin/paywalls';
 const String adminRouteHomeWidgets = '/admin/home-widgets';
 const String adminRouteSendPush = '/admin/send-push';
-const String adminRouteKeyboardTest = '/admin/keyboard-test';
 
 String adminRoutePremiumPreview(String variant) => '/admin/premium/$variant';
 

package/templates/firebase/lib/router.dart

@@ -14,7 +14,6 @@ import 'package:kasy_kit/features/authentication/ui/phone_auth_page.dart';
 import 'package:kasy_kit/features/authentication/ui/recover_password_page.dart';
 import 'package:kasy_kit/features/authentication/ui/signin_page.dart';
 import 'package:kasy_kit/features/authentication/ui/signup_page.dart';
-import 'package:kasy_kit/features/dev/keyboard_test_page.dart';
 import 'package:kasy_kit/features/feedbacks/ui/feedback_page.dart';
 import 'package:kasy_kit/features/llm_chat/llm_chat_page.dart';
 import 'package:kasy_kit/features/local_reminder/ui/reminder_page.dart';
@@ -205,14 +204,6 @@ GoRouter generateRouter({
           child: const SendPushNotificationPage(),
         ),
       ),
-      GoRoute(
-        name: 'keyboard_test',
-        path: adminRouteKeyboardTest,
-        pageBuilder: (context, state) => kasyTransitionPage(
-          key: state.pageKey,
-          child: const KeyboardTestPage(),
-        ),
-      ),
       GoRoute(
         name: '404',
         path: '/404',

package/templates/firebase/test/features/notifications/ui/notifications_page_test.dart

@@ -1,3 +1,4 @@
+import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:kasy_kit/core/data/models/user.dart';
 import 'package:kasy_kit/core/states/models/user_state.dart';
@@ -8,61 +9,86 @@ import 'package:kasy_kit/features/notifications/ui/widgets/notification_tile.dar
 import '../../../test_utils.dart';
 
 void main() {
-  group('User is connected', () {
+  UserState authenticatedUser() => UserState(
+    user: User.authenticated(
+      id: '1',
+      email: 'user@email.com',
+      name: 'user name',
+      onboarded: true,
+      creationDate: DateTime.now().subtract(const Duration(days: 4)),
+    ),
+  );
+
+  group('NotificationsPage — rendering', () {
+    testWidgets('renders title and notification tiles', (tester) async {
+      await tester.pumpPage(
+        userState: authenticatedUser(),
+        home: NotificationsPage(),
+      );
+      await tester.pumpAndSettle();
+
+      expect(find.byType(NotificationsPage), findsOneWidget);
+      expect(find.text('Notifications'), findsOneWidget);
+      expect(find.byType(NotificationTile), findsAtLeastNWidgets(3));
+    });
+  });
+
+  group('NotificationsPage — auto-read behavior', () {
     testWidgets(
-      'Load notifications => should show 20 notifications',
+      'after 1.5s on screen, all notifications are marked as read',
       (tester) async {
         await tester.pumpPage(
-          userState: UserState(
-            user: User.authenticated(
-              id: '1',
-              email: 'user@email.com',
-              name: 'user name',
-              onboarded: true,
-              creationDate: DateTime.now().subtract(const Duration(days: 4)),
-            ),
-          ),
+          userState: authenticatedUser(),
           home: NotificationsPage(),
         );
-        await tester.pump(const Duration(seconds: 3));
+        await tester.pump(const Duration(milliseconds: 1600));
         await tester.pumpAndSettle();
-        expect(find.byType(NotificationsPage), findsOneWidget);
-        expect(find.text("Notifications"), findsOneWidget);
-        expect(find.byType(NotificationTile), findsAtLeastNWidgets(3));
+
+        final tiles = tester
+            .widgetList<NotificationTileComponent>(
+              find.byType(NotificationTileComponent),
+            )
+            .toList();
+        expect(tiles, isNotEmpty);
+        for (final tile in tiles) {
+          expect(
+            tile.notification.readAt,
+            isNotNull,
+            reason: 'All notifications should be read after auto-read fires',
+          );
+        }
       },
     );
+  });
 
+  group('NotificationsPage — mark all read button', () {
     testWidgets(
-      'Load notifications, wait 3 seconds => all notifications are now read',
+      'tapping the button marks all notifications as read immediately',
       (tester) async {
         await tester.pumpPage(
-          userState: UserState(
-            user: User.authenticated(
-              id: '1',
-              email: 'user@email.com',
-              name: 'user name',
-              onboarded: true,
-              creationDate: DateTime.now().subtract(const Duration(days: 4)),
-            ),
-          ),
+          userState: authenticatedUser(),
           home: NotificationsPage(),
         );
-        var firstNotification = tester.firstWidget<NotificationTileComponent>(
-          find.byType(NotificationTileComponent),
-        );
-        expect(firstNotification.notification.readAt, isNull);
-
-        await tester.pump(const Duration(seconds: 3));
         await tester.pumpAndSettle();
-        firstNotification = tester.firstWidget<NotificationTileComponent>(
-          find.byType(NotificationTileComponent),
-        );
 
-        expect(
-          firstNotification.notification.readAt,
-          isNotNull,
-          reason: "All notifications should be read after 3 seconds",
-        );
+        // Auto-read may have already run during pumpAndSettle.
+        // The button is hidden when no unread notifications remain — that is
+        // expected and itself a correct behavior.
+        final button = find.byKey(const Key('mark_all_read_button'));
+        if (button.evaluate().isNotEmpty) {
+          await tester.tap(button);
+          await tester.pumpAndSettle();
+        }
+
+        final tiles = tester
+            .widgetList<NotificationTileComponent>(
+              find.byType(NotificationTileComponent),
+            )
+            .toList();
+        expect(tiles, isNotEmpty);
+        for (final tile in tiles) {
+          expect(tile.notification.readAt, isNotNull);
+        }
       },
     );
   });

package/templates/firebase/lib/features/dev/keyboard_test_page.dart

@@ -1,93 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:kasy_kit/components/kasy_text_field.dart';
-import 'package:kasy_kit/core/theme/theme.dart';
-
-class KeyboardTestPage extends StatefulWidget {
-  const KeyboardTestPage({super.key});
-
-  @override
-  State<KeyboardTestPage> createState() => _KeyboardTestPageState();
-}
-
-class _KeyboardTestPageState extends State<KeyboardTestPage> {
-  final _name = TextEditingController();
-  final _email = TextEditingController();
-  final _phone = TextEditingController();
-  final _password = TextEditingController();
-  final _bio = TextEditingController();
-
-  @override
-  void dispose() {
-    _name.dispose();
-    _email.dispose();
-    _phone.dispose();
-    _password.dispose();
-    _bio.dispose();
-    super.dispose();
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(title: const Text('Keyboard Test')),
-      body: ListView(
-        padding: EdgeInsets.fromLTRB(
-          KasySpacing.pageHorizontalGutter,
-          KasySpacing.md,
-          KasySpacing.pageHorizontalGutter,
-          MediaQuery.paddingOf(context).bottom + 40,
-        ),
-        children: [
-          const Text(
-            'Tap between the fields — the keyboard should stay open without closing and reopening.',
-            style: TextStyle(fontSize: 13, color: Colors.grey),
-          ),
-          const SizedBox(height: KasySpacing.lg),
-          KasyTextField(
-            controller: _name,
-            label: 'Name',
-            hint: 'Your full name',
-            textInputAction: TextInputAction.next,
-            textCapitalization: TextCapitalization.words,
-          ),
-          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
-          KasyTextField(
-            controller: _email,
-            label: 'Email',
-            hint: 'you@example.com',
-            contentType: KasyTextFieldContentType.email,
-            keyboardType: TextInputType.emailAddress,
-            textInputAction: TextInputAction.next,
-          ),
-          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
-          KasyTextField(
-            controller: _phone,
-            label: 'Phone',
-            hint: '+55 11 99999-9999',
-            contentType: KasyTextFieldContentType.phone,
-            keyboardType: TextInputType.phone,
-            textInputAction: TextInputAction.next,
-          ),
-          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
-          KasyTextField(
-            controller: _password,
-            label: 'Password',
-            hint: 'Min 8 characters',
-            contentType: KasyTextFieldContentType.password,
-            textInputAction: TextInputAction.next,
-          ),
-          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
-          KasyTextField(
-            controller: _bio,
-            label: 'Bio',
-            hint: 'Tell us about yourself',
-            textInputAction: TextInputAction.done,
-            minLines: 3,
-            maxLines: 5,
-            textCapitalization: TextCapitalization.sentences,
-          ),
-        ],
-      ),
-    );
-  }
-}