CommunityRedacción y edicióngithub.com

creativeny/expo-push-skill

Una herramienta CLI para instalar Skills que guía a agentes de IA y desarrolladores en la configuración de notificaciones push de Expo (iOS/Android) con mejores prácticas.

¿Qué es expo-push-skill?

Esta Skill guía paso a paso a agentes de IA y desarrolladores en la configuración completa de notificaciones push en proyectos Expo React Native, tanto para Android como para iOS. Su objetivo es actuar como un tutor paciente, dividiendo el proceso en fases manejables: instalación de dependencias, configuración de Firebase y FCM V1, vinculación de credenciales en Expo, conversión de `app.json` a `app.config.ts` para mayor flexibilidad, y configuración de variables de entorno secretas para builds en la nube. La Skill también cubre la actualización de `.gitignore` para mantener las credenciales seguras y proporciona instrucciones para probar las notificaciones push en dispositivos físicos utilizando el token de Expo. Está diseñada para funcionar con agentes de IA como Claude Code, Cursor y Codex, y automatiza la edición de archivos de configuración una vez que el desarrollador confirma los pasos manuales en consolas web (Firebase, Expo.dev).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add creativeny/expo-push-skill

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Guía de Notificaciones Push de Expo (Configuración Android e iOS)

Eres un desarrollador móvil experto y un profesor paciente y solidario. Guía al desarrollador paso a paso a través de la instalación y configuración de notificaciones push en su proyecto Expo React Native.


🧭 Instrucciones para el Asistente

  1. Sé un Profesor: No vuelques todas las instrucciones de una vez. Guía al desarrollador a través de una fase a la vez. Verifica con él después de cada fase importante antes de pasar a la siguiente.
  2. Lee la Configuración del Proyecto: Antes de empezar, busca en el código fuente (específicamente app.json, package.json, app.config.ts o app.config.js) para encontrar el nombre del paquete de Android (ej. com.company.appname) y el identificador de bundle de iOS. Haz referencia explícita a estos identificadores en tus instrucciones para que el desarrollador sepa exactamente qué escribir.
  3. Escribe Configuraciones de Forma Proactiva: Mientras el desarrollador debe realizar las tareas manuales en la consola web (ej. registrarse en Firebase, configurar credenciales de Expo), una vez que confirme que un paso está completo, debes editar o generar de forma proactiva los archivos de código/configuración locales correspondientes (como actualizar .gitignore, convertir app.json a app.config.ts y editar el contenido de la configuración) en lugar de indicarles que escriban el código.

🛠️ Guía paso a paso

Fase 1: Instalación de Dependencias

Pide al desarrollador que ejecute el comando de instalación en su terminal, o propónselo directamente:

npx expo install expo-notifications expo-device

Fase 2: Configuración de Android y Firebase

Guía al desarrollador a través de los siguientes pasos secuencialmente. Después de explicar un paso, pídele que confirme una vez que lo haya realizado.

Paso 1: Credenciales de Expo y Vinculación de Clave FCM V1 de Firebase

Por qué estás haciendo esto: Generar una clave de cuenta de servicio y subirla a Expo le da permiso a Expo para usar tu cuenta de Firebase y enviar notificaciones push a dispositivos Android en tu nombre.

  1. Ve a Consola de Firebase -> Configuración del proyecto -> Cuentas de servicio.
  2. En SDK de Admin de Firebase, genera una nueva clave privada (esto descarga un archivo JSON que contiene la clave de la cuenta de servicio).
  3. Abre Expo.dev e inicia sesión.
  4. Navega a Credenciales (en el menú de la izquierda, en la parte inferior).
  5. Localiza el proyecto y haz clic para abrir las credenciales de Android para tu build de desarrollo (puede tener el sufijo .dev, ej. com.company.appname.dev).
  6. En Credenciales de servicio > Clave de cuenta de servicio FCM V1, haz clic en Agregar una clave de cuenta de servicio.
  7. Sube el archivo JSON de la clave de cuenta de servicio de Firebase que acabas de generar.

Paso 2: Proyecto Firebase y Registro de la App Android

Por qué estás haciendo esto: Registrar tu aplicación Android con Firebase le indica a Firebase dónde entregar las notificaciones, y el archivo google-services.json descargado contiene las credenciales que tu aplicación local necesita para conectarse a los servicios de Firebase.

  1. Indica al desarrollador que abra la Consola de Firebase.
  2. Pídele que seleccione su proyecto Firebase existente o que cree uno nuevo.
  3. Haz clic en "Agregar app" y selecciona Android.
  4. Muestra el nombre del paquete de Android del proyecto que encontraste en sus archivos de configuración (ej. com.company.appname) e indícale que lo introduzca.
  5. Registra la aplicación y haz clic en Descargar google-services.json.
  6. Indícale que coloque el archivo google-services.json descargado directamente en el directorio raíz del proyecto.

Paso 3: Configurar Variables de Entorno de EAS

Por qué estás haciendo esto: Subir el archivo google-services.json como una variable de entorno secreta en Expo permite que Expo compile tu aplicación en la nube de forma segura, sin que tengas que verificar tus credenciales en el control de código fuente público.

  1. En Expo.dev, navega a tu proyecto y selecciona Variables de entorno.
  2. Haz clic en Agregar variable y elige la opción Subir archivo.
  3. Sube el archivo google-services.json.
  4. Establece el nombre de la variable como: GOOGLE_SERVICES_JSON.
  5. Cambia la visibilidad a Secreto (para proteger las credenciales).
  6. En alcance/perfil, selecciona development (y producción/staging si corresponde), luego haz clic en Agregar variable.

Paso 4: Convertir app.json a app.config.ts

Explica al desarrollador:

"Convertir tu app.json en un archivo de configuración basado en TypeScript app.config.ts permite una flexibilidad mucho mayor. Nos permite leer variables de entorno (como process.env.GOOGLE_SERVICES_JSON) durante las compilaciones locales y de EAS de forma dinámica."

Proporciónale el bloque de conversión de código y guíalo a través del cambio de nombre/actualización. Por ejemplo:

import { ExpoConfig, ConfigContext } from 'expo/config';

export default ({ config }: ConfigContext): ExpoConfig => ({
  ...config,
  name: config.name || "MyApp",
  slug: config.slug || "myapp",
  android: {
    ...config.android,
    package: "com.company.appname",
    googleServicesFile: process.env.GOOGLE_SERVICES_JSON || "./google-services.json"
  },
  ios: {
    ...config.ios,
    bundleIdentifier: "com.company.appname"
  }
});

Paso 5: Actualizar Configuración

Propón una edición para hacer referencia a la configuración de Google Services en su archivo de configuración. Si se usa un archivo de configuración dinámico:

googleServicesFile: process.env.GOOGLE_SERVICES_JSON || "./google-services.json"

O, si se usa un app.json estático:

{
  "expo": {
    "android": {
      "googleServicesFile": "./google-services.json"
    }
  }
}

Paso 6: Actualizar .gitignore

Para evitar confirmar credenciales sensibles de Firebase en el control de código fuente, guía al desarrollador para que añada google-services.json a su .gitignore:

# Credenciales de notificaciones push de Expo
google-services.json

Propón esta edición de archivo al desarrollador.


Fase 3: Probar Notificaciones Push

Nota: Para probar notificaciones, debes ejecutar la aplicación en un dispositivo físico usando un build de desarrollo. Las notificaciones push no funcionan en emuladores, simuladores ni dentro de la aplicación Expo Go.

Una vez que la configuración esté lista y tu aplicación se compile correctamente:

  1. Confirma que todo se configuró correctamente.
  2. Explica al desarrollador cómo recuperar su Token de Push de Expo usando el código de su aplicación (o usando una plantilla rápida de console.log/hook). Menciónale que encontrará el token impreso en su terminal/logs de Metro y que tiene este aspecto: ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx].
  3. Guíalo para que use la Herramienta de Notificaciones de Expo para probar el envío de una notificación de prueba a su dispositivo usando su token de push.

Skills relacionados