kasy-cli 1.15.0 → 1.16.0

package/lib/commands/icon.js

@@ -7,11 +7,17 @@ const ui = require('../utils/ui');
 const { printCompactHeader } = require('../utils/brand');
 const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
 const { inspectPng } = require('./splash');
+const {
+  writeAndroidAdaptiveBackground,
+  writeTransparentSquare,
+} = require('../utils/png-padding');
 
 const execAsync = promisify(exec);
 
 const ASSETS_DIR = path.join('assets', 'images');
 const ICON_NAME = 'icon.png';
+const ANDROID_BG_NAME = 'icon_android.png';
+const ANDROID_FG_EMPTY_NAME = 'icon_foreground_empty.png';
 
 async function assertKasyProject(projectDir, t) {
   const kitSetupPath = path.join(projectDir, 'kit_setup.json');
@@ -85,13 +91,35 @@ async function runIcon(projectDir, options = {}) {
     ui.note(warnings.map((w) => `${kleur.yellow('⚠')} ${w}`).join('\n'), t('icon.warn.title'));
   }
 
-  const dest = path.join(projectDir, ASSETS_DIR, ICON_NAME);
+  const assetsDir = path.join(projectDir, ASSETS_DIR);
+  const dest = path.join(assetsDir, ICON_NAME);
+  const androidBgDest = path.join(assetsDir, ANDROID_BG_NAME);
+  const androidFgEmptyDest = path.join(assetsDir, ANDROID_FG_EMPTY_NAME);
 
   const copySpinner = ui.spinner();
   copySpinner.start(t('icon.copying'));
   await fs.copy(imagePath, dest, { overwrite: true });
   copySpinner.stop(t('icon.copied'));
 
+  const adaptiveSpinner = ui.spinner();
+  adaptiveSpinner.start(t('icon.adaptive.generating'));
+  let adaptiveInfo;
+  try {
+    adaptiveInfo = await writeAndroidAdaptiveBackground(dest, androidBgDest);
+    if (!(await fs.pathExists(androidFgEmptyDest))) {
+      await writeTransparentSquare(androidFgEmptyDest);
+    }
+    adaptiveSpinner.stop(t('icon.adaptive.generated'));
+  } catch (err) {
+    adaptiveSpinner.stop(`⚠ ${t('icon.adaptive.failed')}`);
+    ui.log.message(kleur.dim(err.message || String(err)));
+    process.exit(1);
+  }
+
+  if (!adaptiveInfo.color.sampled) {
+    ui.note(t('icon.adaptive.fallbackColor'), t('icon.adaptive.fallbackTitle'));
+  }
+
   if (options.skipGenerate) {
     ui.note(t('icon.skipGenerate.hint'), t('icon.skipGenerate.title'));
     ui.outro(t('icon.done'));

package/lib/commands/run.js

@@ -1,10 +1,52 @@
 const path = require('node:path');
+const { spawnSync } = require('node:child_process');
 const fs = require('fs-extra');
 const kleur = require('kleur');
+const ui = require('../utils/ui');
 const { createTranslator, detectDefaultLanguage } = require('../utils/i18n');
 const { printCompactHeader } = require('../utils/brand');
 const { spawnFlutterWithSpinner } = require('../utils/flutter-run');
 
+function listFlutterDevices(projectDir) {
+  const res = spawnSync('flutter', ['devices', '--machine'], {
+    cwd: projectDir,
+    encoding: 'utf8',
+  });
+  if (res.status !== 0) return [];
+  try {
+    const parsed = JSON.parse(res.stdout);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
+}
+
+function classifyDevice(device) {
+  const platform = (device.targetPlatform || '').toLowerCase();
+  if (platform === 'ios') return device.emulator ? 'ios-simulator' : 'ios-device';
+  if (platform.startsWith('android')) {
+    return device.emulator ? 'android-emulator' : 'android-device';
+  }
+  if (platform.startsWith('web')) return 'web';
+  if (platform.startsWith('darwin')) return 'macos';
+  if (platform.startsWith('linux')) return 'linux';
+  if (platform.startsWith('windows')) return 'windows';
+  return 'unknown';
+}
+
+async function pickDevice(devices, t) {
+  if (devices.length === 0) return null;
+  if (devices.length === 1) return devices[0];
+  const choice = await ui.select({
+    message: t('run.prompt.pickDevice'),
+    options: devices.map((d) => ({
+      value: d.id,
+      label: `${d.name} ${kleur.dim(`(${classifyDevice(d)})`)}`,
+    })),
+  });
+  return devices.find((d) => d.id === choice) || null;
+}
+
 /**
  * Read dart-define args from .vscode/launch.json.
  * Returns the args array from the matching config (dev or prod).
@@ -35,8 +77,11 @@ async function runRun(directory, options = {}) {
     throw new Error(t('run.error.notFlutterProject'));
   }
 
-  // Resolve device flag
+  // Resolve device flag. If none of the platform shortcuts or -d is set,
+  // ask the user when more than one device is available — `flutter run`
+  // bails out with "More than one device connected" otherwise.
   const deviceArgs = [];
+  let resolvedDeviceLabel = null;
   if (options.web) {
     deviceArgs.push('-d', 'chrome');
   } else if (options.ios) {
@@ -45,6 +90,20 @@ async function runRun(directory, options = {}) {
     deviceArgs.push('-d', 'android');
   } else if (options.device) {
     deviceArgs.push('-d', options.device);
+  } else {
+    const devices = listFlutterDevices(projectDir);
+    if (devices.length > 1) {
+      printCompactHeader(t);
+      const picked = await pickDevice(devices, t);
+      if (!picked) {
+        console.log(kleur.yellow(`  ⚠  ${t('run.warn.nothingSelected')}`));
+        return;
+      }
+      deviceArgs.push('-d', picked.id);
+      resolvedDeviceLabel = `${picked.name} (${picked.id})`;
+    }
+    // 0 or 1 device → let flutter handle it; it picks the only one or
+    // prints its own "no devices" message.
   }
 
   // Read dart-defines from .vscode/launch.json (skip if --no-defines)
@@ -62,7 +121,7 @@ async function runRun(directory, options = {}) {
     ? 'ios'
     : options.android
     ? 'android'
-    : options.device || null;
+    : options.device || resolvedDeviceLabel || null;
   const summaryParts = [];
   if (envValue) summaryParts.push(`ENV=${envValue}`);
   if (deviceLabel) summaryParts.push(`device: ${deviceLabel}`);

package/lib/scaffold/backends/api/pubspec.yaml.tpl

@@ -98,6 +98,8 @@ flutter_launcher_icons:
   android: ic_launcher
   ios: true
   remove_alpha_ios: true
+  adaptive_icon_background: assets/images/icon_android.png
+  adaptive_icon_foreground: assets/images/icon_foreground_empty.png
   web:
     generate: true
     image_path: assets/images/favicon.png

package/lib/scaffold/backends/supabase/pubspec.yaml.tpl

@@ -100,6 +100,8 @@ flutter_launcher_icons:
   android: ic_launcher
   ios: true
   remove_alpha_ios: true
+  adaptive_icon_background: assets/images/icon_android.png
+  adaptive_icon_foreground: assets/images/icon_foreground_empty.png
   web:
     generate: true
     image_path: assets/images/favicon.png

package/lib/utils/i18n/messages-en.js

@@ -645,6 +645,8 @@ module.exports = {
     // run command
     'cli.command.run.description': 'Run your app on phone, simulator, or browser',
     'run.launching': 'Launching Flutter app...',
+    'run.prompt.pickDevice': 'Multiple devices detected. Which one do you want to run on?',
+    'run.warn.nothingSelected': 'No device selected.',
     'run.updateHint.prefix': 'Project improvements available —',
     'run.updateHint.suffix': 'to see what\'s new',
     'run.spinner.building': 'Starting Flutter…',
@@ -746,6 +748,11 @@ module.exports = {
     'icon.validated': 'PNG looks good',
     'icon.copying': 'Copying icon to assets/images/icon.png...',
     'icon.copied': 'Icon copied',
+    'icon.adaptive.generating': 'Generating Android adaptive variant (fills the launcher circle)...',
+    'icon.adaptive.generated': 'Android adaptive icon generated',
+    'icon.adaptive.failed': 'Failed to generate Android adaptive icon',
+    'icon.adaptive.fallbackTitle': 'Android background',
+    'icon.adaptive.fallbackColor': 'Could not sample a background color from the PNG (transparent). Used white. Edit icon_android.png if you want a different color.',
     'icon.generating': 'Regenerating native icons (Android + iOS)...',
     'icon.generated': 'Native icons regenerated',
     'icon.done': 'Done. Uninstall the app from the device and reinstall to see the new icon.',

package/lib/utils/i18n/messages-es.js

@@ -678,6 +678,8 @@ module.exports = {
     'reset.warn.launcherCacheFailed': 'No se pudo limpiar la caché del launcher.',
     'reset.warn.launcherNotDetected': 'Launcher por defecto no detectado — saltando limpieza de caché.',
     'run.launching': 'Iniciando app Flutter...',
+    'run.prompt.pickDevice': 'Varios dispositivos detectados. ¿En cuál quieres ejecutar?',
+    'run.warn.nothingSelected': 'Ningún dispositivo seleccionado.',
     'run.updateHint.prefix': 'Mejoras disponibles para el proyecto —',
     'run.updateHint.suffix': 'para ver las novedades',
     'run.spinner.building': 'Iniciando Flutter…',
@@ -744,6 +746,11 @@ module.exports = {
     'icon.validated': 'PNG está bien',
     'icon.copying': 'Copiando ícono a assets/images/icon.png...',
     'icon.copied': 'Ícono copiado',
+    'icon.adaptive.generating': 'Generando variante adaptive para Android (llena el círculo del launcher)...',
+    'icon.adaptive.generated': 'Adaptive icon Android generado',
+    'icon.adaptive.failed': 'Fallo al generar adaptive icon Android',
+    'icon.adaptive.fallbackTitle': 'Fondo Android',
+    'icon.adaptive.fallbackColor': 'No pude muestrear el color de fondo del PNG (transparente). Usé blanco. Edita icon_android.png si quieres otro color.',
     'icon.generating': 'Regenerando íconos nativos (Android + iOS)...',
     'icon.generated': 'Íconos nativos regenerados',
     'icon.done': 'Listo. Desinstala el app del dispositivo y reinstala para ver el nuevo ícono.',

package/lib/utils/i18n/messages-pt.js

@@ -678,6 +678,8 @@ module.exports = {
     'reset.warn.launcherCacheFailed': 'Não foi possível limpar o cache do launcher.',
     'reset.warn.launcherNotDetected': 'Launcher padrão não detectado — pulando limpeza de cache.',
     'run.launching': 'Iniciando app Flutter...',
+    'run.prompt.pickDevice': 'Vários dispositivos detectados. Em qual deles rodar?',
+    'run.warn.nothingSelected': 'Nenhum dispositivo selecionado.',
     'run.updateHint.prefix': 'Melhorias disponíveis para o projeto —',
     'run.updateHint.suffix': 'para ver o que há de novo',
     'run.spinner.building': 'Iniciando Flutter…',
@@ -744,6 +746,11 @@ module.exports = {
     'icon.validated': 'PNG está bom',
     'icon.copying': 'Copiando ícone para assets/images/icon.png...',
     'icon.copied': 'Ícone copiado',
+    'icon.adaptive.generating': 'Gerando versão adaptive para Android (preenche o círculo do launcher)...',
+    'icon.adaptive.generated': 'Adaptive icon Android gerado',
+    'icon.adaptive.failed': 'Falha ao gerar adaptive icon Android',
+    'icon.adaptive.fallbackTitle': 'Fundo Android',
+    'icon.adaptive.fallbackColor': 'Não consegui amostrar a cor de fundo do PNG (transparente). Usei branco. Se quiser outra cor, edite icon_android.png à mão.',
     'icon.generating': 'Regenerando ícones nativos (Android + iOS)...',
     'icon.generated': 'Ícones nativos regenerados',
     'icon.done': 'Pronto. Desinstale o app do dispositivo e reinstale para ver o novo ícone.',

package/lib/utils/png-padding.js

@@ -1,7 +1,9 @@
 const fsp = require('node:fs/promises');
 const { PNG } = require('pngjs');
 
-const ANDROID12_SAFE_RATIO = 0.5;
+const ANDROID12_SAFE_RATIO = 0.4;
+const ANDROID_ADAPTIVE_LOGO_RATIO = 0.65;
+const ANDROID_ADAPTIVE_CANVAS = 1024;
 
 async function readPng(filePath) {
   const buffer = await fsp.readFile(filePath);
@@ -117,4 +119,134 @@ async function writeAndroid12Variant(srcPath, dstPath, safeRatio = ANDROID12_SAF
   return { canvasSize, logoW, logoH };
 }
 
-module.exports = { writeAndroid12Variant, ANDROID12_SAFE_RATIO };
+function sampleSolidBackground(png) {
+  const inset = Math.max(2, Math.floor(Math.min(png.width, png.height) * 0.02));
+  const corners = [
+    [inset, inset],
+    [png.width - inset - 1, inset],
+    [inset, png.height - inset - 1],
+    [png.width - inset - 1, png.height - inset - 1],
+  ];
+
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  let opaque = 0;
+  for (const [x, y] of corners) {
+    const idx = (y * png.width + x) * 4;
+    const alpha = png.data[idx + 3];
+    if (alpha < 250) continue;
+    r += png.data[idx];
+    g += png.data[idx + 1];
+    b += png.data[idx + 2];
+    opaque += 1;
+  }
+
+  if (opaque === 0) {
+    return { r: 255, g: 255, b: 255, sampled: false };
+  }
+  return {
+    r: Math.round(r / opaque),
+    g: Math.round(g / opaque),
+    b: Math.round(b / opaque),
+    sampled: true,
+  };
+}
+
+function fillSolidColor(png, color) {
+  for (let i = 0; i < png.data.length; i += 4) {
+    png.data[i] = color.r;
+    png.data[i + 1] = color.g;
+    png.data[i + 2] = color.b;
+    png.data[i + 3] = 255;
+  }
+}
+
+function compositeLogoOnBackground(background, logo) {
+  const offsetX = Math.floor((background.width - logo.width) / 2);
+  const offsetY = Math.floor((background.height - logo.height) / 2);
+
+  for (let y = 0; y < logo.height; y++) {
+    for (let x = 0; x < logo.width; x++) {
+      const srcIdx = (y * logo.width + x) * 4;
+      const alpha = logo.data[srcIdx + 3] / 255;
+      if (alpha === 0) continue;
+
+      const dstIdx = ((y + offsetY) * background.width + (x + offsetX)) * 4;
+      const inv = 1 - alpha;
+      background.data[dstIdx] = Math.round(logo.data[srcIdx] * alpha + background.data[dstIdx] * inv);
+      background.data[dstIdx + 1] = Math.round(logo.data[srcIdx + 1] * alpha + background.data[dstIdx + 1] * inv);
+      background.data[dstIdx + 2] = Math.round(logo.data[srcIdx + 2] * alpha + background.data[dstIdx + 2] * inv);
+      background.data[dstIdx + 3] = 255;
+    }
+  }
+}
+
+/**
+ * Generate the Android adaptive icon background asset. Reads the user-supplied
+ * icon PNG, samples a solid background color from its corners (falling back to
+ * white when the image is transparent), and writes a square canvas with the
+ * logo scaled down and centered. The result is what `flutter_launcher_icons`
+ * passes to `adaptive_icon_background`, fully filling the launcher's circular
+ * mask without the default white halo around square icons.
+ *
+ * @param {string} srcPath source icon PNG path
+ * @param {string} dstPath output path for icon_android.png
+ * @param {object} [options]
+ * @param {number} [options.canvasSize] output square size (default 1024)
+ * @param {number} [options.logoRatio] logo fill ratio inside canvas (default 0.65)
+ * @param {string} [options.backgroundColor] explicit hex like "#01171f" to override sampling
+ */
+async function writeAndroidAdaptiveBackground(srcPath, dstPath, options = {}) {
+  const canvasSize = options.canvasSize || ANDROID_ADAPTIVE_CANVAS;
+  const logoRatio = options.logoRatio || ANDROID_ADAPTIVE_LOGO_RATIO;
+
+  const src = await readPng(srcPath);
+
+  let color;
+  if (options.backgroundColor) {
+    const hex = options.backgroundColor.replace('#', '');
+    color = {
+      r: parseInt(hex.slice(0, 2), 16),
+      g: parseInt(hex.slice(2, 4), 16),
+      b: parseInt(hex.slice(4, 6), 16),
+      sampled: false,
+    };
+  } else {
+    color = sampleSolidBackground(src);
+  }
+
+  const canvas = new PNG({ width: canvasSize, height: canvasSize });
+  fillSolidColor(canvas, color);
+
+  const logoSize = Math.round(canvasSize * logoRatio);
+  const resized = resizeBilinear(src, logoSize, logoSize);
+  compositeLogoOnBackground(canvas, resized);
+
+  await writePng(canvas, dstPath);
+  return { canvasSize, logoSize, color };
+}
+
+/**
+ * Write a fully transparent square PNG. Used to satisfy
+ * `adaptive_icon_foreground` when the entire image already lives in the
+ * background layer.
+ *
+ * @param {string} dstPath
+ * @param {number} [size]
+ */
+async function writeTransparentSquare(dstPath, size = ANDROID_ADAPTIVE_CANVAS) {
+  const png = new PNG({ width: size, height: size });
+  png.data.fill(0);
+  await writePng(png, dstPath);
+  return { size };
+}
+
+module.exports = {
+  writeAndroid12Variant,
+  writeAndroidAdaptiveBackground,
+  writeTransparentSquare,
+  ANDROID12_SAFE_RATIO,
+  ANDROID_ADAPTIVE_LOGO_RATIO,
+  ANDROID_ADAPTIVE_CANVAS,
+};

package/package.json

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

package/templates/firebase/web/index.html

@@ -38,6 +38,8 @@
   
   
   
+  
+  
   <style id="splash-screen-style">
     html {
       height: 100%
@@ -120,6 +122,7 @@
   
   
   
+  
   <script src="flutter_bootstrap.js" async=""></script>
   <script src="./local_notifications.js"></script>