kasy-cli 1.16.0 → 1.18.0

package/lib/utils/ui.js

@@ -91,8 +91,20 @@ function cancel(message) { clack.cancel(message); }
  * Spinner integrated with Clack's vertical line (│).
  * Returns: { start(msg), message(msg), stop(msg, code?) }
  * code: 0 = success (✦), 1 = cancel (■), 2 = error (▲)
+ *
+ * Optional `color` paints every text passed through (start/message/stop) —
+ * pass `paintLime` (from utils/brand) for the Kasy brand color.
  */
-function spinner() { return clack.spinner(); }
+function spinner({ color } = {}) {
+  const s = clack.spinner();
+  if (typeof color !== 'function') return s;
+  return {
+    start(msg) { s.start(msg != null ? color(msg) : msg); },
+    message(msg) { s.message(msg != null ? color(msg) : msg); },
+    stop(msg, code) { s.stop(msg != null ? color(msg) : msg, code); },
+    error(msg) { s.error(msg != null ? color(msg) : msg); },
+  };
+}
 
 /**
  * Spinner with an automatic elapsed-time suffix that ticks every second.
@@ -104,16 +116,18 @@ function spinner() { return clack.spinner(); }
  *   // ... 73 seconds later
  *   s.stop('Deploy done');          // "Deploy done  [1m 13s]"
  */
-function timedSpinner() {
+function timedSpinner({ color } = {}) {
   const s = clack.spinner();
+  const paint = typeof color === 'function' ? color : (t) => t;
   let startTime = null;
   let currentMessage = '';
   let tick = null;
 
   const render = (msg) => {
     if (!msg) return '';
-    if (!startTime) return msg;
-    return `${msg}  ${kleur.dim(`[${formatElapsedSeconds(startTime)}]`)}`;
+    const painted = paint(msg);
+    if (!startTime) return painted;
+    return `${painted}  ${kleur.dim(`[${formatElapsedSeconds(startTime)}]`)}`;
   };
 
   const stopTick = () => {
@@ -197,6 +211,66 @@ function makeTimedStepper() {
   };
 }
 
+/**
+ * Single-line stepper for Quick mode. Same API as makeTimedStepper, but every
+ * `.next(text)` mutates the message of a single underlying spinner instead of
+ * closing it and opening a new one — so the user sees one line that keeps
+ * updating ("Creating Firebase project…" → "Waiting for propagation…" → …)
+ * with a running total timer instead of a tall stack of step lines.
+ *
+ * Optional `color` paints the running text (lime in Kasy Quick mode). The
+ * final success/fail message keeps the caller-supplied formatting untouched.
+ */
+function makeQuickStepper({ color } = {}) {
+  const paint = typeof color === 'function' ? color : (t) => t;
+  const s = timedSpinner();
+  let started = false;
+  let currentMsg = '';
+  return {
+    next(text) {
+      currentMsg = text;
+      if (!started) {
+        s.start(paint(text));
+        started = true;
+      } else {
+        s.message(paint(text));
+      }
+    },
+    update(text) {
+      currentMsg = text;
+      if (started) s.message(paint(text));
+    },
+    succeed(text) {
+      if (started) {
+        s.stop(paint(text || currentMsg));
+        started = false;
+        currentMsg = '';
+      }
+    },
+    fail(text) {
+      if (started) {
+        s.error(text || currentMsg);
+        started = false;
+        currentMsg = '';
+      }
+    },
+    warn(text) {
+      if (started) {
+        s.stop(`⚠ ${text || currentMsg}`);
+        started = false;
+        currentMsg = '';
+      }
+    },
+    stop() {
+      if (started) {
+        s.stop(paint(currentMsg));
+        started = false;
+        currentMsg = '';
+      }
+    },
+  };
+}
+
 /**
  * Multi-step spinner: each .next(text) succeeds the previous step
  * with the previous message, then starts a new step with `text`.
@@ -281,6 +355,7 @@ module.exports = {
   timedSpinner,
   makeStepper,
   makeTimedStepper,
+  makeQuickStepper,
   taskLog,
   progress,
   log,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.16.0",
+  "version": "1.18.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/README.en.md

@@ -48,16 +48,26 @@ They live in `.vscode/launch.json` as build environment variables (`--dart-defin
 
 | Variable | Module | How to get |
 |----------|--------|------------|
-| `RC_ANDROID_API_KEY` | RevenueCat | RevenueCat dashboard → Apps → Android → **Google Play** public key (`goog_…`) |
-| `RC_IOS_API_KEY` | RevenueCat | RevenueCat dashboard → Apps → iOS → **Apple App Store** public key (`appl_…`) |
+| `RC_TEST_KEY` | RevenueCat | RevenueCat dashboard → Apps → Test Store → key (`test_…`). **One key for both iOS+Android.** Auto-used on simulator/emulator. |
+| `RC_IOS_PROD_KEY` | RevenueCat | RevenueCat dashboard → Apps → App Store → key (`appl_…`). Auto-used on physical iPhone (Sandbox and Production). |
+| `RC_ANDROID_PROD_KEY` | RevenueCat | RevenueCat dashboard → Apps → Google Play → key (`goog_…`). Auto-used on physical Android. |
 | `RC_WEB_API_KEY` | RevenueCat Web | RevenueCat dashboard → Apps → Web Billing → **production** key (`rcb_…`, not `rcb_sb_`) for release builds |
 
-### RevenueCat: `test_` vs store keys (TestFlight / release)
+### RevenueCat: `kasy run` picks the right key automatically
 
-- Keys starting with **`test_`** are RevenueCat **Test Store**: fine for **`flutter run` debug** on your Mac (fake purchases in RC’s test environment). **Do not** bake them into TestFlight/App Store IPAs — the SDK rejects them or the kit skips RC init.
-- **TestFlight / Apple sandbox** (no real charges): use **store** public keys — **`appl_…`** (iOS) and **`goog_…`** (Android). TestFlight purchases still use **Apple/Google sandbox**, not real billing.
-- The VS Code **Firebase — prod** config **no longer** sets RC keys; put `appl_` / `goog_` in **`Firebase/.env`** or **`.dart_defines`** (see `Makefile`) when building release / TestFlight.
-- **Firebase — dev** still ships sample `test_` keys for local development only.
+The CLI detects whether you're running on **simulator/emulator** or **physical device** and injects the right key:
+
+| Where you run | Key used |
+|---|---|
+| iOS Simulator / Android Emulator | `RC_TEST_KEY` (test_) |
+| Physical iPhone | `RC_IOS_PROD_KEY` (appl_) — falls back to `RC_TEST_KEY` if missing |
+| Physical Android | `RC_ANDROID_PROD_KEY` (goog_) — falls back to `RC_TEST_KEY` if missing |
+
+Force manually: `kasy run --rc=test` or `kasy run --rc=prod`. `--rc=auto` (default) applies the rule above.
+
+- **Why the split?** Simulators can't run real in-app purchases against `appl_`/`goog_` — only RevenueCat Test Store works there. On physical devices, `appl_`/`goog_` covers both Sandbox and Production (the SDK detects the environment).
+- **TestFlight and release:** use the production keys. **NEVER ship `test_` to the store** — the RevenueCat SDK crashes the app on release.
+- **VS Code (F5 without kasy run):** `launch.json` defaults to `RC_TEST_KEY` (or production if test_ is missing). To switch manually, run via `kasy run`.
 | `SENTRY_DSN` | Sentry | Dashboard Sentry → Project → DSN |
 | `MIXPANEL_TOKEN` | Mixpanel | Dashboard Mixpanel → Settings → Token |
 
@@ -175,6 +185,6 @@ No Mac: [docs/codemagic-release.md](docs/codemagic-release.md)
 
 ## Security
 
-`.gitignore` already excludes: `firebase_key.json`, `.env`, `.env.*`, `*.pem`, `*.keystore`, `.kasy/apple.env`, `.kasy/codemagic.env`.
+`.gitignore` already excludes: `firebase_key.json`, `.env`, `.env.*`, `*.pem`, `*.keystore`, `.kasy/apple.env`, `.kasy/codemagic.env`, `.kasy/*.log`.
 
 Never commit credentials to the repository.

package/templates/firebase/README.es.md

@@ -48,16 +48,26 @@ Están en `.vscode/launch.json` como variables de entorno de build (`--dart-defi
 
 | Variable | Módulo | Cómo obtener |
 |----------|--------|--------------|
-| `RC_ANDROID_API_KEY` | RevenueCat | Panel RevenueCat → Apps → Android → clave pública **Google Play** (`goog_…`) |
-| `RC_IOS_API_KEY` | RevenueCat | Panel RevenueCat → Apps → iOS → clave pública **Apple App Store** (`appl_…`) |
+| `RC_TEST_KEY` | RevenueCat | Panel RevenueCat → Apps → Test Store → clave (`test_…`). **Una sola clave sirve para iOS+Android.** Usada automáticamente en simulador/emulador. |
+| `RC_IOS_PROD_KEY` | RevenueCat | Panel RevenueCat → Apps → App Store → clave (`appl_…`). Usada automáticamente en iPhone físico (Sandbox y Producción). |
+| `RC_ANDROID_PROD_KEY` | RevenueCat | Panel RevenueCat → Apps → Google Play → clave (`goog_…`). Usada automáticamente en Android físico. |
 | `RC_WEB_API_KEY` | RevenueCat Web | Panel RevenueCat → Apps → Web Billing → clave **producción** (`rcb_…`, no `rcb_sb_`) en builds release |
 
-### RevenueCat: `test_` vs tienda (TestFlight / release)
+### RevenueCat: `kasy run` elige la clave automáticamente
 
-- Clave **`test_`** = **Test Store** de RevenueCat: sirve para **`flutter run` en debug** en tu Mac. **No** la empaques en IPA de TestFlight/App Store.
-- **TestFlight / sandbox de Apple** (sin cobro real): usa claves de **tienda** — **`appl_…`** (iOS) y **`goog_…`** (Android).
-- La config **Firebase — prod** en VS Code **ya no** define RC; pon `appl_` / `goog_` en **`.env`** o **`.dart_defines`** al generar release / TestFlight.
-- **Firebase — dev** sigue con `test_` de ejemplo solo para desarrollo local.
+La CLI detecta si vas a correr en **simulador/emulador** o en **dispositivo físico** e inyecta la clave correcta:
+
+| Dónde corres | Clave usada |
+|---|---|
+| iOS Simulator / Android Emulator | `RC_TEST_KEY` (test_) |
+| iPhone físico | `RC_IOS_PROD_KEY` (appl_) — fallback `RC_TEST_KEY` si falta |
+| Android físico | `RC_ANDROID_PROD_KEY` (goog_) — fallback `RC_TEST_KEY` si falta |
+
+Forzar manualmente: `kasy run --rc=test` o `kasy run --rc=prod`. `--rc=auto` (por defecto) aplica la regla anterior.
+
+- **¿Por qué el split?** Los simuladores no pueden hacer compras reales con claves `appl_`/`goog_` — solo funciona Test Store de RevenueCat. En dispositivo físico, `appl_`/`goog_` cubre Sandbox y Producción (el SDK lo detecta).
+- **TestFlight y release:** usa las claves de producción. **NUNCA subas `test_` a la tienda** — el SDK de RevenueCat crashea el app en release.
+- **VS Code (F5 sin kasy run):** `launch.json` usa `RC_TEST_KEY` por defecto (o producción si test_ falta). Para alternar manualmente, corre `kasy run`.
 | `SENTRY_DSN` | Sentry | Dashboard Sentry → Proyecto → DSN |
 | `MIXPANEL_TOKEN` | Mixpanel | Dashboard Mixpanel → Configuración → Token |
 
@@ -175,6 +185,6 @@ Sin Mac: [docs/codemagic-release.md](docs/codemagic-release.md)
 
 ## Seguridad
 
-El `.gitignore` ya excluye: `firebase_key.json`, `.env`, `.env.*`, `*.pem`, `*.keystore`, `.kasy/apple.env`, `.kasy/codemagic.env`.
+El `.gitignore` ya excluye: `firebase_key.json`, `.env`, `.env.*`, `*.pem`, `*.keystore`, `.kasy/apple.env`, `.kasy/codemagic.env`, `.kasy/*.log`.
 
 Nunca subas credenciales al repositorio.

package/templates/firebase/README.md

@@ -48,16 +48,26 @@ Ficam no `.vscode/launch.json` como variáveis de ambiente de build (`--dart-def
 
 | Variável | Módulo | Como obter |
 |----------|--------|------------|
-| `RC_ANDROID_API_KEY` | RevenueCat | Dashboard RevenueCat → Apps → Android → chave pública **Google Play** (`goog_…`) |
-| `RC_IOS_API_KEY` | RevenueCat | Dashboard RevenueCat → Apps → iOS → chave pública **Apple App Store** (`appl_…`) |
+| `RC_TEST_KEY` | RevenueCat | Dashboard RevenueCat → Apps → Test Store → chave (`test_…`). **Uma chave só, serve pra iOS+Android.** Usada automaticamente em simulador/emulador. |
+| `RC_IOS_PROD_KEY` | RevenueCat | Dashboard RevenueCat → Apps → App Store → chave (`appl_…`). Usada automaticamente em iPhone físico (Sandbox e Produção). |
+| `RC_ANDROID_PROD_KEY` | RevenueCat | Dashboard RevenueCat → Apps → Google Play → chave (`goog_…`). Usada automaticamente em Android físico. |
 | `RC_WEB_API_KEY` | RevenueCat Web | Dashboard RevenueCat → Apps → Web Billing → chave **produção** (`rcb_…`, não `rcb_sb_`) em builds release |
 
-### RevenueCat: `test_` vs loja (TestFlight / release)
+### RevenueCat: `kasy run` escolhe a chave automaticamente
 
-- Chave que começa com **`test_`** = **Test Store** da RevenueCat: serve para **`flutter run` em debug** no Mac (compras fictícias no ambiente de teste da RC). **Não** use em IPA de TestFlight/App Store — o SDK bloqueia ou o app ignora o RC (comportamento atual do kit).
-- **TestFlight / sandbox da Apple** (compras sem cobrar de verdade): use no IPA as chaves públicas de **loja** — **`appl_…`** (iOS) e **`goog_…`** (Android). No TestFlight as compras ainda são **sandbox** da Apple/Google, não cobrança real.
-- A configuração **Firebase — prod** no VS Code **não** define mais RC; coloque `appl_` / `goog_` no seu **`.env`** na raiz do `Firebase/` ou em **`.dart_defines`** (ver `Makefile`) ao gerar release / TestFlight.
-- **Firebase — dev** no VS Code continua com `test_` de exemplo só para desenvolvimento local.
+A CLI detecta se você vai rodar em **simulador/emulador** ou em **dispositivo físico** e injeta a chave certa:
+
+| Onde você roda | Chave usada |
+|---|---|
+| iOS Simulator / Android Emulator | `RC_TEST_KEY` (test_) |
+| iPhone físico | `RC_IOS_PROD_KEY` (appl_) — fallback `RC_TEST_KEY` se ausente |
+| Android físico | `RC_ANDROID_PROD_KEY` (goog_) — fallback `RC_TEST_KEY` se ausente |
+
+Forçar manualmente: `kasy run --rc=test` ou `kasy run --rc=prod`. `--rc=auto` (default) usa a regra acima.
+
+- **Por que o split?** Simulador iOS e emulador Android não conseguem fazer in-app purchase real com chaves `appl_`/`goog_` — só funciona Test Store da RevenueCat. Já em físico, `appl_`/`goog_` cobre Sandbox e Produção (o SDK detecta sozinho).
+- **TestFlight e release:** use as chaves de produção. **NUNCA suba `test_` para a loja** — o SDK do RevenueCat crasha o app no release.
+- **VS Code (F5 sem kasy run):** o `launch.json` carrega `RC_TEST_KEY` como default (ou produção se test_ ausente). Pra alternar manualmente, rode pelo `kasy run`.
 | `SENTRY_DSN` | Sentry | Dashboard Sentry → Projeto → DSN |
 | `MIXPANEL_TOKEN` | Mixpanel | Dashboard Mixpanel → Configurações → Token |
 
@@ -175,6 +185,6 @@ Sem Mac: [docs/codemagic-release.md](docs/codemagic-release.md)
 
 ## Segurança
 
-O `.gitignore` já exclui: `firebase_key.json`, `.env`, `.env.*`, `*.pem`, `*.keystore`, `.kasy/apple.env`, `.kasy/codemagic.env`.
+O `.gitignore` já exclui: `firebase_key.json`, `.env`, `.env.*`, `*.pem`, `*.keystore`, `.kasy/apple.env`, `.kasy/codemagic.env`, `.kasy/*.log`.
 
 Nunca comite credenciais no repositório.

package/templates/firebase/android/app/src/main/kotlin/com/aicrus/firebase/kit/MyWidget.kt

@@ -1,11 +1,11 @@
 package com.aicrus.firebase.kit
 
 import android.content.Context
-import android.content.Intent
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.unit.dp
 import androidx.compose.ui.unit.sp
+import androidx.core.content.ContextCompat
 import androidx.glance.GlanceId
 import androidx.glance.GlanceModifier
 import androidx.glance.Image
@@ -14,7 +14,7 @@ import androidx.glance.LocalSize
 import androidx.glance.action.clickable
 import androidx.glance.appwidget.GlanceAppWidget
 import androidx.glance.appwidget.SizeMode
-import androidx.glance.appwidget.action.actionStartActivity
+import androidx.glance.appwidget.action.actionRunCallback
 import androidx.glance.appwidget.provideContent
 import androidx.glance.background
 import androidx.glance.currentState
@@ -36,7 +36,6 @@ import androidx.glance.text.TextStyle
 import androidx.glance.unit.ColorProvider
 import es.antonborri.home_widget.HomeWidgetGlanceState
 import es.antonborri.home_widget.HomeWidgetGlanceStateDefinition
-import java.util.Calendar
 import java.util.Locale
 
 class MyWidgetWidget : GlanceAppWidget() {
@@ -62,24 +61,50 @@ class MyWidgetWidget : GlanceAppWidget() {
     val planText = prefs.getString("planText", "") ?: ""
     val isPro = prefs.getString("isPro", "false") == "true"
     val quote = prefs.getString("quote", "") ?: ""
+    val quoteAuthor = prefs.getString("quoteAuthor", "") ?: ""
 
-    // Time/locale-based fallback used when Flutter has not pushed data yet —
-    // first install before the app opens. Keeps the widget from rendering
-    // blank in the gallery preview.
+    // Fallback used when Flutter has not pushed data yet — first install
+    // before the app opens. Keeps the widget from rendering blank in the
+    // gallery preview.
     val defaults = defaultStrings()
     val greeting = storedGreeting.ifEmpty { defaults.greeting }
     val title = storedTitle.ifEmpty { defaults.hello }
 
     val size = LocalSize.current
-    val isSmall = size.width < 200.dp
-    // Heuristic: tall enough to fit greeting + title + quote without crowding.
-    val isLarge = size.height >= 280.dp
+    // "Narrow" covers both the true small widget and the tall-but-narrow
+    // single-column shape — both get the tightest sentence count.
+    val isSmall = size.width < 240.dp
+    // We show N COMPLETE sentences from the quote (split on "\n" — which is
+    // how the i18n JSON separates the four sentences). Truncating per
+    // sentence avoids the ugly "…" mid-word that lineLimit alone produces.
+    //   height < 180dp        → no quote.
+    //   narrow column         → 1 sentence (just the first one).
+    //   wide + short          → 2 sentences.
+    //   wide + medium height  → 3 sentences.
+    //   wide + tall           → 4 sentences + bold author.
+    val showQuote = size.height >= 180.dp
+    val numSentences = when {
+      isSmall -> 1
+      size.height < 240.dp -> 2
+      size.height < 300.dp -> 3
+      else -> 4
+    }
+    val showQuoteAuthor = !isSmall && size.height >= 300.dp
+    val sentences = quote.split("\n").filter { it.isNotBlank() }
+    val displayQuote = sentences.take(numSentences).joinToString("\n")
+    // Each sentence is short enough to wrap to 2 lines on narrow widgets,
+    // so a 2x cap covers the worst case without slicing the last sentence.
+    val quoteMaxLines = numSentences * 2
 
+    // Brand colors. The pure-Compose colors (whiteSubtle, whiteQuote,
+    // whiteVerySubtle) are foreground tints used by the live widget only,
+    // so they stay inline. The gold pulls from res/values/colors.xml to keep
+    // a single source of truth shared with the XML drawables.
     val white = Color.White
     val whiteSubtle = Color(red = 1f, green = 1f, blue = 1f, alpha = 0.55f)
     val whiteQuote = Color(red = 1f, green = 1f, blue = 1f, alpha = 0.65f)
-    val gold = Color(red = 1f, green = 0.84f, blue = 0f)
     val whiteVerySubtle = Color(red = 1f, green = 1f, blue = 1f, alpha = 0.45f)
+    val gold = Color(ContextCompat.getColor(context, R.color.widget_pro_gold))
 
     // The gradient lives in its own Image at the bottom of the stack rather
     // than as `.background(ImageProvider(...))`, because in some Glance
@@ -89,7 +114,7 @@ class MyWidgetWidget : GlanceAppWidget() {
     Box(
       modifier = GlanceModifier
         .fillMaxSize()
-        .clickable(actionStartActivity(launchAppIntent(context))),
+        .clickable(actionRunCallback<OpenAppAction>()),
     ) {
       Image(
         provider = ImageProvider(R.drawable.widget_gradient_inner),
@@ -117,18 +142,37 @@ class MyWidgetWidget : GlanceAppWidget() {
           ),
           modifier = GlanceModifier.padding(top = 4.dp),
         )
-        if (isLarge && quote.isNotEmpty()) {
+        if (showQuote && displayQuote.isNotEmpty()) {
           Text(
-            text = quote,
+            text = displayQuote,
             style = TextStyle(
               color = ColorProvider(whiteQuote),
               fontSize = 15.sp,
               fontWeight = FontWeight.Normal,
               fontStyle = FontStyle.Italic,
             ),
-            maxLines = 4,
+            maxLines = quoteMaxLines,
             modifier = GlanceModifier.padding(top = 12.dp),
           )
+          if (showQuoteAuthor && quoteAuthor.isNotEmpty()) {
+            // Author goes on its own line, right-aligned and bold, so the
+            // quote reads as a quote and the attribution is visually distinct.
+            Row(
+              modifier = GlanceModifier
+                .fillMaxWidth()
+                .padding(top = 4.dp),
+              horizontalAlignment = Alignment.End,
+            ) {
+              Text(
+                text = quoteAuthor,
+                style = TextStyle(
+                  color = ColorProvider(whiteQuote),
+                  fontSize = 13.sp,
+                  fontWeight = FontWeight.Bold,
+                ),
+              )
+            }
+          }
         }
         Spacer(modifier = GlanceModifier.defaultWeight())
         Row(
@@ -153,7 +197,7 @@ class MyWidgetWidget : GlanceAppWidget() {
               contentDescription = "Add",
               modifier = GlanceModifier
                 .size(34.dp)
-                .clickable(actionStartActivity(launchAppIntent(context))),
+                .clickable(actionRunCallback<OpenAppAction>()),
             )
           }
         }
@@ -201,37 +245,16 @@ class MyWidgetWidget : GlanceAppWidget() {
     }
   }
 
+  // Fallback used ONLY in the brief window between the widget being placed and
+  // the Flutter app pushing real values. Keep this dead simple — the
+  // time-aware greeting in three languages lives on the Dart side
+  // (home_widget_mywidget_service.dart::_greeting). Duplicating that logic
+  // here was a maintenance trap when adding new locales.
   private data class DefaultStrings(val greeting: String, val hello: String)
 
-  private fun defaultStrings(): DefaultStrings {
-    val hour = Calendar.getInstance().get(Calendar.HOUR_OF_DAY)
-    val lang = Locale.getDefault().language
-    val morning: String; val afternoon: String; val evening: String; val hello: String
-    when (lang) {
-      "pt" -> { morning = "Bom dia"; afternoon = "Boa tarde"; evening = "Boa noite"; hello = "Olá!" }
-      "es" -> { morning = "Buenos días"; afternoon = "Buenas tardes"; evening = "Buenas noches"; hello = "¡Hola!" }
-      else -> { morning = "Good morning"; afternoon = "Good afternoon"; evening = "Good evening"; hello = "Hi there!" }
-    }
-    val greeting = when {
-      hour < 12 -> morning
-      hour < 18 -> afternoon
-      else -> evening
-    }
-    return DefaultStrings(greeting, hello)
-  }
-
-  /// Builds the exact Intent the system launcher fires when the user taps
-  /// the app icon. We must NOT add extra flags here — getLaunchIntentForPackage
-  /// already returns `FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_RESET_IF_NEEDED`,
-  /// which is the same combo the launcher uses. Adding `CLEAR_TOP` destroys
-  /// go_router's navigation stack on warm starts and lands the user on the
-  /// errorBuilder ("404 - Page not found").
-  private fun launchAppIntent(context: Context): Intent {
-    return context.packageManager.getLaunchIntentForPackage(context.packageName)
-      ?: Intent(context, MainActivity::class.java).apply {
-        action = Intent.ACTION_MAIN
-        addCategory(Intent.CATEGORY_LAUNCHER)
-        flags = Intent.FLAG_ACTIVITY_NEW_TASK
-      }
+  private fun defaultStrings(): DefaultStrings = when (Locale.getDefault().language) {
+    "pt" -> DefaultStrings(greeting = "Olá", hello = "Bem-vindo!")
+    "es" -> DefaultStrings(greeting = "Hola", hello = "¡Bienvenido!")
+    else -> DefaultStrings(greeting = "Hello", hello = "Welcome!")
   }
 }

package/templates/firebase/android/app/src/main/kotlin/com/aicrus/firebase/kit/MyWidgetReceiver.kt

@@ -1,7 +1,44 @@
 package com.aicrus.firebase.kit
 
+import android.appwidget.AppWidgetManager
+import android.content.Context
+import androidx.glance.appwidget.GlanceAppWidgetManager
 import es.antonborri.home_widget.HomeWidgetGlanceWidgetReceiver
+import kotlinx.coroutines.runBlocking
 
 class MyWidgetReceiver : HomeWidgetGlanceWidgetReceiver<MyWidgetWidget>() {
     override val glanceAppWidget = MyWidgetWidget()
+
+    // Override the parent's onUpdate because its updateAppWidgetState
+    // transformation returns the SAME state instance back. Glance compares
+    // references, treats the state as unchanged, and skips the recomposition.
+    // The symptom on the Flutter side: first language switch does not update,
+    // user has to tap twice. We force a fresh recompose by calling update()
+    // directly on each widget id — the composable then reads the latest
+    // SharedPreferences values that Dart already committed synchronously.
+    override fun onUpdate(
+        context: Context,
+        appWidgetManager: AppWidgetManager,
+        appWidgetIds: IntArray,
+    ) {
+        runBlocking {
+            val manager = GlanceAppWidgetManager(context)
+            appWidgetIds.forEach { widgetId ->
+                val glanceId = manager.getGlanceIdBy(widgetId)
+                glanceAppWidget.update(context, glanceId)
+            }
+            // Defensive 2nd update: Glance occasionally coalesces or skips the
+            // first invalidation when the user triggers two updates in quick
+            // succession (e.g. tapping the language tile and immediately
+            // returning to the home screen). A short gap + second update
+            // guarantees the freshly committed SharedPreferences values
+            // actually reach the composition. The symptom without this:
+            // first language tap appears to do nothing, second tap "fixes" it.
+            kotlinx.coroutines.delay(200)
+            appWidgetIds.forEach { widgetId ->
+                val glanceId = manager.getGlanceIdBy(widgetId)
+                glanceAppWidget.update(context, glanceId)
+            }
+        }
+    }
 }

package/templates/firebase/android/app/src/main/kotlin/com/aicrus/firebase/kit/OpenAppAction.kt

@@ -0,0 +1,26 @@
+package com.aicrus.firebase.kit
+
+import android.content.Context
+import android.content.Intent
+import androidx.glance.GlanceId
+import androidx.glance.action.ActionParameters
+import androidx.glance.appwidget.action.ActionCallback
+
+// Custom ActionCallback used by MyWidgetWidget instead of actionStartActivity.
+// actionStartActivity wraps the launch in an internal "glance-action://CALLBACK"
+// intent that ends up reaching MainActivity (because launchMode=singleTop) as
+// the new intent — Flutter sees that URI as a deep link and go_router blows up
+// with "no routes for location: glance-action:/CALLBACK". Running the launch
+// ourselves through onAction bypasses that wrapping entirely.
+class OpenAppAction : ActionCallback {
+    override suspend fun onAction(
+        context: Context,
+        glanceId: GlanceId,
+        parameters: ActionParameters,
+    ) {
+        val intent = Intent(context, MainActivity::class.java).apply {
+            flags = Intent.FLAG_ACTIVITY_SINGLE_TOP or Intent.FLAG_ACTIVITY_NEW_TASK
+        }
+        context.startActivity(intent)
+    }
+}

package/templates/firebase/android/app/src/main/res/drawable/widget_add_button.xml

@@ -6,10 +6,10 @@
     android:viewportHeight="34">
     <path
         android:pathData="M17,0 A17,17 0 1,0 17,34 A17,17 0 1,0 17,0 Z"
-        android:fillColor="#2EFFFFFF"/>
+        android:fillColor="@color/widget_add_button_bg"/>
     <path
         android:pathData="M17,9 L17,25 M9,17 L25,17"
-        android:strokeColor="#FFFFFFFF"
+        android:strokeColor="@color/widget_add_button_stroke"
         android:strokeWidth="2.5"
         android:strokeLineCap="round"/>
 </vector>

package/templates/firebase/android/app/src/main/res/drawable/widget_gradient_bg.xml

@@ -1,9 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
+<!-- Background used by the static preview / loading layouts (RemoteViews
+     XML rendered by the launcher BEFORE Glance composes the real widget).
+     Includes the corner radius because the launcher doesn't clip these
+     layouts the same way it clips the live Glance widget.
+     To restyle the brand gradient, edit res/values/colors.xml. -->
 <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
     <gradient
         android:angle="315"
-        android:startColor="#FF140829"
-        android:endColor="#FF33176B"
+        android:startColor="@color/widget_gradient_start"
+        android:endColor="@color/widget_gradient_end"
         android:type="linear" />
     <corners android:radius="24dp" />
 </shape>

package/templates/firebase/android/app/src/main/res/drawable/widget_gradient_inner.xml

@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- Same gradient as widget_gradient_bg, but without rounded corners.
-     Used as the background of the Glance widget itself — the system
-     already clips the widget with the OS-provided corner radius, so
-     adding corners here would cause a visible double-radius edge. -->
+<!-- Background of the live Glance widget. No corners here — the OS already
+     clips the widget with its corner radius, so adding rounded corners
+     would produce a visible double-radius edge. To restyle the brand
+     gradient, edit res/values/colors.xml. -->
 <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
     <gradient
         android:angle="315"
-        android:startColor="#FF140829"
-        android:endColor="#FF33176B"
+        android:startColor="@color/widget_gradient_start"
+        android:endColor="@color/widget_gradient_end"
         android:type="linear" />
 </shape>

package/templates/firebase/android/app/src/main/res/drawable/widget_plan_pill_bg.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
     <corners android:radius="999dp"/>
-    <solid android:color="#14FFFFFF"/>
+    <solid android:color="@color/widget_free_pill_bg"/>
 </shape>

package/templates/firebase/android/app/src/main/res/drawable/widget_preview_image.xml

@@ -8,8 +8,8 @@
         <shape android:shape="rectangle">
             <gradient
                 android:angle="315"
-                android:startColor="#FF140829"
-                android:endColor="#FF33176B"
+                android:startColor="@color/widget_gradient_start"
+                android:endColor="@color/widget_gradient_end"
                 android:type="linear" />
             <corners android:radius="24dp" />
         </shape>

package/templates/firebase/android/app/src/main/res/drawable/widget_pro_pill_bg.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
     <corners android:radius="999dp"/>
-    <solid android:color="#2EFFD700"/>
+    <solid android:color="@color/widget_pro_pill_bg"/>
 </shape>