kasy-cli 1.2.1

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

@@ -0,0 +1,145 @@
+# Social authentication setup
+
+Guide to enable Google, Apple, and Facebook login in your project.
+
+---
+
+## Google Sign-In
+
+The CLI handles the technical setup automatically when generating the project:
+- Reads the `REVERSED_CLIENT_ID` from `GoogleService-Info.plist`
+- Registers the URL scheme in `ios/Runner/Info.plist`
+- Writes `lib/google_auth_options.dart` with the Web Client ID
+
+**What you need to verify once:**
+
+1. [Firebase Console → Authentication → Sign-in method → Google](https://console.firebase.google.com/project/_/authentication/providers) → enable
+2. The CLI automatically adds the debug keystore SHA-1 for Android. If you use a new computer or a different keystore, verify with:
+```bash
+kasy doctor
+```
+
+---
+
+## Apple Sign-In
+
+Requires an [Apple Developer](https://developer.apple.com) account (paid).
+
+### Step 1 — Enable capability on Bundle ID
+
+1. Open [Identifiers](https://developer.apple.com/account/resources/identifiers/list)
+2. Select your Bundle ID
+3. Enable **Sign In with Apple** → Enable as a primary App ID → **Save**
+
+### Step 2 — Create a key
+
+1. Open [Keys](https://developer.apple.com/account/resources/authkeys/list)
+2. Click **+** → enter a name (e.g. `Firebase Sign In with Apple`)
+3. Enable **Sign In with Apple** → Configure → select your Bundle ID → Save
+4. Register → **download the `.p8` file** (can only be downloaded once — store it safely)
+5. Note the **Key ID** (e.g. `6RR89XG535`)
+
+### Step 3 — Create a Services ID
+
+1. Open [Services IDs](https://developer.apple.com/account/resources/identifiers/list/serviceId)
+2. Click **+** → select **Services IDs** → Continue
+3. Fill in:
+   - **Description**: `Firebase Sign In with Apple`
+   - **Identifier**: `YOUR_BUNDLE_ID.signin` (e.g. `com.company.app.signin`)
+4. Register → click the new Services ID → enable **Sign In with Apple** → Configure
+5. Fill in:
+   - **Primary App ID**: your Bundle ID
+   - **Domains**: `YOUR_PROJECT.firebaseapp.com`
+   - **Return URLs**: `https://YOUR_PROJECT.firebaseapp.com/__/auth/handler`
+6. Next → Done → Continue → **Save**
+
+### Step 4 — Configure in Firebase
+
+1. Open [Firebase Console → Authentication → Apple](https://console.firebase.google.com/project/_/authentication/providers)
+2. Enable the Apple provider
+3. Fill in under **OAuth code flow configuration**:
+   - **Services ID**: the identifier from Step 3 (e.g. `com.company.app.signin`)
+   - **Team ID**: found at [Membership Details](https://developer.apple.com/account#MembershipDetailsCard)
+   - **Key ID**: the Key ID from Step 2
+   - **Private key**: full content of the `.p8` file, including the `-----BEGIN PRIVATE KEY-----` and `-----END PRIVATE KEY-----` lines
+4. **Save**
+
+### Step 5 — Enable capability in Xcode
+
+1. Open `ios/Runner.xcworkspace` in Xcode
+2. Target **Runner** → **Signing & Capabilities** → **+ Capability** → add **Sign In with Apple**
+
+> **Android and Web**: no additional setup needed. The Firebase SDK handles the flow on Android. For Web, the Services ID (Step 3) already covers the redirect flow via `firebaseapp.com`.
+
+---
+
+## Facebook Sign-In
+
+Requires a [Meta for Developers](https://developers.facebook.com) account.
+
+### Step 1 — Create an app on Meta
+
+1. Open [Meta for Developers → My Apps](https://developers.facebook.com/apps)
+2. Click **Create App** → select **Consumer** → Next
+3. Enter the app name → Create App
+4. In the app dashboard, note the **App ID** and **Client Token** (Settings → Advanced → Client Token)
+
+### Step 2 — Enable Facebook Login
+
+1. In the Meta app dashboard → Add Product → **Facebook Login** → Set Up → iOS/Android as needed
+2. iOS: provide your app's Bundle ID
+
+### Step 3 — iOS: update Info.plist
+
+Edit `ios/Runner/Info.plist` and replace the placeholders:
+
+```xml
+<key>FacebookAppID</key>
+<string>YOUR_APP_ID</string>
+<key>FacebookClientToken</key>
+<string>YOUR_CLIENT_TOKEN</string>
+<key>FacebookDisplayName</key>
+<string>Your app name</string>
+```
+
+And the URL scheme (inside `CFBundleURLTypes`):
+```xml
+<string>fbYOUR_APP_ID</string>
+```
+
+### Step 4 — Android: update strings.xml
+
+Edit `android/app/src/main/res/values/strings.xml` and replace the placeholders:
+
+```xml
+<string name="facebook_app_id">YOUR_APP_ID</string>
+<string name="facebook_client_token">YOUR_CLIENT_TOKEN</string>
+```
+
+### Step 5 — Web: add domain in Meta
+
+1. In the Meta app dashboard → Facebook Login → Settings
+2. Under **Valid OAuth Redirect URIs**, add `https://YOUR_PROJECT.firebaseapp.com/__/auth/handler`
+3. Under **Allowed Domains for the JavaScript SDK**, add `YOUR_PROJECT.firebaseapp.com`
+
+Verify with:
+```bash
+kasy doctor
+```
+
+---
+
+## Supabase
+
+For projects using the Supabase backend, the Apple and Meta setup is identical. What changes is where you register the credentials:
+
+| Provider | Where to configure |
+|----------|--------------------|
+| Google | Supabase Dashboard → Auth → Providers → Google |
+| Apple | Supabase Dashboard → Auth → Providers → Apple (Services ID required) |
+| Facebook | Supabase Dashboard → Auth → Providers → Facebook |
+
+For Apple with Supabase, the Services ID **Return URL** must be:
+```
+https://YOUR_PROJECT.supabase.co/auth/v1/callback
+```

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

@@ -0,0 +1,145 @@
+# Configurar autenticación social
+
+Guía para activar el inicio de sesión con Google, Apple y Facebook en tu proyecto.
+
+---
+
+## Google Sign-In
+
+La CLI se encarga de la configuración técnica automáticamente al generar el proyecto:
+- Lee el `REVERSED_CLIENT_ID` del `GoogleService-Info.plist`
+- Registra el URL scheme en `ios/Runner/Info.plist`
+- Escribe `lib/google_auth_options.dart` con el Web Client ID
+
+**Lo que debes verificar una sola vez:**
+
+1. [Firebase Console → Authentication → Sign-in method → Google](https://console.firebase.google.com/project/_/authentication/providers) → activar
+2. La CLI agrega el SHA-1 del debug keystore automáticamente en Android. Si usas un equipo nuevo o un keystore diferente, verifica con:
+```bash
+kasy doctor
+```
+
+---
+
+## Apple Sign-In
+
+Requiere cuenta de [Apple Developer](https://developer.apple.com) (de pago).
+
+### Paso 1 — Activar capability en el Bundle ID
+
+1. Abre [Identifiers](https://developer.apple.com/account/resources/identifiers/list)
+2. Selecciona tu Bundle ID
+3. Activa **Sign In with Apple** → Enable as a primary App ID → **Save**
+
+### Paso 2 — Crear una clave
+
+1. Abre [Keys](https://developer.apple.com/account/resources/authkeys/list)
+2. Haz clic en **+** → escribe un nombre (ej: `Firebase Sign In with Apple`)
+3. Activa **Sign In with Apple** → Configure → selecciona tu Bundle ID → Save
+4. Regístrala → **descarga el archivo `.p8`** (solo se puede descargar una vez — guárdalo en un lugar seguro)
+5. Anota el **Key ID** (ej: `6RR89XG535`)
+
+### Paso 3 — Crear un Services ID
+
+1. Abre [Services IDs](https://developer.apple.com/account/resources/identifiers/list/serviceId)
+2. Haz clic en **+** → selecciona **Services IDs** → Continue
+3. Rellena:
+   - **Description**: `Firebase Sign In with Apple`
+   - **Identifier**: `TU_BUNDLE_ID.signin` (ej: `com.empresa.app.signin`)
+4. Regístralo → haz clic en el Services ID recién creado → activa **Sign In with Apple** → Configure
+5. Rellena:
+   - **Primary App ID**: tu Bundle ID
+   - **Domains**: `TU_PROYECTO.firebaseapp.com`
+   - **Return URLs**: `https://TU_PROYECTO.firebaseapp.com/__/auth/handler`
+6. Next → Done → Continue → **Save**
+
+### Paso 4 — Configurar en Firebase
+
+1. Abre [Firebase Console → Authentication → Apple](https://console.firebase.google.com/project/_/authentication/providers)
+2. Activa el proveedor Apple
+3. Rellena en **Configuración del flujo de código OAuth**:
+   - **Services ID**: el identifier del Paso 3 (ej: `com.empresa.app.signin`)
+   - **Team ID**: encuéntralo en [Membership Details](https://developer.apple.com/account#MembershipDetailsCard)
+   - **Key ID**: el Key ID del Paso 2
+   - **Clave privada**: contenido completo del archivo `.p8`, incluyendo las líneas `-----BEGIN PRIVATE KEY-----` y `-----END PRIVATE KEY-----`
+4. **Guardar**
+
+### Paso 5 — Activar capability en Xcode
+
+1. Abre `ios/Runner.xcworkspace` en Xcode
+2. Target **Runner** → **Signing & Capabilities** → **+ Capability** → agrega **Sign In with Apple**
+
+> **Android y Web**: no se necesita configuración adicional. El SDK de Firebase gestiona el flujo en Android. Para Web, el Services ID (Paso 3) ya cubre el flujo de redirect vía `firebaseapp.com`.
+
+---
+
+## Facebook Sign-In
+
+Requiere cuenta en [Meta for Developers](https://developers.facebook.com).
+
+### Paso 1 — Crear una app en Meta
+
+1. Abre [Meta for Developers → My Apps](https://developers.facebook.com/apps)
+2. Haz clic en **Create App** → selecciona **Consumer** → Next
+3. Ingresa el nombre de la app → Create App
+4. En el panel de la app, anota el **App ID** y el **Client Token** (Settings → Advanced → Client Token)
+
+### Paso 2 — Activar Facebook Login
+
+1. En el panel de la app Meta → Add Product → **Facebook Login** → Set Up → iOS/Android según corresponda
+2. iOS: proporciona el Bundle ID de tu app
+
+### Paso 3 — iOS: actualizar Info.plist
+
+Edita `ios/Runner/Info.plist` y reemplaza los placeholders:
+
+```xml
+<key>FacebookAppID</key>
+<string>TU_APP_ID</string>
+<key>FacebookClientToken</key>
+<string>TU_CLIENT_TOKEN</string>
+<key>FacebookDisplayName</key>
+<string>Nombre de tu app</string>
+```
+
+Y el URL scheme (dentro de `CFBundleURLTypes`):
+```xml
+<string>fbTU_APP_ID</string>
+```
+
+### Paso 4 — Android: actualizar strings.xml
+
+Edita `android/app/src/main/res/values/strings.xml` y reemplaza los placeholders:
+
+```xml
+<string name="facebook_app_id">TU_APP_ID</string>
+<string name="facebook_client_token">TU_CLIENT_TOKEN</string>
+```
+
+### Paso 5 — Web: agregar dominio en Meta
+
+1. En el panel de la app Meta → Facebook Login → Settings
+2. En **Valid OAuth Redirect URIs**, agrega `https://TU_PROYECTO.firebaseapp.com/__/auth/handler`
+3. En **Allowed Domains for the JavaScript SDK**, agrega `TU_PROYECTO.firebaseapp.com`
+
+Verifica con:
+```bash
+kasy doctor
+```
+
+---
+
+## Supabase
+
+Para proyectos con backend Supabase, la configuración del lado de Apple y Meta es idéntica. Lo que cambia es dónde registrar las credenciales:
+
+| Proveedor | Dónde configurar |
+|-----------|-----------------|
+| Google | Supabase Dashboard → Auth → Providers → Google |
+| Apple | Supabase Dashboard → Auth → Providers → Apple (Services ID obligatorio) |
+| Facebook | Supabase Dashboard → Auth → Providers → Facebook |
+
+Para Apple con Supabase, el **Return URL** del Services ID debe ser:
+```
+https://TU_PROYECTO.supabase.co/auth/v1/callback
+```

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

@@ -0,0 +1,145 @@
+# Configurar autenticação social
+
+Guia para ativar login com Google, Apple e Facebook no seu projeto.
+
+---
+
+## Google Sign-In
+
+A CLI já faz a parte técnica automaticamente ao gerar o projeto:
+- Lê o `REVERSED_CLIENT_ID` do `GoogleService-Info.plist`
+- Registra o URL scheme no `ios/Runner/Info.plist`
+- Grava o `lib/google_auth_options.dart` com o Web Client ID
+
+**O que você precisa verificar uma única vez:**
+
+1. [Firebase Console → Authentication → Sign-in method → Google](https://console.firebase.google.com/project/_/authentication/providers) → ativar
+2. A CLI já adiciona o SHA-1 do debug keystore automaticamente no Android. Se usar um computador novo ou keystore diferente, verifique com:
+```bash
+kasy doctor
+```
+
+---
+
+## Apple Sign-In
+
+Requer conta [Apple Developer](https://developer.apple.com) (paga).
+
+### Passo 1 — Ativar capability no Bundle ID
+
+1. Abra [Identifiers](https://developer.apple.com/account/resources/identifiers/list)
+2. Selecione seu Bundle ID
+3. Ative **Sign In with Apple** → Enable as a primary App ID → **Save**
+
+### Passo 2 — Criar chave
+
+1. Abra [Keys](https://developer.apple.com/account/resources/authkeys/list)
+2. Clique em **+** → dê um nome (ex: `Firebase Sign In with Apple`)
+3. Ative **Sign In with Apple** → Configure → selecione seu Bundle ID → Save
+4. Registre → **baixe o `.p8`** (só é possível baixar uma vez — guarde em lugar seguro)
+5. Anote o **Key ID** (ex: `6RR89XG535`)
+
+### Passo 3 — Criar Services ID
+
+1. Abra [Services IDs](https://developer.apple.com/account/resources/identifiers/list/serviceId)
+2. Clique em **+** → selecione **Services IDs** → Continue
+3. Preencha:
+   - **Description**: `Firebase Sign In with Apple`
+   - **Identifier**: `SEU_BUNDLE_ID.signin` (ex: `com.empresa.app.signin`)
+4. Registre → clique no Services ID recém-criado → ative **Sign In with Apple** → Configure
+5. Preencha:
+   - **Primary App ID**: seu Bundle ID
+   - **Domains**: `SEU_PROJETO.firebaseapp.com`
+   - **Return URLs**: `https://SEU_PROJETO.firebaseapp.com/__/auth/handler`
+6. Next → Done → Continue → **Save**
+
+### Passo 4 — Configurar no Firebase
+
+1. Abra [Firebase Console → Authentication → Apple](https://console.firebase.google.com/project/_/authentication/providers)
+2. Ative o provedor Apple
+3. Preencha em **Configuração do fluxo de código OAuth**:
+   - **Services ID**: o identifier do Passo 3 (ex: `com.empresa.app.signin`)
+   - **Team ID**: encontrado em [Membership Details](https://developer.apple.com/account#MembershipDetailsCard)
+   - **ID da chave**: o Key ID do Passo 2
+   - **Chave privada**: conteúdo completo do arquivo `.p8`, incluindo as linhas `-----BEGIN PRIVATE KEY-----` e `-----END PRIVATE KEY-----`
+4. **Salvar**
+
+### Passo 5 — Ativar capability no Xcode
+
+1. Abra `ios/Runner.xcworkspace` no Xcode
+2. Target **Runner** → **Signing & Capabilities** → **+ Capability** → adicione **Sign In with Apple**
+
+> **Android e Web**: não precisam de configuração adicional. O Firebase SDK gerencia o fluxo no Android. Para Web, o Services ID (Passo 3) já cobre o fluxo de redirect via `firebaseapp.com`.
+
+---
+
+## Facebook Sign-In
+
+Requer conta no [Meta for Developers](https://developers.facebook.com).
+
+### Passo 1 — Criar app no Meta
+
+1. Abra [Meta for Developers → My Apps](https://developers.facebook.com/apps)
+2. Clique em **Create App** → selecione **Consumer** → Next
+3. Preencha o nome do app → Create App
+4. No painel do app, anote o **App ID** e o **Client Token** (Settings → Advanced → Client Token)
+
+### Passo 2 — Ativar Facebook Login
+
+1. No painel do app Meta → Add Product → **Facebook Login** → Set Up → iOS/Android conforme necessário
+2. iOS: informe o Bundle ID do seu app
+
+### Passo 3 — iOS: atualizar Info.plist
+
+Edite `ios/Runner/Info.plist` e substitua os placeholders:
+
+```xml
+<key>FacebookAppID</key>
+<string>SEU_APP_ID</string>
+<key>FacebookClientToken</key>
+<string>SEU_CLIENT_TOKEN</string>
+<key>FacebookDisplayName</key>
+<string>Nome do seu app</string>
+```
+
+E o URL scheme (dentro de `CFBundleURLTypes`):
+```xml
+<string>fbSEU_APP_ID</string>
+```
+
+### Passo 4 — Android: atualizar strings.xml
+
+Edite `android/app/src/main/res/values/strings.xml` e substitua os placeholders:
+
+```xml
+<string name="facebook_app_id">SEU_APP_ID</string>
+<string name="facebook_client_token">SEU_CLIENT_TOKEN</string>
+```
+
+### Passo 5 — Web: adicionar domínio no Meta
+
+1. No painel do app Meta → Facebook Login → Settings
+2. Em **Valid OAuth Redirect URIs**, adicione `https://SEU_PROJETO.firebaseapp.com/__/auth/handler`
+3. Em **Allowed Domains for the JavaScript SDK**, adicione `SEU_PROJETO.firebaseapp.com`
+
+Verifique com:
+```bash
+kasy doctor
+```
+
+---
+
+## Supabase
+
+Para projetos com backend Supabase, a configuração do lado da Apple e do Meta é idêntica. O que muda é onde cadastrar as credenciais:
+
+| Provedor | Onde configurar |
+|----------|----------------|
+| Google | Supabase Dashboard → Auth → Providers → Google |
+| Apple | Supabase Dashboard → Auth → Providers → Apple (Services ID obrigatório) |
+| Facebook | Supabase Dashboard → Auth → Providers → Facebook |
+
+No Apple com Supabase, o **Return URL** do Services ID deve ser:
+```
+https://SEU_PROJETO.supabase.co/auth/v1/callback
+```

package/templates/firebase/docs/codemagic-release.en.md

@@ -0,0 +1,50 @@
+# Publish iOS with Codemagic (no Mac)
+
+## Prerequisites
+
+- [Codemagic](https://codemagic.io) account
+- Git repository connected to Codemagic
+- Apple Developer account + app in App Store Connect
+
+## 1. Add CI to the project (if missing)
+
+```bash
+kasy add ci
+```
+
+Creates `codemagic.yaml` at the project root.
+
+## 2. Configure in the Codemagic dashboard
+
+1. Open [codemagic.io/apps](https://codemagic.io/apps) and add your repository.
+2. **Code signing (iOS):** set up App Store distribution certificate and profile.
+3. **Integrations → App Store Connect:** link your Apple account.
+4. **Environment variables:** add to your variable group (e.g. `appstore_credentials`):
+   - `BACKEND_URL`, `SENTRY_DSN`, `RC_IOS_API_KEY`, `RC_ANDROID_API_KEY`, `MIXPANEL_TOKEN`
+5. In `codemagic.yaml`, set `APP_ID` (numeric App Store Connect app ID from the app URL).
+
+## 3. Configure from the terminal
+
+```bash
+kasy codemagic configure
+```
+
+Enter **API token** (Settings → Codemagic API), **App ID**, and **Workflow ID** (default `ios-workflow`).
+
+## 4. Trigger a build
+
+```bash
+kasy codemagic release
+```
+
+The cloud build runs and may upload to TestFlight per `codemagic.yaml`.
+
+## Build status
+
+```bash
+kasy codemagic status <buildId>
+```
+
+## Local Mac
+
+If you have a Mac: [ios-release.md](./ios-release.md) and `kasy ios release`.

package/templates/firebase/docs/codemagic-release.es.md

@@ -0,0 +1,50 @@
+# Publicar iOS con Codemagic (sin Mac)
+
+## Requisitos
+
+- Cuenta [Codemagic](https://codemagic.io)
+- Repositorio Git conectado a Codemagic
+- Cuenta Apple Developer + app en App Store Connect
+
+## 1. Agregar CI al proyecto (si falta)
+
+```bash
+kasy add ci
+```
+
+Crea `codemagic.yaml` en la raíz del proyecto.
+
+## 2. Configurar en el panel Codemagic
+
+1. Abre [codemagic.io/apps](https://codemagic.io/apps) y agrega el repositorio.
+2. **Code signing (iOS):** certificado y perfil de distribución App Store.
+3. **Integrations → App Store Connect:** vincula la cuenta Apple.
+4. **Environment variables:** en el grupo del app (ej. `appstore_credentials`):
+   - `BACKEND_URL`, `SENTRY_DSN`, `RC_IOS_API_KEY`, `RC_ANDROID_API_KEY`, `MIXPANEL_TOKEN`
+5. En `codemagic.yaml`, completa `APP_ID` (ID numérico del app en App Store Connect).
+
+## 3. Configurar en la terminal
+
+```bash
+kasy codemagic configure
+```
+
+Indica **API token** (Settings → Codemagic API), **App ID** y **Workflow ID** (`ios-workflow` por defecto).
+
+## 4. Disparar build
+
+```bash
+kasy codemagic release
+```
+
+El build en la nube puede subir a TestFlight según `codemagic.yaml`.
+
+## Estado del build
+
+```bash
+kasy codemagic status <buildId>
+```
+
+## Mac local
+
+Si tienes Mac: [ios-release.md](./ios-release.md) y `kasy ios release`.

package/templates/firebase/docs/codemagic-release.pt.md

@@ -0,0 +1,50 @@
+# Publicar iOS com Codemagic (sem Mac)
+
+## Pré-requisitos
+
+- Conta [Codemagic](https://codemagic.io)
+- Repositório Git conectado ao Codemagic
+- Conta Apple Developer + app no App Store Connect
+
+## 1. Adicionar CI ao projeto (se ainda não tiver)
+
+```bash
+kasy add ci
+```
+
+Isso cria `codemagic.yaml` na raiz do projeto.
+
+## 2. Configurar no painel Codemagic
+
+1. Abra [codemagic.io/apps](https://codemagic.io/apps) e adicione o repositório.
+2. **Code signing (iOS):** configure certificado e perfil de distribuição App Store.
+3. **Integrations → App Store Connect:** conecte a conta Apple (recomendado).
+4. **Environment variables:** adicione no grupo do app (ex.: `appstore_credentials`):
+   - `BACKEND_URL`, `SENTRY_DSN`, `RC_IOS_API_KEY`, `RC_ANDROID_API_KEY`, `MIXPANEL_TOKEN`
+5. No `codemagic.yaml`, preencha `APP_ID` (ID numérico do app no App Store Connect — aparece na URL do app).
+
+## 3. Configurar no terminal
+
+```bash
+kasy codemagic configure
+```
+
+Informe o **API token** (Settings → Codemagic API), **App ID** e **Workflow ID** (`ios-workflow` por padrão).
+
+## 4. Disparar build
+
+```bash
+kasy codemagic release
+```
+
+O build roda na nuvem e, conforme o `codemagic.yaml`, pode enviar para TestFlight automaticamente.
+
+## Status do build
+
+```bash
+kasy codemagic status <buildId>
+```
+
+## Mac local
+
+Se tiver Mac: [ios-release.md](./ios-release.md) e `kasy ios release`.

package/templates/firebase/docs/ios-release.en.md

@@ -0,0 +1,41 @@
+# Publish to iOS (App Store)
+
+## Prerequisites
+
+- Paid [Apple Developer](https://developer.apple.com) account
+- App created in [App Store Connect](https://appstoreconnect.apple.com) with the same **Bundle ID** as your project
+- Mac with Xcode and Flutter installed
+
+## One-time setup
+
+```bash
+kasy ios configure
+```
+
+Opens Apple links, collects the API key (`.p8`), and writes `.kasy/apple.env` (gitignored).
+
+## Ship a new build
+
+```bash
+kasy ios release
+```
+
+Bumps the build number in `pubspec.yaml`, builds the IPA, and uploads to App Store Connect (no Transporter).
+
+Shortcut: `make release-ios`
+
+### Options
+
+- `kasy ios build` — IPA only, no upload
+- `kasy ios release --no-bump` — skip build number bump
+- `kasy ios release --version-name 1.0.1` — change marketing version
+
+## No Mac?
+
+Use cloud builds: [codemagic-release.md](./codemagic-release.md) and `kasy codemagic configure` / `kasy codemagic release`.
+
+## Check environment
+
+```bash
+kasy doctor
+```

package/templates/firebase/docs/ios-release.es.md

@@ -0,0 +1,41 @@
+# Publicar en iOS (App Store)
+
+## Requisitos
+
+- Cuenta de pago [Apple Developer](https://developer.apple.com)
+- App creada en [App Store Connect](https://appstoreconnect.apple.com) con el mismo **Bundle ID** del proyecto
+- Mac con Xcode y Flutter instalados
+
+## Configuración única
+
+```bash
+kasy ios configure
+```
+
+Abre los enlaces de Apple, pide la clave API (`.p8`) y guarda `.kasy/apple.env` (no se sube a Git).
+
+## Enviar nueva versión
+
+```bash
+kasy ios release
+```
+
+Incrementa el build en `pubspec.yaml`, genera el IPA y lo sube a App Store Connect (sin Transporter).
+
+Atajo: `make release-ios`
+
+### Opciones
+
+- `kasy ios build` — solo IPA, sin subir
+- `kasy ios release --no-bump` — no incrementar build
+- `kasy ios release --version-name 1.0.1` — cambiar versión visible
+
+## ¿Sin Mac?
+
+Build en la nube: [codemagic-release.md](./codemagic-release.md) y `kasy codemagic configure` / `kasy codemagic release`.
+
+## Verificar entorno
+
+```bash
+kasy doctor
+```