kasy-cli 1.10.0 → 1.12.1

package/bin/kasy.js

@@ -242,14 +242,15 @@ function buildProgram(language) {
   const langName = t('cli.command.setup.langName');
   applyLocalizedHelp(
     program
-      .command('setup')
+      .command('setup', { hidden: true })
       .argument(`[${directoryName}]`, t('cli.command.setup.directoryArg'), '.')
       .option(`-l, --lang <${langName}>`, t('cli.command.setup.langOption'))
       .option('-b, --backend <backend>', t('cli.command.setup.backendOption'))
       .option('--with <features>', t('cli.command.setup.featuresOption'))
       .description(t('cli.command.setup.description'))
       .action(async (directory, options) => {
-        // `setup` is an alias for `new` — unified flow
+        // `setup` is an alias for `new` — unified flow.
+        // Hidden from root help to reduce noise; still callable.
         await runNew(directory, {
           language: options.lang,
           backend: options.backend,
@@ -516,7 +517,6 @@ function buildProgram(language) {
     notificationsCmd
       .command('text')
       .argument('[directory]', 'Project folder (default: current directory)', '.')
-      .option('-d, --directory <path>', 'Project folder (default: current directory)')
       .option('--locale <code>', 'i18n files to update: pt, en, es, or all (default: all)', 'all')
       .option('--demo-title <text>', 'Home → Features demo notification title')
       .option('--demo-body <text>', 'Home → Features demo card description / instant notification body')
@@ -524,7 +524,7 @@ function buildProgram(language) {
       .option('--reminder-body <text>', 'Scheduled reminder notification body')
       .description(t('cli.command.notifications.text.description'))
       .action(async (directory, options) => {
-        const dir = options.directory || directory || '.';
+        const dir = directory || '.';
         await runNotificationsText(dir, {
           language,
           directory: dir,

package/lib/commands/check.js

@@ -110,67 +110,67 @@ async function runCheck(options = {}) {
   const t = createTranslator(lang);
 
   printCompactHeader(t);
-  ui.intro('Kasy Check — Push Notifications');
+  ui.intro(t('check.intro'));
 
   // ── Detect backend ────────────────────────────────────────────────────────
   const isFirebase = await fs.pathExists(path.join(projectDir, 'firebase.json'));
   const isSupabase = await fs.pathExists(path.join(projectDir, 'supabase'));
 
   if (isFirebase && !isSupabase) {
-    ok('Firebase backend');
-    info('Firebase usa Application Default Credentials — nenhuma configuração extra necessária.');
+    ok(t('check.firebase.detected'));
+    info(t('check.firebase.adcInfo'));
     const firebaseProjectId = await readFirebaseProjectId(projectDir);
     const apnsLines = [
-      kleur.yellow('Push iOS requer APNs Key (não verificável via CLI)'),
-      kleur.dim('Firebase Console → Cloud Messaging → app iOS → Chave de autenticação APNs'),
+      kleur.yellow(t('check.apns.warn')),
+      kleur.dim(t('check.apns.where')),
     ];
     if (firebaseProjectId) {
       apnsLines.push(kleur.cyan(`https://console.firebase.google.com/project/${firebaseProjectId}/settings/cloudmessaging`));
     }
     ui.note(apnsLines.join('\n'));
-    ui.outro('Done');
+    ui.outro(t('check.done'));
     return;
   }
 
   if (!isSupabase) {
-    ui.log.error('Diretório não parece ser um projeto Kasy.');
-    ui.cancel('Aborted');
+    ui.log.error(t('check.notKasy'));
+    ui.cancel(t('check.aborted'));
     process.exit(1);
   }
 
   // ── 1. Project linked? ────────────────────────────────────────────────────
   const projectRef = await readProjectRef(projectDir);
   if (!projectRef) {
-    fail('Projeto Supabase não vinculado', 'execute: supabase link --project-ref SEU_REF');
-    ui.cancel('Aborted');
+    fail(t('check.supabase.notLinked'), t('check.supabase.notLinkedHint'));
+    ui.cancel(t('check.aborted'));
     process.exit(1);
   }
-  ok('Projeto vinculado', projectRef);
+  ok(t('check.supabase.linked'), projectRef);
 
   // ── Read secrets list ─────────────────────────────────────────────────────
   const spinner = ui.spinner();
-  spinner.start('Verificando secrets…');
+  spinner.start(t('check.spin.secrets'));
   const secrets = await listSecretNames(projectDir);
-  spinner.stop('Secrets verificados');
+  spinner.stop(t('check.spin.secretsDone'));
 
   if (!secrets) {
-    warn('Não foi possível listar secrets', 'verifique: supabase login');
+    warn(t('check.secrets.listFailed'), t('check.secrets.checkLogin'));
   }
 
   // ── 2. FIREBASE_PROJECT_ID ────────────────────────────────────────────────
   const firebaseProjectId = await readFirebaseProjectId(projectDir);
   if (secrets) {
     if (secrets.has('FIREBASE_PROJECT_ID')) {
-      ok('FIREBASE_PROJECT_ID configurado');
+      ok(t('check.fbProjId.ok'));
     } else {
-      fail('FIREBASE_PROJECT_ID ausente');
+      fail(t('check.fbProjId.missing'));
       if (firebaseProjectId) {
-        ui.log.message(kleur.gray(`Corrija: supabase secrets set FIREBASE_PROJECT_ID="${firebaseProjectId}"`));
+        ui.log.message(kleur.gray(t('check.fbProjId.fixHint', { id: firebaseProjectId })));
         if (options.fix) {
           const r = await runCmd(`supabase secrets set FIREBASE_PROJECT_ID="${firebaseProjectId}"`, projectDir);
           r.ok
-            ? ok('FIREBASE_PROJECT_ID → configurado automaticamente')
-            : fail('FIREBASE_PROJECT_ID → falhou ao configurar', r.error);
+            ? ok(t('check.fbProjId.fixed'))
+            : fail(t('check.fbProjId.fixFailed'), r.error);
         }
       }
     }
@@ -179,15 +179,15 @@ async function runCheck(options = {}) {
   // ── 3. FIREBASE_SERVICE_ACCOUNT_JSON ─────────────────────────────────────
   if (secrets) {
     if (secrets.has('FIREBASE_SERVICE_ACCOUNT_JSON')) {
-      ok('FIREBASE_SERVICE_ACCOUNT_JSON configurado');
+      ok(t('check.fbSak.ok'));
     } else {
-      fail('FIREBASE_SERVICE_ACCOUNT_JSON ausente');
+      fail(t('check.fbSak.missing'));
 
       if (options.fix && firebaseProjectId) {
         const fixSpinner = ui.spinner();
-        fixSpinner.start('Gerando e configurando chave FCM…');
+        fixSpinner.start(t('check.fbSak.spin'));
         const fcmResult = await createFcmServiceAccountKey(firebaseProjectId);
-        fixSpinner.stop('Chave FCM gerada');
+        fixSpinner.stop(t('check.fbSak.spinDone'));
 
         if (fcmResult.ok) {
           const secretSteps = await setSupabaseSecrets(projectDir, {
@@ -196,62 +196,52 @@ async function runCheck(options = {}) {
           });
           const setStep = secretSteps.find((s) => s.name === 'secret FIREBASE_SERVICE_ACCOUNT_JSON');
           setStep?.ok
-            ? ok('FIREBASE_SERVICE_ACCOUNT_JSON → configurado automaticamente')
-            : fail('FIREBASE_SERVICE_ACCOUNT_JSON → falhou ao configurar', setStep?.error);
+            ? ok(t('check.fbSak.fixed'))
+            : fail(t('check.fbSak.fixFailed'), setStep?.error);
         } else {
-          fail('FIREBASE_SERVICE_ACCOUNT_JSON → não foi possível gerar chave', fcmResult.error);
-          ui.log.message(kleur.gray(
-            'Manual: Firebase Console → Configurações → Contas de serviço → Gerar chave\n' +
-            "Depois: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat chave.json)'"
-          ));
+          fail(t('check.fbSak.genFailed'), fcmResult.error);
+          ui.log.message(kleur.gray(t('check.fbSak.manual')));
         }
       } else {
-        ui.log.message(kleur.gray(
-          'Corrija automaticamente: kasy check --fix\n' +
-          'Ou manualmente: Firebase Console → Configurações → Contas de serviço → Gerar chave\n' +
-          "Depois: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat chave.json)'"
-        ));
+        ui.log.message(kleur.gray(t('check.fbSak.hint')));
       }
     }
   }
 
   // ── 4. Edge function send-push-notification ────────────────────────────────
   const fnSpinner = ui.spinner();
-  fnSpinner.start('Verificando edge functions…');
+  fnSpinner.start(t('check.fn.spin'));
   const functions = await listDeployedFunctions(projectDir);
-  fnSpinner.stop('Edge functions verificadas');
+  fnSpinner.stop(t('check.fn.spinDone'));
 
   if (!functions) {
-    warn('Não foi possível listar edge functions', 'verifique: supabase login');
+    warn(t('check.fn.listFailed'), t('check.secrets.checkLogin'));
   } else if (functions.has('send-push-notification')) {
-    ok('Edge function send-push-notification deployada');
+    ok(t('check.fn.deployed'));
   } else {
-    fail('Edge function send-push-notification não deployada');
+    fail(t('check.fn.missing'));
     if (options.fix) {
       const deploySpinner = ui.spinner();
-      deploySpinner.start('Publicando send-push-notification…');
+      deploySpinner.start(t('check.fn.deploySpin'));
       const r = await runCmd('supabase functions deploy send-push-notification', projectDir);
       r.ok
-        ? deploySpinner.stop('send-push-notification → deployada automaticamente')
-        : deploySpinner.error(`send-push-notification → falhou no deploy${r.error ? ` — ${r.error}` : ''}`);
+        ? deploySpinner.stop(t('check.fn.deployDone'))
+        : deploySpinner.error(`${t('check.fn.deployFailed')}${r.error ? ` — ${r.error}` : ''}`);
     } else {
-      ui.log.message(kleur.gray(
-        'Corrija automaticamente: kasy check --fix\n' +
-        'Ou manualmente: supabase functions deploy send-push-notification'
-      ));
+      ui.log.message(kleur.gray(t('check.fn.hint')));
     }
   }
 
   // ── 5. APNs reminder ─────────────────────────────────────────────────────
   const apnsLines = [
-    kleur.yellow('Push iOS requer APNs Key (não verificável via CLI)'),
-    kleur.dim('Firebase Console → Cloud Messaging → app iOS → Chave de autenticação APNs'),
+    kleur.yellow(t('check.apns.warn')),
+    kleur.dim(t('check.apns.where')),
   ];
   if (firebaseProjectId) {
     apnsLines.push(kleur.cyan(`https://console.firebase.google.com/project/${firebaseProjectId}/settings/cloudmessaging`));
   }
   ui.note(apnsLines.join('\n'));
-  ui.outro('Done');
+  ui.outro(t('check.done'));
 }
 
 module.exports = { runCheck };

package/lib/commands/deploy.js

@@ -123,14 +123,14 @@ async function deployFirebase(projectDir, options, tr) {
   }
 
   const spinner = ui.spinner();
-  spinner.start('Deploying Firebase...');
+  spinner.start(tr('deploy.firebase.spin'));
   let steps;
   try {
     steps = await runFirebaseDeploy(projectDir, null, firebaseProjectId, {
       functionsRegion,
       onProgress: (key) => { spinner.message(String(key)); },
     });
-    spinner.stop('Firebase deploy completed');
+    spinner.stop(tr('deploy.firebase.spinDone'));
   } catch (err) {
     spinner.error(err.message);
     throw err;
@@ -145,9 +145,9 @@ async function deployFirebase(projectDir, options, tr) {
   // ── APNs reminder — required for iOS push notifications ──────────────────
   // Cannot be automated: the .p8 key only exists in Apple Developer Portal.
   const apnsBody = [
-    kleur.yellow('Push iOS: configure a APNs Key no Firebase Console'),
-    kleur.dim('1. Apple Developer Portal → Keys → criar APNs Key (.p8)'),
-    kleur.dim('2. Firebase Console → Cloud Messaging → app iOS → upload da APNs Key'),
+    kleur.yellow(tr('deploy.apns.title')),
+    kleur.dim(tr('deploy.apns.step1')),
+    kleur.dim(tr('deploy.apns.step2')),
     kleur.cyan(`https://console.firebase.google.com/project/${firebaseProjectId}/settings/cloudmessaging`),
   ].join('\n');
   ui.note(apnsBody);
@@ -155,28 +155,28 @@ async function deployFirebase(projectDir, options, tr) {
 
 // ── Supabase deploy ───────────────────────────────────────────────────────────
 
-async function deploySupabase(projectDir) {
+async function deploySupabase(projectDir, tr) {
   // ── 1. Get project ref ──────────────────────────────────────────────────
   const projectRef = await readSupabaseProjectRef(projectDir);
   if (!projectRef) {
-    ui.log.error('Projeto Supabase não está vinculado neste diretório.');
-    ui.log.message(kleur.gray('Execute: supabase link --project-ref SEU_PROJECT_REF'));
+    ui.log.error(tr('deploy.supabase.notLinked'));
+    ui.log.message(kleur.gray(tr('deploy.supabase.linkHint')));
     process.exit(1);
   }
-  ui.log.message(kleur.gray(`Project ref: ${kleur.cyan(projectRef)}`));
+  ui.log.message(kleur.gray(tr('deploy.supabase.projectRef', { ref: kleur.cyan(projectRef) })));
 
   // ── 2. FCM Service Account JSON ─────────────────────────────────────────
   const alreadySet = await isServiceAccountJsonSet(projectDir);
   if (alreadySet) {
-    printStep(true, false, 'FIREBASE_SERVICE_ACCOUNT_JSON já configurado');
+    printStep(true, false, tr('deploy.supabase.sakAlready'));
   } else {
     const firebaseProjectId = await readFirebaseProjectId(projectDir);
 
     if (firebaseProjectId) {
       const fcmSpinner = ui.spinner();
-      fcmSpinner.start('Gerando chave FCM (Service Account)…');
+      fcmSpinner.start(tr('deploy.supabase.sakSpin'));
       const fcmResult = await createFcmServiceAccountKey(firebaseProjectId);
-      fcmSpinner.stop('Chave FCM gerada');
+      fcmSpinner.stop(tr('deploy.supabase.sakSpinDone'));
 
       if (fcmResult.ok) {
         const secretSteps = await setSupabaseSecrets(projectDir, {
@@ -186,23 +186,23 @@ async function deploySupabase(projectDir) {
         for (const s of secretSteps) printStep(s.ok, false, s.name, s.error);
       } else {
         printStep(false, false, 'FIREBASE_SERVICE_ACCOUNT_JSON', fcmResult.error);
-        ui.log.warn("Configure manualmente: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='...'");
+        ui.log.warn(tr('deploy.supabase.sakManual'));
       }
     } else {
-      printStep(false, false, 'FIREBASE_SERVICE_ACCOUNT_JSON', 'google-services.json não encontrado — configure manualmente');
+      printStep(false, false, 'FIREBASE_SERVICE_ACCOUNT_JSON', tr('deploy.supabase.sakNoGS'));
     }
   }
 
   // ── 3. Deploy edge functions ────────────────────────────────────────────
   const fnSpinner = ui.spinner();
-  fnSpinner.start('Publicando edge functions…');
+  fnSpinner.start(tr('deploy.supabase.fnSpin'));
   const fnResult = await deployFunctions(projectDir);
-  fnSpinner.stop('Edge functions processadas');
+  fnSpinner.stop(tr('deploy.supabase.fnSpinDone'));
 
   if (Array.isArray(fnResult)) {
     fnResult.forEach((s) => printStep(s.ok, s.skipped, s.name, s.error));
   } else if (fnResult.skipped) {
-    printStep(true, true, 'edge functions (nenhuma encontrada)');
+    printStep(true, true, tr('deploy.supabase.fnNone'));
   } else {
     printStep(fnResult.ok, false, 'supabase functions deploy', fnResult.error);
   }
@@ -210,9 +210,9 @@ async function deploySupabase(projectDir) {
   // ── 4. APNs reminder ────────────────────────────────────────────────────
   const firebaseProjectId = await readFirebaseProjectId(projectDir);
   const apnsLines = [
-    kleur.yellow('Push iOS: configure a APNs Key no Firebase Console'),
-    kleur.dim('1. Apple Developer Portal → Keys → criar APNs Key (.p8)'),
-    kleur.dim('2. Firebase Console → Cloud Messaging → app iOS → upload da APNs Key'),
+    kleur.yellow(tr('deploy.apns.title')),
+    kleur.dim(tr('deploy.apns.step1')),
+    kleur.dim(tr('deploy.apns.step2')),
   ];
   if (firebaseProjectId) {
     apnsLines.push(kleur.cyan(`https://console.firebase.google.com/project/${firebaseProjectId}/settings/cloudmessaging`));
@@ -240,17 +240,17 @@ async function runDeployCommand(directory, options = {}, { language: langHint }
 
   if (isFirebase) {
     printCompactHeader(tr);
-    ui.intro('Deploy — Firebase');
+    ui.intro(tr('deploy.firebase.intro'));
     await deployFirebase(projectDir, options, tr);
-    ui.outro('Deploy concluído');
+    ui.outro(tr('deploy.outro'));
     return;
   }
 
   if (isSupabase) {
     printCompactHeader(tr);
-    ui.intro('Deploy — Supabase');
-    await deploySupabase(projectDir);
-    ui.outro('Deploy concluído');
+    ui.intro(tr('deploy.supabase.intro'));
+    await deploySupabase(projectDir, tr);
+    ui.outro(tr('deploy.outro'));
     return;
   }
 

package/lib/utils/i18n.js

@@ -59,7 +59,7 @@ const MESSAGES = {
     'new.checks.environment.done': 'Environment ready',
     'setup.checks.backend.checking': 'Checking {backend} tools',
     'setup.checks.backend.done': '{backend} tools ready',
-    'new.checks.firebaseForPush': 'Note: Firebase CLI is required for push notifications (FCM) on all backends.',
+    'new.checks.firebaseForPush': 'Note: Firebase CLI is required for push notifications (Firebase Cloud Messaging / FCM) on all backends.',
     'new.checks.requiredBlock': 'Required tools are missing. Install them to continue.',
     'new.checks.installFirebase': 'Firebase: npm i -g firebase-tools && firebase login. FlutterFire: dart pub global activate flutterfire_cli',
     'new.checks.installSupabase': 'Supabase: npm i -g supabase (or brew install supabase/tap/supabase) && supabase login',
@@ -578,7 +578,7 @@ const MESSAGES = {
     'new.success.step.run': 'Run your app (with your configured keys):',
     'new.success.step.run.vscode': '(or F5 in VS Code)',
     'new.success.step.console': 'Open your backend console:',
-    'new.fcm.generating': 'Generating FCM Service Account key…',
+    'new.fcm.generating': 'Generating push notifications key (Firebase Service Account)…',
     'new.sha1.registering': 'Registering SHA-1 for Google Sign-In (Android)…',
     'new.sha1.failed': 'SHA-1 not added automatically: {error}',
     'new.sha1.manual': 'Add it manually so Google Sign-In works on Android:',
@@ -654,15 +654,15 @@ const MESSAGES = {
     'add.error.unknownModule': 'Unknown feature: {module}\nAvailable: {list}',
     'add.alreadyActive': 'Feature "{module}" is already active in this project.',
     'add.applying': 'Adding feature: {module}',
-    'add.applyingPatch': 'Applying patch files...',
+    'add.applyingPatch': 'Applying feature changes...',
     'add.patchApplied': 'Patch applied',
     'add.patchFailed': 'Patch failed — check the output above',
-    'add.pubGet': 'Running flutter pub get...',
+    'add.pubGet': 'Installing Flutter packages (flutter pub get)...',
     'add.pubGetDone': 'Dependencies updated',
-    'add.pubGetFailed': 'flutter pub get failed — run it manually',
-    'add.buildRunner': 'Running build_runner...',
+    'add.pubGetFailed': 'Failed to install Flutter packages — run `flutter pub get` manually',
+    'add.buildRunner': 'Generating code (Riverpod/Freezed)...',
     'add.buildRunnerDone': 'Code generation complete',
-    'add.buildRunnerFailed': 'build_runner failed — run it manually',
+    'add.buildRunnerFailed': 'Code generation failed — run `dart run build_runner build` manually',
     'add.success': 'Feature "{module}" added successfully.',
     'add.cancelled': 'Cancelled.',
     'add.prompt.sentryDsn': 'Sentry DSN (leave blank to configure later):',
@@ -697,12 +697,12 @@ const MESSAGES = {
     'remove.confirm': 'Remove feature "{module}"? This will delete files and dependencies.',
     'remove.cancelled': 'Cancelled.',
     'remove.removing': 'Removing feature: {module}',
-    'remove.pubGet': 'Running flutter pub get...',
+    'remove.pubGet': 'Installing Flutter packages (flutter pub get)...',
     'remove.pubGetDone': 'Dependencies updated',
-    'remove.pubGetFailed': 'flutter pub get failed — run it manually',
-    'remove.buildRunner': 'Running build_runner...',
+    'remove.pubGetFailed': 'Failed to install Flutter packages — run `flutter pub get` manually',
+    'remove.buildRunner': 'Generating code (Riverpod/Freezed)...',
     'remove.buildRunnerDone': 'Code generation complete',
-    'remove.buildRunnerFailed': 'build_runner failed — run it manually',
+    'remove.buildRunnerFailed': 'Code generation failed — run `dart run build_runner build` manually',
     'remove.success': 'Feature "{module}" removed successfully.',
     '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).',
@@ -735,15 +735,72 @@ const MESSAGES = {
     'update.applyComponentsFailed': 'Failed to apply update for base components',
     'update.noPatch': 'Feature "{module}" has no files to update (configuration-only feature).',
     'update.noComponentFiles': 'No base component files were found to update.',
-    'update.pubGet': 'Running flutter pub get...',
+    'update.pubGet': 'Installing Flutter packages (flutter pub get)...',
     'update.pubGetDone': 'Dependencies updated',
-    'update.pubGetFailed': 'flutter pub get failed — run it manually',
-    'update.buildRunner': 'Running build_runner...',
+    'update.pubGetFailed': 'Failed to install Flutter packages — run `flutter pub get` manually',
+    'update.buildRunner': 'Generating code (Riverpod/Freezed)...',
     'update.buildRunnerDone': 'Code generation complete',
-    'update.buildRunnerFailed': 'build_runner failed — run it manually',
+    'update.buildRunnerFailed': 'Code generation failed — run `dart run build_runner build` manually',
     'update.success': 'Feature "{module}" updated successfully.',
     'update.componentsSuccess': 'Base components updated successfully.',
     'update.coreSuccess': 'Core files updated successfully.',
+    'check.intro': 'Kasy Check — Push Notifications',
+    'check.firebase.detected': 'Firebase backend',
+    'check.firebase.adcInfo': 'Firebase uses Application Default Credentials — no extra setup needed.',
+    'check.apns.warn': 'iOS push requires APNs Key (cannot be verified via CLI)',
+    'check.apns.where': 'Firebase Console → Cloud Messaging → iOS app → APNs Authentication Key',
+    'check.done': 'Done',
+    'check.notKasy': 'This directory does not look like a Kasy project.',
+    'check.aborted': 'Aborted',
+    'check.supabase.notLinked': 'Supabase project not linked',
+    'check.supabase.notLinkedHint': 'run: supabase link --project-ref YOUR_REF',
+    'check.supabase.linked': 'Project linked',
+    'check.spin.secrets': 'Checking secrets…',
+    'check.spin.secretsDone': 'Secrets checked',
+    'check.secrets.listFailed': 'Could not list secrets',
+    'check.secrets.checkLogin': 'verify: supabase login',
+    'check.fbProjId.ok': 'FIREBASE_PROJECT_ID configured',
+    'check.fbProjId.missing': 'FIREBASE_PROJECT_ID missing',
+    'check.fbProjId.fixHint': 'Fix: supabase secrets set FIREBASE_PROJECT_ID="{id}"',
+    'check.fbProjId.fixed': 'FIREBASE_PROJECT_ID → set automatically',
+    'check.fbProjId.fixFailed': 'FIREBASE_PROJECT_ID → failed to set',
+    'check.fbSak.ok': 'FIREBASE_SERVICE_ACCOUNT_JSON configured',
+    'check.fbSak.missing': 'FIREBASE_SERVICE_ACCOUNT_JSON missing',
+    'check.fbSak.spin': 'Generating and setting FCM key…',
+    'check.fbSak.spinDone': 'FCM key generated',
+    'check.fbSak.fixed': 'FIREBASE_SERVICE_ACCOUNT_JSON → set automatically',
+    'check.fbSak.fixFailed': 'FIREBASE_SERVICE_ACCOUNT_JSON → failed to set',
+    'check.fbSak.genFailed': 'FIREBASE_SERVICE_ACCOUNT_JSON → could not generate key',
+    'check.fbSak.manual': "Manual: Firebase Console → Settings → Service accounts → Generate key\nThen: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat key.json)'",
+    'check.fbSak.hint': "Auto-fix: kasy check --fix\nOr manually: Firebase Console → Settings → Service accounts → Generate key\nThen: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat key.json)'",
+    'check.fn.spin': 'Checking edge functions…',
+    'check.fn.spinDone': 'Edge functions checked',
+    'check.fn.listFailed': 'Could not list edge functions',
+    'check.fn.deployed': 'Edge function send-push-notification deployed',
+    'check.fn.missing': 'Edge function send-push-notification not deployed',
+    'check.fn.deploySpin': 'Deploying send-push-notification…',
+    'check.fn.deployDone': 'send-push-notification → deployed automatically',
+    'check.fn.deployFailed': 'send-push-notification → deploy failed',
+    'check.fn.hint': 'Auto-fix: kasy check --fix\nOr manually: supabase functions deploy send-push-notification',
+    'deploy.firebase.intro': 'Deploy — Firebase',
+    'deploy.firebase.spin': 'Deploying Firebase...',
+    'deploy.firebase.spinDone': 'Firebase deploy completed',
+    'deploy.apns.title': 'iOS push: configure the APNs Key in Firebase Console',
+    'deploy.apns.step1': '1. Apple Developer Portal → Keys → create APNs Key (.p8)',
+    'deploy.apns.step2': '2. Firebase Console → Cloud Messaging → iOS app → upload APNs Key',
+    'deploy.supabase.intro': 'Deploy — Supabase',
+    'deploy.supabase.notLinked': 'Supabase project not linked in this directory.',
+    'deploy.supabase.linkHint': 'Run: supabase link --project-ref YOUR_PROJECT_REF',
+    'deploy.supabase.projectRef': 'Project ref: {ref}',
+    'deploy.supabase.sakAlready': 'FIREBASE_SERVICE_ACCOUNT_JSON already configured',
+    'deploy.supabase.sakSpin': 'Generating FCM key (Service Account)…',
+    'deploy.supabase.sakSpinDone': 'FCM key generated',
+    'deploy.supabase.sakManual': "Configure manually: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='...'",
+    'deploy.supabase.sakNoGS': 'google-services.json not found — configure manually',
+    'deploy.supabase.fnSpin': 'Deploying edge functions…',
+    'deploy.supabase.fnSpinDone': 'Edge functions processed',
+    'deploy.supabase.fnNone': 'edge functions (none found)',
+    'deploy.outro': 'Deploy completed',
   },
   pt: {
     'cli.tagline': 'Crie apps móveis sem dor de configuração',
@@ -799,7 +856,7 @@ const MESSAGES = {
     'new.checks.environment.done': 'Ambiente pronto',
     'setup.checks.backend.checking': 'Verificando ferramentas {backend}',
     'setup.checks.backend.done': 'Ferramentas {backend} prontas',
-    'new.checks.firebaseForPush': 'Atenção: Firebase CLI é obrigatório para notificações push (FCM) em todos os backends.',
+    'new.checks.firebaseForPush': 'Atenção: Firebase CLI é obrigatório para notificações push (Firebase Cloud Messaging / FCM) em todos os backends.',
     'new.checks.requiredBlock': 'Ferramentas obrigatórias não encontradas. Instale-as para continuar.',
     'new.checks.installFirebase': 'Firebase: npm i -g firebase-tools && firebase login. FlutterFire: dart pub global activate flutterfire_cli',
     'new.checks.installSupabase': 'Supabase: npm i -g supabase (ou brew install supabase/tap/supabase) && supabase login',
@@ -1394,15 +1451,15 @@ const MESSAGES = {
     'add.error.unknownModule': 'Feature desconhecida: {module}\nDisponiveis: {list}',
     'add.alreadyActive': 'A feature "{module}" já está ativa neste projeto.',
     'add.applying': 'Adicionando feature: {module}',
-    'add.applyingPatch': 'Aplicando arquivos de patch...',
+    'add.applyingPatch': 'Aplicando mudanças da feature...',
     'add.patchApplied': 'Patch aplicado',
     'add.patchFailed': 'Patch falhou — verifique a saída acima',
-    'add.pubGet': 'Executando flutter pub get...',
+    'add.pubGet': 'Instalando pacotes do Flutter (flutter pub get)...',
     'add.pubGetDone': 'Dependencias atualizadas',
-    'add.pubGetFailed': 'flutter pub get falhou — execute manualmente',
-    'add.buildRunner': 'Executando build_runner...',
+    'add.pubGetFailed': 'Falha ao instalar pacotes do Flutter — execute `flutter pub get` manualmente',
+    'add.buildRunner': 'Gerando código (Riverpod/Freezed)...',
     'add.buildRunnerDone': 'Geração de código concluída',
-    'add.buildRunnerFailed': 'build_runner falhou — execute manualmente',
+    'add.buildRunnerFailed': 'Geração de código falhou — execute `dart run build_runner build` manualmente',
     'add.success': 'Feature "{module}" adicionada com sucesso.',
     'add.cancelled': 'Cancelado.',
     'add.prompt.sentryDsn': 'Sentry DSN (deixe em branco para configurar depois):',
@@ -1437,12 +1494,12 @@ const MESSAGES = {
     'remove.confirm': 'Remover a feature "{module}"? Isso vai deletar arquivos e dependências.',
     'remove.cancelled': 'Cancelado.',
     'remove.removing': 'Removendo feature: {module}',
-    'remove.pubGet': 'Executando flutter pub get...',
+    'remove.pubGet': 'Instalando pacotes do Flutter (flutter pub get)...',
     'remove.pubGetDone': 'Dependencias atualizadas',
-    'remove.pubGetFailed': 'flutter pub get falhou — execute manualmente',
-    'remove.buildRunner': 'Executando build_runner...',
+    'remove.pubGetFailed': 'Falha ao instalar pacotes do Flutter — execute `flutter pub get` manualmente',
+    'remove.buildRunner': 'Gerando código (Riverpod/Freezed)...',
     'remove.buildRunnerDone': 'Geração de código concluída',
-    'remove.buildRunnerFailed': 'build_runner falhou — execute manualmente',
+    'remove.buildRunnerFailed': 'Geração de código falhou — execute `dart run build_runner build` manualmente',
     'remove.success': 'Feature "{module}" removida com sucesso.',
     'remove.warn.ci': 'Arquivos de CI removidos. Se tinha workflows customizados, restaure-os pelo git.',
     'remove.warn.sentry.shared': 'sentry_flutter mantido — ainda necessário para features ativas (revenuecat/facebook).',
@@ -1475,15 +1532,72 @@ const MESSAGES = {
     'update.applyComponentsFailed': 'Falha ao aplicar atualização dos componentes base',
     'update.noPatch': 'Feature "{module}" não tem arquivos para atualizar (feature so de configuração).',
     'update.noComponentFiles': 'Nenhum arquivo de componente base foi encontrado para atualizar.',
-    'update.pubGet': 'Executando flutter pub get...',
+    'update.pubGet': 'Instalando pacotes do Flutter (flutter pub get)...',
     'update.pubGetDone': 'Dependencias atualizadas',
-    'update.pubGetFailed': 'flutter pub get falhou — execute manualmente',
-    'update.buildRunner': 'Executando build_runner...',
+    'update.pubGetFailed': 'Falha ao instalar pacotes do Flutter — execute `flutter pub get` manualmente',
+    'update.buildRunner': 'Gerando código (Riverpod/Freezed)...',
     'update.buildRunnerDone': 'Geração de código concluída',
-    'update.buildRunnerFailed': 'build_runner falhou — execute manualmente',
+    'update.buildRunnerFailed': 'Geração de código falhou — execute `dart run build_runner build` manualmente',
     'update.success': 'Feature "{module}" atualizada com sucesso.',
     'update.componentsSuccess': 'Componentes base atualizados com sucesso.',
     'update.coreSuccess': 'Arquivos de core atualizados com sucesso.',
+    'check.intro': 'Kasy Check — Notificações Push',
+    'check.firebase.detected': 'Backend Firebase',
+    'check.firebase.adcInfo': 'Firebase usa Application Default Credentials — nenhuma configuração extra necessária.',
+    'check.apns.warn': 'Push iOS requer APNs Key (não verificável via CLI)',
+    'check.apns.where': 'Firebase Console → Cloud Messaging → app iOS → Chave de autenticação APNs',
+    'check.done': 'Pronto',
+    'check.notKasy': 'Esse diretório não parece ser um projeto Kasy.',
+    'check.aborted': 'Cancelado',
+    'check.supabase.notLinked': 'Projeto Supabase não vinculado',
+    'check.supabase.notLinkedHint': 'execute: supabase link --project-ref SEU_REF',
+    'check.supabase.linked': 'Projeto vinculado',
+    'check.spin.secrets': 'Verificando secrets…',
+    'check.spin.secretsDone': 'Secrets verificados',
+    'check.secrets.listFailed': 'Não foi possível listar secrets',
+    'check.secrets.checkLogin': 'verifique: supabase login',
+    'check.fbProjId.ok': 'FIREBASE_PROJECT_ID configurado',
+    'check.fbProjId.missing': 'FIREBASE_PROJECT_ID ausente',
+    'check.fbProjId.fixHint': 'Corrija: supabase secrets set FIREBASE_PROJECT_ID="{id}"',
+    'check.fbProjId.fixed': 'FIREBASE_PROJECT_ID → configurado automaticamente',
+    'check.fbProjId.fixFailed': 'FIREBASE_PROJECT_ID → falhou ao configurar',
+    'check.fbSak.ok': 'FIREBASE_SERVICE_ACCOUNT_JSON configurado',
+    'check.fbSak.missing': 'FIREBASE_SERVICE_ACCOUNT_JSON ausente',
+    'check.fbSak.spin': 'Gerando e configurando chave FCM…',
+    'check.fbSak.spinDone': 'Chave FCM gerada',
+    'check.fbSak.fixed': 'FIREBASE_SERVICE_ACCOUNT_JSON → configurado automaticamente',
+    'check.fbSak.fixFailed': 'FIREBASE_SERVICE_ACCOUNT_JSON → falhou ao configurar',
+    'check.fbSak.genFailed': 'FIREBASE_SERVICE_ACCOUNT_JSON → não foi possível gerar chave',
+    'check.fbSak.manual': "Manual: Firebase Console → Configurações → Contas de serviço → Gerar chave\nDepois: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat chave.json)'",
+    'check.fbSak.hint': "Corrija automaticamente: kasy check --fix\nOu manualmente: Firebase Console → Configurações → Contas de serviço → Gerar chave\nDepois: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat chave.json)'",
+    'check.fn.spin': 'Verificando edge functions…',
+    'check.fn.spinDone': 'Edge functions verificadas',
+    'check.fn.listFailed': 'Não foi possível listar edge functions',
+    'check.fn.deployed': 'Edge function send-push-notification deployada',
+    'check.fn.missing': 'Edge function send-push-notification não deployada',
+    'check.fn.deploySpin': 'Publicando send-push-notification…',
+    'check.fn.deployDone': 'send-push-notification → deployada automaticamente',
+    'check.fn.deployFailed': 'send-push-notification → falhou no deploy',
+    'check.fn.hint': 'Corrija automaticamente: kasy check --fix\nOu manualmente: supabase functions deploy send-push-notification',
+    'deploy.firebase.intro': 'Deploy — Firebase',
+    'deploy.firebase.spin': 'Publicando no Firebase...',
+    'deploy.firebase.spinDone': 'Deploy do Firebase concluído',
+    'deploy.apns.title': 'Push iOS: configure a APNs Key no Firebase Console',
+    'deploy.apns.step1': '1. Apple Developer Portal → Keys → criar APNs Key (.p8)',
+    'deploy.apns.step2': '2. Firebase Console → Cloud Messaging → app iOS → upload da APNs Key',
+    'deploy.supabase.intro': 'Deploy — Supabase',
+    'deploy.supabase.notLinked': 'Projeto Supabase não está vinculado neste diretório.',
+    'deploy.supabase.linkHint': 'Execute: supabase link --project-ref SEU_PROJECT_REF',
+    'deploy.supabase.projectRef': 'Project ref: {ref}',
+    'deploy.supabase.sakAlready': 'FIREBASE_SERVICE_ACCOUNT_JSON já configurado',
+    'deploy.supabase.sakSpin': 'Gerando chave FCM (Service Account)…',
+    'deploy.supabase.sakSpinDone': 'Chave FCM gerada',
+    'deploy.supabase.sakManual': "Configure manualmente: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='...'",
+    'deploy.supabase.sakNoGS': 'google-services.json não encontrado — configure manualmente',
+    'deploy.supabase.fnSpin': 'Publicando edge functions…',
+    'deploy.supabase.fnSpinDone': 'Edge functions processadas',
+    'deploy.supabase.fnNone': 'edge functions (nenhuma encontrada)',
+    'deploy.outro': 'Deploy concluído',
   },
   es: {
     'cli.tagline': 'Crea apps móviles sin dolor de configuración',
@@ -1539,7 +1653,7 @@ const MESSAGES = {
     'new.checks.environment.done': 'Entorno listo',
     'setup.checks.backend.checking': 'Verificando herramientas {backend}',
     'setup.checks.backend.done': 'Herramientas {backend} listas',
-    'new.checks.firebaseForPush': 'Nota: Firebase CLI es obligatorio para notificaciones push (FCM) en todos los backends.',
+    'new.checks.firebaseForPush': 'Nota: Firebase CLI es obligatorio para notificaciones push (Firebase Cloud Messaging / FCM) en todos los backends.',
     'new.checks.requiredBlock': 'Faltan herramientas obligatorias. Instalalas para continuar.',
     'new.checks.installFirebase': 'Firebase: npm i -g firebase-tools && firebase login. FlutterFire: dart pub global activate flutterfire_cli',
     'new.checks.installSupabase': 'Supabase: npm i -g supabase (o brew install supabase/tap/supabase) && supabase login',
@@ -2134,15 +2248,15 @@ const MESSAGES = {
     'add.error.unknownModule': 'Feature desconocida: {module}\nDisponibles: {list}',
     'add.alreadyActive': 'La feature "{module}" ya está activa en este proyecto.',
     'add.applying': 'Agregando feature: {module}',
-    'add.applyingPatch': 'Aplicando archivos de patch...',
+    'add.applyingPatch': 'Aplicando cambios de la feature...',
     'add.patchApplied': 'Patch aplicado',
     'add.patchFailed': 'Patch fallo — revisa la salida anterior',
-    'add.pubGet': 'Ejecutando flutter pub get...',
+    'add.pubGet': 'Instalando paquetes de Flutter (flutter pub get)...',
     'add.pubGetDone': 'Dependencias actualizadas',
-    'add.pubGetFailed': 'flutter pub get fallo — ejecutalo manualmente',
-    'add.buildRunner': 'Ejecutando build_runner...',
+    'add.pubGetFailed': 'Falló al instalar paquetes de Flutter — ejecuta `flutter pub get` manualmente',
+    'add.buildRunner': 'Generando código (Riverpod/Freezed)...',
     'add.buildRunnerDone': 'Generación de código completada',
-    'add.buildRunnerFailed': 'build_runner fallo — ejecutalo manualmente',
+    'add.buildRunnerFailed': 'Generación de código falló — ejecuta `dart run build_runner build` manualmente',
     'add.success': 'Feature "{module}" agregada exitosamente.',
     'add.cancelled': 'Cancelado.',
     'add.prompt.sentryDsn': 'Sentry DSN (deja en blanco para configurar después):',
@@ -2177,12 +2291,12 @@ const MESSAGES = {
     'remove.confirm': 'Eliminar la feature "{module}"? Esto borrara archivos y dependencias.',
     'remove.cancelled': 'Cancelado.',
     'remove.removing': 'Eliminando feature: {module}',
-    'remove.pubGet': 'Ejecutando flutter pub get...',
+    'remove.pubGet': 'Instalando paquetes de Flutter (flutter pub get)...',
     'remove.pubGetDone': 'Dependencias actualizadas',
-    'remove.pubGetFailed': 'flutter pub get fallo — ejecutalo manualmente',
-    'remove.buildRunner': 'Ejecutando build_runner...',
+    'remove.pubGetFailed': 'Falló al instalar paquetes de Flutter — ejecuta `flutter pub get` manualmente',
+    'remove.buildRunner': 'Generando código (Riverpod/Freezed)...',
     'remove.buildRunnerDone': 'Generación de código completada',
-    'remove.buildRunnerFailed': 'build_runner fallo — ejecutalo manualmente',
+    'remove.buildRunnerFailed': 'Generación de código falló — ejecuta `dart run build_runner build` manualmente',
     'remove.success': 'Feature "{module}" eliminada exitosamente.',
     '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).',
@@ -2215,15 +2329,72 @@ const MESSAGES = {
     'update.applyComponentsFailed': 'Error al aplicar actualización de componentes base',
     'update.noPatch': 'La feature "{module}" no tiene archivos para actualizar (feature solo de configuración).',
     'update.noComponentFiles': 'No se encontraron archivos de componentes base para actualizar.',
-    'update.pubGet': 'Ejecutando flutter pub get...',
+    'update.pubGet': 'Instalando paquetes de Flutter (flutter pub get)...',
     'update.pubGetDone': 'Dependencias actualizadas',
-    'update.pubGetFailed': 'flutter pub get fallo — ejecutalo manualmente',
-    'update.buildRunner': 'Ejecutando build_runner...',
+    'update.pubGetFailed': 'Falló al instalar paquetes de Flutter — ejecuta `flutter pub get` manualmente',
+    'update.buildRunner': 'Generando código (Riverpod/Freezed)...',
     'update.buildRunnerDone': 'Generación de código completada',
-    'update.buildRunnerFailed': 'build_runner fallo — ejecutalo manualmente',
+    'update.buildRunnerFailed': 'Generación de código falló — ejecuta `dart run build_runner build` manualmente',
     'update.success': 'Feature "{module}" actualizada exitosamente.',
     'update.componentsSuccess': 'Componentes base actualizados exitosamente.',
     'update.coreSuccess': 'Archivos de core actualizados exitosamente.',
+    'check.intro': 'Kasy Check — Notificaciones Push',
+    'check.firebase.detected': 'Backend Firebase',
+    'check.firebase.adcInfo': 'Firebase usa Application Default Credentials — no requiere configuración extra.',
+    'check.apns.warn': 'Push iOS requiere APNs Key (no verificable via CLI)',
+    'check.apns.where': 'Firebase Console → Cloud Messaging → app iOS → Clave de autenticación APNs',
+    'check.done': 'Listo',
+    'check.notKasy': 'Este directorio no parece ser un proyecto Kasy.',
+    'check.aborted': 'Cancelado',
+    'check.supabase.notLinked': 'Proyecto Supabase no vinculado',
+    'check.supabase.notLinkedHint': 'ejecuta: supabase link --project-ref TU_REF',
+    'check.supabase.linked': 'Proyecto vinculado',
+    'check.spin.secrets': 'Verificando secrets…',
+    'check.spin.secretsDone': 'Secrets verificados',
+    'check.secrets.listFailed': 'No se pudo listar los secrets',
+    'check.secrets.checkLogin': 'verifica: supabase login',
+    'check.fbProjId.ok': 'FIREBASE_PROJECT_ID configurado',
+    'check.fbProjId.missing': 'FIREBASE_PROJECT_ID ausente',
+    'check.fbProjId.fixHint': 'Corrige: supabase secrets set FIREBASE_PROJECT_ID="{id}"',
+    'check.fbProjId.fixed': 'FIREBASE_PROJECT_ID → configurado automáticamente',
+    'check.fbProjId.fixFailed': 'FIREBASE_PROJECT_ID → falló al configurar',
+    'check.fbSak.ok': 'FIREBASE_SERVICE_ACCOUNT_JSON configurado',
+    'check.fbSak.missing': 'FIREBASE_SERVICE_ACCOUNT_JSON ausente',
+    'check.fbSak.spin': 'Generando y configurando clave FCM…',
+    'check.fbSak.spinDone': 'Clave FCM generada',
+    'check.fbSak.fixed': 'FIREBASE_SERVICE_ACCOUNT_JSON → configurado automáticamente',
+    'check.fbSak.fixFailed': 'FIREBASE_SERVICE_ACCOUNT_JSON → falló al configurar',
+    'check.fbSak.genFailed': 'FIREBASE_SERVICE_ACCOUNT_JSON → no se pudo generar la clave',
+    'check.fbSak.manual': "Manual: Firebase Console → Configuración → Cuentas de servicio → Generar clave\nLuego: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat clave.json)'",
+    'check.fbSak.hint': "Corrige automáticamente: kasy check --fix\nO manualmente: Firebase Console → Configuración → Cuentas de servicio → Generar clave\nLuego: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='$(cat clave.json)'",
+    'check.fn.spin': 'Verificando edge functions…',
+    'check.fn.spinDone': 'Edge functions verificadas',
+    'check.fn.listFailed': 'No se pudo listar edge functions',
+    'check.fn.deployed': 'Edge function send-push-notification publicada',
+    'check.fn.missing': 'Edge function send-push-notification no publicada',
+    'check.fn.deploySpin': 'Publicando send-push-notification…',
+    'check.fn.deployDone': 'send-push-notification → publicada automáticamente',
+    'check.fn.deployFailed': 'send-push-notification → falló el deploy',
+    'check.fn.hint': 'Corrige automáticamente: kasy check --fix\nO manualmente: supabase functions deploy send-push-notification',
+    'deploy.firebase.intro': 'Deploy — Firebase',
+    'deploy.firebase.spin': 'Publicando en Firebase...',
+    'deploy.firebase.spinDone': 'Deploy de Firebase completado',
+    'deploy.apns.title': 'Push iOS: configura la APNs Key en Firebase Console',
+    'deploy.apns.step1': '1. Apple Developer Portal → Keys → crear APNs Key (.p8)',
+    'deploy.apns.step2': '2. Firebase Console → Cloud Messaging → app iOS → subir APNs Key',
+    'deploy.supabase.intro': 'Deploy — Supabase',
+    'deploy.supabase.notLinked': 'Proyecto Supabase no vinculado en este directorio.',
+    'deploy.supabase.linkHint': 'Ejecuta: supabase link --project-ref TU_PROJECT_REF',
+    'deploy.supabase.projectRef': 'Project ref: {ref}',
+    'deploy.supabase.sakAlready': 'FIREBASE_SERVICE_ACCOUNT_JSON ya configurado',
+    'deploy.supabase.sakSpin': 'Generando clave FCM (Service Account)…',
+    'deploy.supabase.sakSpinDone': 'Clave FCM generada',
+    'deploy.supabase.sakManual': "Configura manualmente: supabase secrets set FIREBASE_SERVICE_ACCOUNT_JSON='...'",
+    'deploy.supabase.sakNoGS': 'google-services.json no encontrado — configura manualmente',
+    'deploy.supabase.fnSpin': 'Publicando edge functions…',
+    'deploy.supabase.fnSpinDone': 'Edge functions procesadas',
+    'deploy.supabase.fnNone': 'edge functions (ninguna encontrada)',
+    'deploy.outro': 'Deploy completado',
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.10.0",
+  "version": "1.12.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/core/initializer/onstart_widget.dart

@@ -64,7 +64,13 @@ class _InitializerState extends ConsumerState<Initializer> {
         Sentry.captureException(e, stackTrace: s);
         ref.read(onStartProvider.notifier).notifyError(e.toString());
       } finally {
-        FlutterNativeSplash.remove();
+        // Defer splash removal until after the next frame is painted so the
+        // onReady widget renders under the splash before it disappears.
+        // Without this, the splash is removed before the new frame paints,
+        // briefly revealing the onLoading widget (visible flash).
+        WidgetsBinding.instance.addPostFrameCallback((_) {
+          FlutterNativeSplash.remove();
+        });
       }
     });
   }