# Firebase Remote Config Basics

> Gestiona plantillas de Firebase Remote Config, feature flags, estrategias de carga y SDKs (Android, iOS): descarga/despliegue de JSON, versiones, defaults, fetchAndActivate() y listeners en tiempo real.

Fuente: https://skillsagentes.com/skills/firebase/agent-skills/firebase-remote-config-basics
Markdown: https://skillsagentes.com/skills/firebase/agent-skills/firebase-remote-config-basics.md

Repositorio: https://github.com/firebase/agent-skills
Autor: firebase
Licencia: Apache-2.0
Actualizado: el mes pasado
Coste de contexto: 93 tok instalada, 1.3k tok al activarse, 2.8k tok con todos los archivos del bundle
Bundle: 3 archivos, 11 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add firebase/agent-skills --skill firebase-remote-config-basics --agent claude-code
# Cursor
npx -y skills add firebase/agent-skills --skill firebase-remote-config-basics --agent cursor
# Codex
npx -y skills add firebase/agent-skills --skill firebase-remote-config-basics --agent codex
# Gemini CLI
npx -y skills add firebase/agent-skills --skill firebase-remote-config-basics --agent gemini
# Windsurf
npx -y skills add firebase/agent-skills --skill firebase-remote-config-basics --agent windsurf
# Cline
npx -y skills add firebase/agent-skills --skill firebase-remote-config-basics --agent cline
```

## Qué hace

- Descarga y despliega plantillas JSON de Remote Config vía Firebase CLI
- Edita el array "conditions" y el mapa "parameters" del template local
- Configura firebase.json para mapear el JSON local al servicio de Remote Config
- Guía la configuración del SDK de Remote Config en Android e iOS
- Verifica despliegues listando el historial de versiones (remoteconfig:versions:list)

## Cuándo usarla

- Al descargar o desplegar plantillas remoteconfig JSON
- Al gestionar el historial de versiones o feature flags
- Al configurar valores por defecto en la app o fetchAndActivate()
- Al configurar listeners en tiempo real o el SDK en Android/iOS

## Cuándo no

- Para Firebase Hosting, Auth, Firestore, Data Connect, Crashlytics o App Hosting

## Qué la activa

- "Descarga la plantilla actual de Remote Config a un JSON local"
- "Añade una condición por país al remote_config.json y despliégala"
- "Configura Remote Config en mi app de Android con valores por defecto"
- "Muéstrame el historial de versiones de Remote Config"

## Antes de instalar

- Requiere un proyecto y una app de Firebase (Android o iOS); la gestión por CLI usa Firebase CLI vía npx -y firebase-tools@latest o instalado globalmente.

## Archivos

- SKILL.md — 5 KB
- references/android_setup.md — 3 KB
- references/ios_setup.md — 3 KB

## SKILL.md

Reproducido tal cual desde firebase/agent-skills bajo Apache-2.0. Esta sección es el documento original y está en inglés.

# Remote Config

This skill provides a complete guide for getting started with Remote Config on
Android or iOS. Remote Config allows you to change the behavior and appearance
of your app without publishing an app update by maintaining a cloud-based
configuration template.

## Prerequisites

Provisioning Remote Config requires both a Firebase project and a Firebase app,
either Android or iOS. To manage the Remote Config template and conditions via
the command line, use the Firebase CLI. See the `firebase-basics` skill for
references on project initialization.

## Troubleshooting Execution

### Handling npx 403 Forbidden Errors

If `npx -y firebase-tools@latest` fails due to registry permissions (403 error):

1. **Inform the user**: "I am unable to fetch the latest Firebase tools via npx
   due to a registry error."
1. **Fallback**: Attempt to use the local `firebase` command directly if the
   user confirms it is installed globally (`npm install -g firebase-tools`).

### Handling Project Context Issues

If a command fails because "no active project is selected":

1. **Check login**: Run `npx -y firebase-tools@latest login:list`.
1. **Prompt for ID**: If logged in but no project is active, ask the user:
   "Please provide your Firebase Project ID to proceed."
1. **Use Flag**: Append `--project <PROJECT_ID>` to every subsequent command.

## SDK Setup

To learn how to set up Remote Config in your application code, choose your
platform:

- **Android**: [android_setup.md](references/android_setup.md)
- **iOS**: [ios_setup.md](references/ios_setup.md)

## Best Practices and Template Management

Follow these guidelines and use the associated CLI tools to ensure efficient and
safe use of Remote Config.

### Fetching Strategies

To optimize app performance and user experience, follow these recommended
patterns (see
[Loading Strategies](https://firebase.google.com/docs/remote-config/loading)):

- **Load new values for next startup**: The most effective pattern is to
  activate previously fetched values immediately on startup and fetch new values
  in the background to be used next time. This minimizes user wait time.
- **Real-time Updates**: Use the SDK's real-time listener to update the app
  instantly without a refresh when server-side configuration changes.

### Template Management via CLI

Use the following commands to manage your Remote Config template and version
history through the terminal:

- **Get current template**: Save the remote template to a local JSON file for
  auditing or modification.

  ```bash
  npx -y firebase-tools@latest remoteconfig:get -o remote_config.json
  ```

- **Autonomous Editing & Discovery** : Modify the local `remote_config.json`
  directly. Determine the correct signal (e.g., device.country or percent) and
  update the "conditions" array and "parameters" map accordingly.

- **MANDATORY: User Review and Verification** : STOP and ask the user to verify
  your changes before proceeding to deployment.

  - Action: Inform the user: "I have prepared the changes in remote_config.json.
    Please review the file for accuracy. Once you are satisfied, tell me to
    'deploy' to make the changes live."

- **Deployment Orchestration** : To push changes, you must ensure the
  environment is configured for deployment.

  - Config Mapping: If a firebase.json file is missing, create one to map the
    local JSON to the Remote Config service:

  ```json
    { "remoteconfig": { "template": "remote_config.json" } }
  ```

  - Deploy: Execute the partial deployment command
    
    ```bash
    npx -y firebase-tools@latest deploy --only remoteconfig
    ```

- **Verification**: After deployment, verify the update by listing the version
  history.

  ```bash
  npx -y firebase-tools@latest remoteconfig:versions:list
  ```

The SDK provides a number of features to make your application dynamic and
responsive to user segments.

- **Set In-App Defaults**: Define baseline values to ensure the app functions
  offline or before the first fetch.
- **Fetch and Activate**: Retrieve values from the Firebase backend and apply
  them to the local UI/Logic.
- **Template Management**: Use the Firebase CLI to version-control, get, and
  deploy your config JSON files.

## Dónde encaja

- Categoría: [Desarrollo de APIs](https://skillsagentes.com/categorias/desarrollo-apis.md) — Diseña, prueba y documenta APIs HTTP y GraphQL.
- Creador: [firebase](https://skillsagentes.com/creators/firebase.md) — 12 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Firebase Ai Logic Basics](https://skillsagentes.com/skills/firebase/agent-skills/firebase-ai-logic-basics.md): Skill oficial para integrar Firebase AI Logic (Gemini API) en apps. Cubre configuración, inferencia multimodal, salida estructurada y seguridad.
- [Firebase Firestore](https://skillsagentes.com/skills/firebase/agent-skills/firebase-firestore.md): Configura, gestiona, consulta y ajusta bases de datos Cloud Firestore (edición Standard/Enterprise): modelado de datos, reglas de seguridad, índices e integraciones SDK (Web, Python, iOS, Android, Flutter).
- [Firebase App Hosting Basics](https://skillsagentes.com/skills/firebase/agent-skills/firebase-app-hosting-basics.md): Despliega y gestiona apps full-stack (Next.js, Angular) con SSR usando Firebase App Hosting: apphosting.yaml, bloques apphosting en firebase.json, secretos y CI/CD con GitHub.
- [Firebase Hosting Basics](https://skillsagentes.com/skills/firebase/agent-skills/firebase-hosting-basics.md): Despliega y configura el Firebase Hosting clásico para sitios estáticos, SPAs y microservicios: dominios, firebase.json, redirects, rewrites y canales de vista previa.
- [Firebase Security Rules Auditor](https://skillsagentes.com/skills/firebase/agent-skills/firebase-security-rules-auditor.md): Audita reglas de seguridad de Firebase (Firestore, Cloud Storage): vulnerabilidades, escalada de privilegios, bypasses de roles, inconsistencias create/update y falta de comprobaciones hasOnly() de ownership.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)