kasy-cli 1.34.0 → 1.35.0

package/templates/firebase/.firebase/hosting.YnVpbGQvd2Vi.cache

@@ -0,0 +1,73 @@
+stripe_success.html,1781195415353,677b2fb430839866f32a33a751aae85b4c4819123be820f3f5b2f689b8eed00e
+manifest.json,1779810782774,1b929ac7267ff738d05646106a0fac3591082b6f365051928a62518af30b3fd5
+local_notifications.js,1772398909034,0b44b177c4b8a705ad1b0e3d7532537aad7b230e9472f93c820742b7548797b8
+flutter.js,1777393608000,b42e549a02f5c1428b0ad85dbdc663d400a6d2db10cb8aefcc0fddd592fd6ceb
+firebase-messaging-sw.js,1772484605561,dba3c939f7c240e62f63d06408d5f70e45f1168d00df98726e6a7a20cbd3b0df
+favicon.png,1779810782545,c967afd3c3d4dd165ef2e5cf3f203c3982dfff6a95881859ed163d9c38d75512
+splash/img/light-4x.png,1780546027751,abf0e55345e532a4645fe14b01c2948b07c78df50cc6da23648837dfb6271c74
+splash/img/light-3x.png,1780546027699,5f02c94032cb7053807ce89603b109f14ea2740eaa3145dc76c924cbe1d534a9
+splash/img/light-2x.png,1780546027647,3c073b9da154ac8be530f8beefa3579246f223acd819e856a2db000fdabcb67e
+splash/img/light-1x.png,1780546027614,928ead755ab10de4d559c3c6751839dd6adf1412271ef8a508707b0938b4baf5
+splash/img/dark-4x.png,1780546027952,d5353a84fd44ec4a28127ceb9d6d04305f99252d92bacfeeebeade4f2ab59bc0
+splash/img/dark-3x.png,1780546027901,c37e7f4f1e37b59291a681179c97211a9d62d60a2ee802dd192879855edf6dec
+splash/img/dark-2x.png,1780546027846,6ca64e1d4aa1afd8916b3b33eaa4d3e4cbe50c79902d3b813e839d1eb0d8897e
+splash/img/dark-1x.png,1780546027812,8a280f0b5c87f512ebaf60bea59396d136fdcfc1710c9ea311cd10b5f6370191
+icons/Icon-maskable-512.png,1779810782770,5b32f8a7281ac65928b1076db0bc02aee0d4afc2dbb6372eecbdf37a89be33cc
+icons/Icon-maskable-192.png,1779810782685,eb719472f72ffb7c1a294a8f3edb6ec952ad6df0be612e3e8148f9052617d58d
+icons/Icon-512.png,1779810782665,5b32f8a7281ac65928b1076db0bc02aee0d4afc2dbb6372eecbdf37a89be33cc
+icons/Icon-192.png,1779810782567,eb719472f72ffb7c1a294a8f3edb6ec952ad6df0be612e3e8148f9052617d58d
+canvaskit/wimp.wasm,1777394172000,f73f248dfff66551884ce69d2a3088df2410fba13e3fafa2ef8ef98829241f14
+canvaskit/wimp.js.symbols,1777394172000,d503a0521fcb00d9dec064dabaccb9ead8b10d311f9f36141fb5b7997b201846
+canvaskit/wimp.js,1777394172000,63f0487b1033146fc2ed7b394420b036c99cf198b857dfd3cea92227f84a2310
+canvaskit/skwasm_heavy.wasm,1777394228000,c02f715939724f1c936cef6b5d787489451b1a1a24dadf86f667d71f0e21cc09
+canvaskit/skwasm_heavy.js.symbols,1777394228000,625fb4cc0f491b80d66e20251521bc90dd7ad83ad06b242e9762916aaaccada6
+canvaskit/skwasm_heavy.js,1777394228000,1a694c23c937503283d38d24f75d03e432093e0cc9488c38910b482751263fad
+canvaskit/skwasm.wasm,1777394126000,0e0c782588b556af14cad090d959344b705131d299fa76ebfddf97180853b1ab
+canvaskit/skwasm.js.symbols,1777394126000,320b80390e4e3234f1c216c90a01028f17fd39220817c7837d8126133366f313
+canvaskit/skwasm.js,1777394126000,40f0e36b14ede08584d4f4cbfbcaf55642e04f81498364e975b55cec7b95ba20
+canvaskit/canvaskit.wasm,1777393746000,4b911a495801f229a19e536df7e52a9943a549bf4c213583f081ea2a3d3c12b2
+canvaskit/canvaskit.js.symbols,1777393746000,52d20fad5abef4f488c2b92aec7181e65997b8a22de54cc976b4bd4555401723
+canvaskit/canvaskit.js,1777393746000,df5aa63d90b0491908ad19d64fd18f29db1dc416548f6c73179d962eaae694e7
+canvaskit/chromium/canvaskit.wasm,1777393830000,44d29356b9e2c903751a8aa583716275e165d1fb56eea46963c95c7c43f7ca34
+canvaskit/chromium/canvaskit.js.symbols,1777393830000,60722421e56edacbeb674cc3ef0f6152969067e74b51a960c80cd36e75b75a54
+canvaskit/chromium/canvaskit.js,1777393830000,10ea3badcf26e29aba851699c03e09bc35fea65cdc440a035bac263d6d02d665
+assets/packages/mixpanel_flutter/assets/mixpanel.js,1779806094332,1915455df317dd1a9f42c6f3ea5bbe3ee357614f89d994f157a2e821f37956c3
+assets/packages/lucide_icons_flutter/assets/lucide.ttf,1779806149220,bfca5b519d438d7194550cbc60a4e7c10f53a36ac96d48c7e17503a45b6b7b0b
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w600.ttf,1779806149210,cf2218879264e413687602c192e43b86000404ff85e2bca933d9a67020299ed4
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w500.ttf,1779806149217,587ce31612aa88e6c019210a18625531557eda111f5f8e838a298277efc9e308
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w400.ttf,1779806149212,644f7ccdf1b74bdb898210c4171327a25d7476690c7ade2d3082dd473bc24fe1
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w300.ttf,1779806149214,5dd834d2d84e5a1524e027fa21d87c6e8aaaf6421f201be2ec61e57c0b7bce72
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w200.ttf,1779806149208,d929819511975bf5030c0f359e8c16d21ad14b20ac24d5f2ff238462114b1d9b
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w100.ttf,1779806149216,1e9e6ea39a38b874c40242d02533adac9dd3d09c8119dae55458e65c6c3c16e6
+assets/packages/cupertino_icons/assets/CupertinoIcons.ttf,1779806141382,010d647b6cab4e1a9b4398957353f43589903ce8dc760d05d894944b664e29bd
+assets/fonts/MaterialIcons-Regular.otf,1662569016000,3a631b0761788d7cf2a71e8732a5b31288d6e7aa996c671c70d53a251bbd3848
+assets/assets/images/splash_logo_light_android12.png,1779867497377,da2caee4f16230230dbb04d84913f0a9df2eae6bcb8f9d1ce83ed556cee6d094
+assets/assets/images/splash_logo_light.png,1779867497286,643a1f45d6ef9458c4c0eed9f4889cc2adbdf1db616913215be66673a05a0066
+assets/assets/images/splash_logo_dark_android12.png,1779867497464,b237d9f9035d419525a10b32889c30d44c706d62990b30bdc6bef911fe9352d6
+assets/assets/images/splash_logo_dark.png,1779867497287,18090e40687efaa4bc7c70128bebf88e6a9952562f1fcfb255331305ff7cffa7
+assets/assets/images/premium-switch-header.png,1781104464333,890c0bcac58363b6db88829af7c7e6134174c9fdbe61f39b6c72e28042e54483
+assets/assets/images/premium-bg.jpg,1781104464331,4c48000d91087f9828e628e6336cb9791cb2c57bdcafdf78e5edbf9d568ab262
+assets/assets/images/logo_wordmark_light.png,1780606594616,f4d559a7ae85706dfc0cafeabf1c03380fa0ce5339a471c8f50fcfd4f59e6dd2
+assets/assets/images/logo_wordmark_dark.png,1780606594628,9b7ec728eb6b0f7798339065b2e311bf37cb57140ea068da8496e066773276cd
+assets/assets/images/icon_foreground_empty.png,1779810762471,cdf875b39e231f303c6eff2baba9972404f1ea12757836b75f41611b58a122ec
+assets/assets/images/icon_android.png,1779810762467,db0f6c9ff904d4571ab40d46110096370c41e3fa16496baa0fda71861ee47800
+assets/assets/images/icon.png,1779745964920,194820ecc4eed7bac14b5605916d87093b4571a28f3ca24863ac09c783343488
+assets/assets/images/favicon.png,1779745964922,194820ecc4eed7bac14b5605916d87093b4571a28f3ca24863ac09c783343488
+assets/assets/images/empty_notifications.jpg,1772398653078,cbb7d57f7cf305cf33ee8cbd15544eb1020670a1a8100f1328b49ca61d76fb7e
+assets/assets/icons/google_play_games.png,1772398653083,533c1d87d7be8690ab173ef42aa92ee8bac3b6e6859c0f97fe30daff2c843501
+assets/assets/icons/google.png,1772398653083,f423e7e7be1e06008d45617d07f095f04da7fdcab9a56523f9e0633828e464e0
+assets/assets/icons/facebook.png,1772398653083,79ac67e449c1db63319d43329ca91f682b4e0bc6a0883b0dfb2a849e13ae6eb6
+assets/assets/icons/apple.png,1772398653083,2a737d8801ca81452b2978bb2e1ac72136acf1a4c338f2de2f77b65e9f6de1fa
+version.json,1781382132245,b028f2bf7b54dc78541295a1ddf03306ac20a052662bde5b6b1aefe80d613249
+index.html,1781382083192,bb8142eb84e9e44049957c3edf86006e1ae5f194c397a8326ce505b68fdf58f4
+flutter_service_worker.js,1781382132717,baeeaf9f4b8e6f40d3b0549429ceb70ca01f120db6a7ef2f60d5809233dc2205
+assets/FontManifest.json,1781382132345,4d84ab517c27984d36f9a3c8be6f2a72788c0c3985c1d5874297fef0a53407ca
+assets/AssetManifest.bin.json,1781382132345,50a11b51c3fc4cbed1b5ec3a4f466c6a6b75c481d08d4782c8191f99bdbdba9c
+assets/AssetManifest.bin,1781382132345,78bccb08a36307a400711a1d7e6868bd5f89a24e63439fb5b6747660323e4475
+assets/shaders/stretch_effect.frag,1781382132431,1a7d4ac2be40cf0a459dfb390ef08bcd740f37913ffdee8de3c2ea836a18410e
+assets/shaders/ink_sparkle.frag,1781382132431,1c8e222328206d1e06754f76fb53947aad38d62180aafad5298a3c6f510b173d
+flutter_bootstrap.js,1781382083178,9a838d82fafadf6910ccbc6cdf4df03972abfe7749620e382c8ced856120bd8d
+main.dart.js_3.part.js,1781382118356,80b75e3c9ff59756ea8a58318c7886e7a74787b7ed07fad6f7f4b4347d5bdbab
+main.dart.js_1.part.js,1781382118351,a6dfa901d3a791b48e70499f583405215d20a4fe2491acd8d670fe0eac71cdaf
+assets/NOTICES,1781382132345,a18efc42c5ed99b56481537d0f229ddd3add671c548a893aaf8766f30c854158
+main.dart.js,1781382118819,5e7b0cab78a6e7cd653637824e33318f75554c9b5cce4b1ab26299da255247e1

package/templates/firebase/AGENTS.md

@@ -31,6 +31,43 @@ everything below is backend-agnostic.
 6. **Zero analyzer issues.** Run `flutter analyze` and fix everything before
    considering a change done.
 
+## Design system, components & responsiveness
+
+This kit is an **organized, opinionated** design system — not a blank canvas.
+Before building anything, browse the live **Design System** screen
+(`lib/features/home/design_system_page.dart`) and the **Components** gallery:
+colours, typography, spacing and dozens of ready widgets (`KasyButton`,
+`KasyCard`, `KasyTextField`, `KasyScreen`, `showKasyToast`,
+`showKasyConfirmDialog`, …). Reuse one before writing a new widget. Full token
+reference: **`DESIGN_SYSTEM.md`**.
+
+**Responsiveness is deliberate, not improvised.** There are exactly three
+breakpoints and the type sizes are pinned per breakpoint, so the UI never
+oscillates or guesses:
+
+| Breakpoint | Width      | Notes                                            |
+| ---------- | ---------- | ------------------------------------------------ |
+| Mobile     | `< 768`    | native iOS/Android + phone-width web             |
+| Tablet     | `768–1024` |                                                  |
+| Desktop    | `>= 1024`  | authored baseline                                |
+
+- **Typography** (`KasyTypeScale`): each role has an **explicit size per
+  breakpoint** — headings are largest on desktop and step down on smaller
+  screens; body/labels stay constant. It is applied globally by
+  `ResponsiveTextTheme` — **screens just use `context.textTheme.*` /
+  `context.kasyTextTheme.*` and the right size comes out**. Don't hardcode
+  `fontSize`; don't invent your own breakpoints.
+- **Native mobile** is straightforward: it's the Mobile breakpoint and never
+  scales the viewport.
+- **Web render scale** (`WebViewportScale`) is a *separate* concern: Flutter web
+  renders ~10% large, so **desktop only** scales the whole UI to `0.95`. Tablet
+  and mobile web render at natural size, like native. This is NOT the typography
+  scale — don't conflate the two.
+
+To re-tune sizes, edit `KasyTypeScale` in `lib/core/theme/type_scale.dart` —
+nothing else. The live ramp (tabs per breakpoint) is under **Design System →
+Typography**.
+
 ## Architecture (feature-first, three layers)
 
 ```
@@ -78,6 +115,11 @@ Some features only work on a real iOS / Android build and are gated with
   throws at runtime.
 - **Push / FCM token, notification permission** — native APIs; on web the admin
   actions surface the "native app only" toast.
+- **App update prompts** — two distinct flows, both native-only and driven by
+  Firebase Remote Config (works on every backend): **"update available"** (shown
+  *before*, when the installed version is below `app_latest_version` / blocking
+  below `app_min_version`, sends the user to the store) and **"what's new"**
+  (shown *after* updating). See `lib/core/app_update/` and the README.
 
 ## Optional design guard-rail
 
@@ -85,3 +127,44 @@ Some features only work on a real iOS / Android build and are gated with
 (hardcoded fonts / colours / Material widgets). It is **opt-in and
 non-blocking** — relax it, wire it into CI, or delete it freely. Per-line
 escape hatch: `// design-check: ignore`.
+
+## Updating the kit (merging new versions with your changes)
+
+The project is a scaffold: the kit code was copied into it. Improvements ship via
+the CLI, which **overwrites** files (it does not auto-merge). The safety net is git.
+
+Recommended flow when the user wants newer kit code:
+
+1. **Commit first** so the working tree is clean (the CLI also warns about this).
+2. Run the relevant command:
+   - `kasy update` — shows what's new for the features in use
+   - `kasy update core` / `kasy update components` — refreshes core files / UI components
+   - `kasy update <feature>` — e.g. `revenuecat`, `ai_chat`, `auth` (re-applies that feature)
+3. The command overwrites the files and prints which ones changed.
+4. **Merge:** if the user had customized any overwritten file, reconcile their version
+   (in the previous git commit) with the new kit version. As the in-project agent,
+   this is your job: read `git diff` (or `git show HEAD:<file>` for the user's prior
+   version) and produce a result that keeps BOTH the user's customizations and the new
+   kit improvements. Prefer additive merges; never silently drop the user's logic.
+   When unsure which side wins for a hunk, ask the user.
+
+This is why committing before `kasy update` matters: it makes the user's prior version
+recoverable so the merge is a normal 3-way reconcile, not a guess.
+
+## Debugging when something doesn't work
+
+Diagnose with real signals, not guesses:
+
+- **App logs first.** Key steps (auth, service init) are logged via `Logger` — read
+  the `kasy run` terminal / browser console.
+- **Then the backend logs.** Supabase: Dashboard → Logs (Auth / Edge Functions /
+  Postgres). Firebase: Console → Functions logs / Authentication.
+- **Auth / token errors:** decode the JWT (base64url-decode the middle segment) and
+  inspect `sub` / `aud` / `iss`. A `missing sub claim` usually means the wrong
+  session/token was sent (e.g. the publishable `anon` key), not a bad provider token.
+- **`kasy doctor`** checks common setup gaps (Google SHA-1, authorized domains,
+  provider config).
+- **Web vs native differ:** web runs in `authRequired` mode (no anonymous user);
+  native is anonymous-first. Account-linking only applies when a real session exists.
+
+Add a temporary `print(...)` to inspect a runtime value, then remove it.

package/templates/firebase/DESIGN_SYSTEM.md

@@ -65,8 +65,11 @@ doubt, add or reuse a role rather than hardcoding.
 | `cardSubtitle` | `bodyXs` (12/w400)             | Card secondary text                       |
 | `caption`      | `bodyXs` (12/w400)             | Captions, helper text                     |
 
-Access roles in widgets via `context.textTheme.*` (Material slots, colour
-applied) or `KasyTextTheme.*` (raw role, apply colour with `.copyWith`).
+Access the semantic roles via `context.kasyTextTheme.*` (colourless — apply
+colour with `.copyWith`). Access Material slots via `context.textTheme.*`
+(colour already applied). The raw scale roles are also exposed as
+`KasyTextTheme.*` statics, but those are **fixed** (the desktop baseline, for
+specs/docs) — use the `context.*` accessors in live UI so text scales.
 
 Material → role mapping: `headlineMedium = heading2`, `headlineSmall =
 titleLarge = heading3`, `titleMedium = heading4`.
@@ -74,6 +77,38 @@ titleLarge = heading3`, `titleMedium = heading4`.
 The chrome/app-bar title is **w700** (not w900). Black weights read as heavy and
 fight the rest of the UI.
 
+### Responsive type — `KasyTypeScale` (`lib/core/theme/type_scale.dart`)
+
+Not a blind multiplier: **every role declares an explicit size per breakpoint**
+(the way Figma variables / modes do). The professional pattern — **headings are
+largest on desktop and step down on smaller viewports** (a 36px title would feel
+huge and wrap badly on a phone), while **body and labels stay constant** for
+stable reading everywhere. Desktop is the authored reference.
+
+| Role (example) | Mobile `< 768` | Tablet `768–1024` | Desktop `>= 1024` |
+| -------------- | -------------- | ----------------- | ----------------- |
+| `heading1`     | 28             | 32                | 36                |
+| `heading2`     | 22             | 23                | 24                |
+| `heading3`     | 18             | 19                | 20                |
+| `bodyBase`     | 16             | 16                | 16                |
+| `bodySm`       | 14             | 14                | 14                |
+
+`ResponsiveTextTheme` (innermost wrapper in `main.dart`) reads the viewport
+width, picks the breakpoint and republishes a `Theme` whose Material `textTheme`
+and `KasyTextTheme` extension use that breakpoint's sizes. Every
+`context.textTheme.*` and `context.kasyTextTheme.*` inherits it — **no screen
+does anything**; desktop is a pass-through (the authored baseline). Component
+themes (buttons, inputs) keep their calibrated sizes on purpose. To re-tune the
+whole app, edit the numbers in `KasyTypeScale` — nothing else. The live ramp is
+visible under **Design System → Typography** (tabs per breakpoint).
+
+**Web render scale (`WebViewportScale`, `lib/core/web_viewport_scale.dart`).** A
+separate concern from type sizes: Flutter web renders ~10% larger than an
+equivalent HTML app, so on **desktop only** (`>= 1024`) the whole UI is scaled to
+`0.95` — a true viewport scale, so layout, scrolling and hit-testing stay
+correct. Tablet and mobile web render at natural size, exactly like the native
+build, which never scales.
+
 ---
 
 ## Icon sizes — `KasyIconSize` (`lib/core/theme/icon_sizes.dart`)

package/templates/firebase/docs/auth-setup.en.md

@@ -83,6 +83,8 @@ Requires an [Apple Developer](https://developer.apple.com) account (paid).
 
 Requires a [Meta for Developers](https://developers.facebook.com) account.
 
+> **Shortcut:** the `kasy facebook` command automates writing the credentials (Info.plist, strings.xml, and the Firebase/Supabase provider) and opens the Meta dashboard. The steps below are what you do on Meta (manual, no API).
+
 ### Step 1 — Create an app on Meta
 
 1. Open [Meta for Developers → My Apps](https://developers.facebook.com/apps)

package/templates/firebase/docs/auth-setup.es.md

@@ -83,6 +83,8 @@ Requiere cuenta de [Apple Developer](https://developer.apple.com) (de pago).
 
 Requiere cuenta en [Meta for Developers](https://developers.facebook.com).
 
+> **Atajo:** el comando `kasy facebook` automatiza escribir las credenciales (Info.plist, strings.xml y el proveedor en Firebase/Supabase) y abre el panel de Meta. Los pasos de abajo son lo que haces en Meta (manual, sin API).
+
 ### Paso 1 — Crear una app en Meta
 
 1. Abre [Meta for Developers → My Apps](https://developers.facebook.com/apps)

package/templates/firebase/docs/auth-setup.pt.md

@@ -83,6 +83,8 @@ Requer conta [Apple Developer](https://developer.apple.com) (paga).
 
 Requer conta no [Meta for Developers](https://developers.facebook.com).
 
+> **Atalho:** o comando `kasy facebook` automatiza a parte de gravar as credenciais (Info.plist, strings.xml e o provedor no Firebase/Supabase) e abre o painel da Meta. Os passos abaixo são o que você faz na Meta (manual, sem API).
+
 ### Passo 1 — Criar app no Meta
 
 1. Abra [Meta for Developers → My Apps](https://developers.facebook.com/apps)

package/templates/firebase/firebase.json

@@ -1 +1,56 @@
-{"firestore":{"rules":"firestore.rules","indexes":"firestore.indexes.json"},"storage":{"rules":"storage.rules"},"functions":[{"source":"functions","codebase":"default","ignore":["node_modules",".git","firebase-debug.log","firebase-debug.*.log"],"predeploy":["npm --prefix \"$RESOURCE_DIR\" run build"]}],"flutter":{"platforms":{"android":{"default":{"projectId":"fir-kit-8e56b","appId":"1:613770689965:android:f800aacb0091708b0f7524","fileOutput":"android/app/google-services.json"}},"ios":{"default":{"projectId":"fir-kit-8e56b","appId":"1:613770689965:ios:7cc1f4579cf759fd0f7524","uploadDebugSymbols":false,"fileOutput":"ios/Runner/GoogleService-Info.plist"}},"dart":{"lib/firebase_options.dart":{"projectId":"fir-kit-8e56b","configurations":{"android":"1:613770689965:android:f800aacb0091708b0f7524","ios":"1:613770689965:ios:7cc1f4579cf759fd0f7524","web":"1:613770689965:web:e9347bac3b3eae5d0f7524"}}}}}}
+{
+  "hosting": {
+    "public": "build/web",
+    "ignore": ["firebase.json", "**/.*", "**/node_modules/**"],
+    "rewrites": [
+      { "source": "**", "destination": "/index.html" }
+    ],
+    "headers": [
+      {
+        "source": "**/@(index.html|flutter_bootstrap.js|flutter_service_worker.js|main.dart.js|main.dart.wasm|main.dart.mjs|manifest.json|version.json)",
+        "headers": [
+          { "key": "Cache-Control", "value": "no-cache, no-store, must-revalidate" }
+        ]
+      }
+    ]
+  },
+  "firestore": { "rules": "firestore.rules", "indexes": "firestore.indexes.json" },
+  "storage": { "rules": "storage.rules" },
+  "functions": [
+    {
+      "source": "functions",
+      "codebase": "default",
+      "ignore": ["node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log"],
+      "predeploy": ["npm --prefix \"$RESOURCE_DIR\" run build"]
+    }
+  ],
+  "flutter": {
+    "platforms": {
+      "android": {
+        "default": {
+          "projectId": "fir-kit-8e56b",
+          "appId": "1:613770689965:android:f800aacb0091708b0f7524",
+          "fileOutput": "android/app/google-services.json"
+        }
+      },
+      "ios": {
+        "default": {
+          "projectId": "fir-kit-8e56b",
+          "appId": "1:613770689965:ios:7cc1f4579cf759fd0f7524",
+          "uploadDebugSymbols": false,
+          "fileOutput": "ios/Runner/GoogleService-Info.plist"
+        }
+      },
+      "dart": {
+        "lib/firebase_options.dart": {
+          "projectId": "fir-kit-8e56b",
+          "configurations": {
+            "android": "1:613770689965:android:f800aacb0091708b0f7524",
+            "ios": "1:613770689965:ios:7cc1f4579cf759fd0f7524",
+            "web": "1:613770689965:web:e9347bac3b3eae5d0f7524"
+          }
+        }
+      }
+    }
+  }
+}

package/templates/firebase/functions/src/authentication/triggers.ts

@@ -5,7 +5,7 @@ import {notificationsApi} from "../notifications/notifications_api";
 import {NotificationPayload, SystemNotificationParams} from "../notifications/models/notification";
 import {NotificationTypes} from "../core/data/entities/notification_entity";
 import {Timestamp} from "firebase-admin/firestore";
-import {usersRepository, userDevicesRepository} from "../core/data/repositories/repositories";
+import {usersRepository} from "../core/data/repositories/repositories";
 import * as functions from "firebase-functions/v1";
 import {onDocumentCreated} from "firebase-functions/v2/firestore";
 import {UserDeviceEntityData} from "../core/data/entities/user_device_entity";
@@ -52,9 +52,13 @@ export const onUserRegistration = functions
   });
 
 /**
- * Triggered when the user registers their first device.
- * Sends a localized welcome notification (saved to DB only, no push).
- * Fires on device creation so the device locale is available.
+ * Triggered when a device is registered.
+ * Sends a localized welcome notification ONCE per account (saved to DB only, no
+ * push). Fires on device creation so the device locale is available.
+ *
+ * The "once per account" guard is [UserRepository.claimWelcome], not a device
+ * count: a device re-registered after a logout/login cycle looks like a fresh
+ * first device, so counting devices re-sent the welcome on every re-login.
  */
 export const onFirstDeviceRegistered = onDocumentCreated(
   "users/{userId}/devices/{deviceId}",
@@ -62,8 +66,8 @@ export const onFirstDeviceRegistered = onDocumentCreated(
     const logger = new Logger("onFirstDeviceRegistered");
     const userId = event.params.userId;
     try {
-      const allDevices = await userDevicesRepository.getDevices([userId]);
-      if (allDevices.length > 1) return;
+      const shouldWelcome = await usersRepository.claimWelcome(userId);
+      if (!shouldWelcome) return;
 
       const deviceData = event.data?.data() as UserDeviceEntityData | undefined;
       // Flutter serializes as "extraData" (camelCase); Firestore schema uses "extra_data".

package/templates/firebase/functions/src/core/data/entities/subscription_entity.ts

@@ -13,6 +13,7 @@ export interface SubscriptionEntityData {
     creation_date: Timestamp;
     last_activity: Timestamp;
     expiration_date?: Timestamp;
+    trial_end?: Timestamp;
     status: SubscriptionStatus;
     store: Stores,
     product_id: string;
@@ -30,6 +31,7 @@ export class SubscriptionEntity {
     creation_date,
     last_activity,
     expiration_date,
+    trial_end,
     status,
     store,
     product_id,
@@ -41,6 +43,7 @@ export class SubscriptionEntity {
     this.creation_date = creation_date;
     this.last_activity = last_activity;
     this.expiration_date = expiration_date;
+    this.trial_end = trial_end;
     this.status = status;
     this.store = store;
     this.product_id = product_id;
@@ -66,6 +69,7 @@ export class SubscriptionEntity {
       creation_date: subscription.creationDate,
       last_activity: subscription.lastUpdate,
       expiration_date: subscription.expirationDate,
+      trial_end: subscription.trialEnd,
       status: subscription.status,
       store: subscription.store,
       product_id: subscription.productId,
@@ -78,6 +82,7 @@ export class SubscriptionEntity {
       creationDate: this.creation_date,
       lastUpdate: this.last_activity,
       expirationDate: this.expiration_date,
+      trialEnd: this.trial_end,
       status: this.status,
       store: this.store,
       productId: this.product_id,

package/templates/firebase/functions/src/core/data/entities/user_entity.ts

@@ -7,6 +7,12 @@ export interface UserEntityData {
     creation_date: Timestamp;
     last_update_date: Timestamp;
     locale?: string;
+    /**
+     * Set to true once the one-time welcome notification has been sent for this
+     * account. Guards against re-sending it when a device is re-registered after
+     * a logout/login cycle (which otherwise looks like a brand-new first device).
+     */
+    welcome_sent?: boolean;
 }
 
 export type NewUserEntityData = Omit<UserEntityData, "id">;
@@ -20,7 +26,8 @@ export class UserEntity {
     email,
     creation_date,
     last_update_date,
-    locale
+    locale,
+    welcome_sent
   }: UserEntityData
   ) {
     this.id = id;
@@ -29,6 +36,7 @@ export class UserEntity {
     this.creation_date = creation_date;
     this.last_update_date = last_update_date;
     this.locale = locale;
+    this.welcome_sent = welcome_sent;
   }
 
   static fromData(data: UserEntityData): UserEntity {

package/templates/firebase/functions/src/core/data/repositories/user_repository.ts

@@ -46,6 +46,33 @@ export class UserRepository {
     });
   }
 
+  /**
+   * Atomically claims the one-time welcome for a user.
+   *
+   * Returns true for exactly ONE caller per account — the one that should send
+   * the welcome notification — and false for every later call (e.g. a device
+   * re-registered after a logout/login cycle, or a second device registering at
+   * the same time). The flag flip and the read happen inside a transaction, so
+   * two concurrent device registrations can never both send the welcome.
+   */
+  async claimWelcome(userId: string): Promise<boolean> {
+    const ref = this.db.collection("users").doc(userId);
+    return this.db.runTransaction(async (tx) => {
+      const snapshot = await tx.get(ref);
+      if (!snapshot.exists) {
+        return false;
+      }
+      if (snapshot.get("welcome_sent") === true) {
+        return false;
+      }
+      tx.update(ref, {
+        "welcome_sent": true,
+        "last_update_date": Timestamp.now(),
+      });
+      return true;
+    });
+  }
+
   async list({
     limit = 100,
     startAfter,

package/templates/firebase/functions/src/subscriptions/models/subscriptions.ts

@@ -22,6 +22,7 @@ export interface SubscriptionData {
   creationDate: Timestamp;
   lastUpdate: Timestamp;
   expirationDate?: Timestamp;
+  trialEnd?: Timestamp;
   store: Stores;
   productId: string;
   // Denormalized copy of the subscriber's email. Firestore is a non-relational
@@ -41,6 +42,7 @@ export class Subscription {
       creationDate,
       lastUpdate,
       expirationDate,
+      trialEnd,
       store,
       productId,
       email,
@@ -52,6 +54,7 @@ export class Subscription {
     this.creationDate = creationDate;
     this.lastUpdate = lastUpdate;
     this.expirationDate = expirationDate;
+    this.trialEnd = trialEnd;
     this.store = store;
     this.productId = productId;
     this.email = email;

package/templates/firebase/functions/src/subscriptions/stripe_functions.ts

@@ -275,6 +275,9 @@ async function upsertFromStripeSubscription(sub: Stripe.Subscription): Promise<v
   const expiration = periodEnd
     ? Timestamp.fromMillis(periodEnd * 1000)
     : undefined;
+  const trialEnd = sub.trial_end
+    ? Timestamp.fromMillis(sub.trial_end * 1000)
+    : undefined;
 
   const subscription = new Subscription(
     {
@@ -283,6 +286,7 @@ async function upsertFromStripeSubscription(sub: Stripe.Subscription): Promise<v
       creationDate: existing?.creationDate ?? now,
       lastUpdate: now,
       expirationDate: expiration,
+      trialEnd,
       store: Stores.STRIPE,
       productId: priceId,
       email: user.email,

package/templates/firebase/lib/components/kasy_alert.dart

@@ -53,7 +53,6 @@ class KasyAlert extends StatelessWidget {
     final bool hasMessage = message != null && message!.trim().isNotEmpty;
     final TextStyle titleStyle =
         context.textTheme.titleMedium?.copyWith(
-          fontWeight: FontWeight.w600,
           color: emphasizeTitleWithTone
               ? palette.accent
               : context.colors.onSurface,

package/templates/firebase/lib/components/kasy_app_bar.dart

@@ -186,7 +186,10 @@ class KasyTopScrollFade extends StatelessWidget {
     // On web topInset = 0; enforce a 6 px minimum so the strip still exists.
     final double solidHeight = topInset < 6 ? 6.0 : topInset;
     final double totalHeight = solidHeight + _contentFade;
-    final Color base = context.colors.surface;
+    // The page background (NOT the bar's `surface`): when the bar hides on
+    // scroll, content must melt into the page color, not into a floating sliver
+    // of the bar's tint at the top.
+    final Color base = context.colors.background;
 
     // Same gradient the grid cards use for their caption scrim — strong at the
     // top, melting gradually to fully transparent at the bottom.
@@ -238,6 +241,12 @@ class KasyAppBar extends StatelessWidget {
   /// or wrap a custom 44×44 chrome control with [KasyAppBarChromeTap] for the
   /// same tap target semantics as the built-in orbs.
   final Widget? trailing;
+
+  /// Replaces the default leading control (back button / spacer) — e.g. a menu
+  /// orb that opens a [KasySidebar] drawer. Use [KasyChromeOrbIconButton] so it
+  /// matches the trailing orbs' size and tap target.
+  final Widget? leading;
+
   final bool useSafeArea;
 
   /// When set, called instead of [ThemeProvider.toggle] for the theme orb
@@ -266,6 +275,7 @@ class KasyAppBar extends StatelessWidget {
     this.style = KasyAppBarStyle.subpage,
     this.onBack,
     this.trailing,
+    this.leading,
     this.useSafeArea = true,
     this.onThemeToggle,
     this.toolbarHeight,
@@ -285,20 +295,21 @@ class KasyAppBar extends StatelessWidget {
 
     final double rowHeight =
         toolbarHeight ?? kasyAppBarToolbarRowHeightOf(context);
-    final Widget leading = switch (style) {
-      KasyAppBarStyle.rootTab => SizedBox(
-        width: 44,
-        height: rowHeight,
-      ),
-      _ => KasyChromeOrbIconButton(
-        icon: KasyIcons.arrowBackIos,
-        iconSize: KasyIconSize.md,
-        foregroundColor: orbFg,
-        fillColor: orbFill,
-        onPressed: handleBack,
-        tooltip: MaterialLocalizations.of(context).backButtonTooltip,
-      ),
-    };
+    final Widget leadingWidget = leading ??
+        switch (style) {
+          KasyAppBarStyle.rootTab => SizedBox(
+            width: 44,
+            height: rowHeight,
+          ),
+          _ => KasyChromeOrbIconButton(
+            icon: KasyIcons.arrowBackIos,
+            iconSize: KasyIconSize.md,
+            foregroundColor: orbFg,
+            fillColor: orbFill,
+            onPressed: handleBack,
+            tooltip: MaterialLocalizations.of(context).backButtonTooltip,
+          ),
+        };
 
     final TextStyle? titleRef =
         context.textTheme.headlineSmall ?? context.textTheme.titleLarge;
@@ -326,7 +337,7 @@ class KasyAppBar extends StatelessWidget {
           children: [
             Row(
               children: [
-                leading,
+                leadingWidget,
                 const Spacer(),
                 _buildTrailing(context, orbFg, orbFill),
               ],
@@ -486,6 +497,10 @@ class KasyOverlayScaffold extends StatelessWidget {
     Widget scrollView = CustomScrollView(
       controller: scrollController,
       physics: effectivePhysics,
+      // Dragging the form means the user is done with the focused field and
+      // wants to see what's below, so dismiss the keyboard. Chat views opt out
+      // of this wrapper on purpose (there scrolling means reading, not typing).
+      keyboardDismissBehavior: ScrollViewKeyboardDismissBehavior.onDrag,
       slivers: kasyOverlayPaddedSlivers(
         context,
         contentPadding: contentPadding,

package/templates/firebase/lib/components/kasy_bottom_sheet.dart

@@ -105,7 +105,6 @@ class KasyBottomSheet extends StatelessWidget {
                     title!,
                     textAlign: centered ? TextAlign.center : TextAlign.start,
                     style: context.textTheme.titleLarge?.copyWith(
-                      fontWeight: FontWeight.w600,
                       color: context.colors.onSurface,
                     ),
                   ),

package/templates/firebase/lib/components/kasy_date_picker.dart

@@ -1457,7 +1457,6 @@ class _CalendarPanelState extends State<_CalendarPanel> {
             context.textTheme.labelLarge?.copyWith(
           color: context.colors.onSurface,
           fontWeight: FontWeight.w700,
-          fontSize: 14,
         );
 
         return Column(
@@ -1623,7 +1622,6 @@ class _MonthGrid extends StatelessWidget {
               style: context.textTheme.labelLarge?.copyWith(
                 color: context.colors.onSurface,
                 fontWeight: FontWeight.w700,
-                fontSize: 14,
               ),
             ),
           ),
@@ -1688,7 +1686,6 @@ class _CalendarNavRow extends StatelessWidget {
             style: context.textTheme.labelLarge?.copyWith(
               color: c.onSurface,
               fontWeight: FontWeight.w700,
-              fontSize: 14,
             ),
           ),
           const SizedBox(width: 4),
@@ -1903,7 +1900,6 @@ class _YearPickerContentState extends State<_YearPickerContent> {
                                 ? const Color(0xFFFCFCFC)
                                 : c.onSurface,
                             fontWeight: FontWeight.w600,
-                            fontSize: 14,
                           ),
                         ),
                       ),
@@ -2125,7 +2121,6 @@ class _DayCell extends StatelessWidget {
           style: context.textTheme.labelLarge?.copyWith(
             color: textColor,
             fontWeight: FontWeight.w600,
-            fontSize: 14,
             height: 1.43,
           ),
         ),