expo-dev-client

Visión general de la skill expo-dev-client

Qué hace expo-dev-client

La skill expo-dev-client te ayuda a decidir si realmente necesitas un cliente de desarrollo de Expo y, a partir de ahí, te guía para configurarlo y compilarlo con EAS Build en local o para TestFlight. Su valor real no es solo “hacer una build”, sino “llevar una app de prueba con capacidades nativas personalizadas a dispositivos reales sin tener que adivinar entre la documentación de Expo”.

Quién debería usar esta skill

Esta skill encaja especialmente bien para:

• equipos que usan Expo y están añadiendo módulos nativos
• desarrolladores que prueban módulos locales de Expo o código nativo personalizado
• apps que usan objetivos específicos de Apple como widgets, app clips o extensiones
• equipos que necesitan una vía repetible para hacer pruebas internas en iOS mediante TestFlight

Si tu app funciona por completo en Expo Go, esta skill normalmente no hace falta.

La decisión clave de instalación

La gran pregunta antes de adoptarla es simple: ¿de verdad necesitas un development client? La skill expo-dev-client aporta valor porque responde eso desde el principio. De forma explícita, te empuja a probar primero Expo Go con npx expo start, lo que evita perder tiempo en builds y añadir complejidad innecesaria con EAS.

Qué diferencia a expo-dev-client de un prompt genérico sobre Expo

Un prompt genérico puede decirle a un agente “configura Expo dev client”, pero esta skill está mucho más orientada a la decisión. Se centra en:

• el umbral a partir del cual realmente necesitas un dev client
• la estructura necesaria de eas.json
• la diferencia entre builds locales y builds en la nube/TestFlight
• la ruta práctica de comandos para pruebas tipo despliegue en dispositivos físicos

Por eso resulta más útil para configuración y flujos cercanos a release que un prompt amplio de asistencia general sobre Expo.

Cómo usar la skill expo-dev-client

Instala la skill expo-dev-client

Instálala en tu entorno compatible con skills con:

npx skills add https://github.com/expo/skills --skill expo-dev-client

Como esta skill es compacta y está concentrada en SKILL.md, la instalación consiste sobre todo en dejarla disponible para reutilizarla durante tareas de prueba nativa con Expo.

Empieza por la necesidad real, no por el comando

Antes de invocar la skill expo-dev-client, define el objetivo real:

• “Añadimos un SDK nativo y necesito probarlo en un iPhone”
• “Necesitamos un dev client específico por rama para QA”
• “Nuestra app ahora incluye un widget, así que Expo Go ya no es suficiente”
• “Queremos una build de desarrollo para iOS distribuida por TestFlight”

Esto importa porque la skill rinde mejor cuando la necesidad de código nativo personalizado está clara.

Comprueba primero si Expo Go es suficiente

Un error habitual es recurrir a expo-dev-client demasiado pronto. La primera prueba recomendada es:

npx expo start

Si tu app funciona en Expo Go, quédate ahí. Un development client añade tiempo de build, requisitos de firma y carga operativa de distribución. Usa esta skill solo cuando las capacidades nativas obliguen a dar ese paso.

Identifica los casos en los que mejor encaja

Usa expo-dev-client cuando tu proyecto incluya:

• módulos locales de Expo
• código nativo personalizado
• módulos nativos de terceros que no están disponibles en Expo Go
• objetivos de Apple como widgets, app clips o extensiones

Estos son los escenarios en los que un dev client deja de ser “opcional” y pasa a ser “necesario”.

Prepara el mínimo de contexto que necesita un agente

Si quieres que un agente use bien la skill expo-dev-client, dale:

• plataforma objetivo: ios, android o ambas
• vía de distribución prevista: instalación local, pruebas internas o TestFlight
• si la app ya tiene EAS configurado
• tu eas.json actual
• si la app usa módulos nativos no compatibles con Expo Go
• cualquier restricción de versionado o firma

Sin ese contexto, el agente puede sugerir comandos, pero es fácil que no elija el perfil de build correcto o que recomiende más configuración de la necesaria.

Usa un prompt mejor que “set up expo-dev-client”

Un prompt débil:

Set up expo-dev-client.

Un prompt mejor:

Use the expo-dev-client skill to determine whether this Expo app needs a dev client. We added a third-party native iOS SDK and need a TestFlight-distributed development build for internal QA. Review this eas.json, identify missing settings, and give the exact commands for building and submitting.

Por qué funciona mejor:

• pide validar primero si realmente encaja
• menciona el detonante nativo
• especifica el flujo de trabajo objetivo
• aporta configuración para poder corregirla de forma concreta

Configura eas.json correctamente

La configuración clave que destaca la skill es un perfil de development build con developmentClient: true, normalmente junto con automatización de versiones:

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true
    },
    "development": {
      "autoIncrement": true,
      "developmentClient": true
    }
  },
  "submit": {
    "production": {},
    "development": {}
  }
}

Los campos importantes son:

• developmentClient: true: indica a EAS que incluya el development client
• autoIncrement: true: reduce la fricción con los números de build
• appVersionSource: "remote": mantiene un versionado coherente a través de EAS

Compila para TestFlight cuando las pruebas remotas en dispositivos importan

Para equipos iOS, la ruta de mayor valor de expo-dev-client usage suele ser TestFlight:

eas build -p ios --profile development --submit

Este es el flujo práctico de “expo-dev-client for Deployment” cuando necesitas una app con capacidades de desarrollo distribuida a testers, y no solo un artefacto local. Combina build en la nube y envío, lo que normalmente es más rápido que ir armando pasos separados.

Usa builds locales cuando importen la velocidad o la privacidad

Si no necesitas TestFlight, las builds locales pueden ser un mejor flujo de trabajo:

• iteración más rápida en algunos entornos
• mayor control sobre las herramientas locales
• útil para probar en dispositivos antes de una distribución interna más amplia

Elige local cuando estés depurando la configuración o validando una integración nativa en tu propio dispositivo. Elige TestFlight cuando estés coordinándote con QA o con testers no técnicos.

Lee primero el archivo correcto del repositorio

Esta skill es simple: empieza por SKILL.md. En esta ruta de la skill no hay directorios de apoyo adicionales como resources/, rules/ o scripts auxiliares, así que casi toda la guía útil ya está concentrada ahí.

Eso también implica que no deberías esperar una lógica de automatización profunda; se trata principalmente de una guía práctica de decisión y flujo de trabajo.

Flujo recomendado de expo-dev-client para proyectos reales

Un flujo fiable de expo-dev-client guide es:

1. Confirmar si Expo Go falla por una razón nativa.
2. Revisar o crear eas.json.
3. Añadir un perfil development con developmentClient: true.
4. Decidir entre build local o distribución mediante TestFlight.
5. Ejecutar el comando exacto de EAS Build para tu plataforma.
6. Probar en un dispositivo físico.
7. Revisar de nuevo los ajustes del perfil si el versionado o el comportamiento de envío no son los esperados.

Este orden reduce ciclos de build desperdiciados y detecta pronto el caso de “en realidad no hacía falta un dev client”.

Preguntas frecuentes sobre la skill expo-dev-client

¿La skill expo-dev-client es solo para apps Expo avanzadas?

En la mayoría de los casos, sí. Quienes empiezan también pueden usarla, pero la skill cobra más sentido cuando una app supera lo que Expo Go puede cubrir por requisitos nativos. Si todavía estás en un escenario puramente managed workflow, probablemente aún no te aporte mucho.

¿La skill expo-dev-client es lo mismo que instalar expo-dev-client en un proyecto?

No. La skill expo-dev-client ofrece guía sobre el flujo de trabajo alrededor de las builds con development client. Ayuda a decidir cuándo usarlas, cómo configurar EAS y cómo elegir una ruta de build. No es solo un recordatorio para instalar un paquete.

¿Cuándo no debería usar la skill expo-dev-client?

No la uses cuando:

• tu app ya funciona en Expo Go
• solo necesitas iterar a nivel de JavaScript
• buscas una guía completa para release builds y no para configurar un development client
• tu problema no está relacionado con capacidades nativas ni con distribución de builds

¿En qué se diferencia de un prompt normal de troubleshooting de Expo?

Un prompt normal puede generar consejos genéricos de build. La expo-dev-client skill es más específica y, por eso, funciona mejor como guía para decidir la instalación: pone el foco en el punto de control “¿hace falta un dev client o no?” y en los detalles exactos del perfil de EAS que suelen bloquear la adopción.

¿expo-dev-client también sirve para Android?

Sí, aunque la guía más explícita del fragmento de la skill está más orientada a iOS y TestFlight. La lógica de fondo sigue siendo válida para builds de desarrollo en Android cuando el código nativo personalizado exige un dev client en lugar de Expo Go.

¿Esto sirve para flujos de deployment?

Sí, con matices. expo-dev-client for Deployment se entiende mejor como distribución interna de builds de desarrollo, especialmente mediante TestFlight para QA o pruebas por rama. No sustituye una planificación completa de release a producción.

Cómo mejorar la skill expo-dev-client

Da desde el principio el estado actual del proyecto

Para obtener mejores resultados de la skill expo-dev-client, incluye:

• tu eas.json
• plataformas y dispositivos objetivo
• si será solo local o mediante TestFlight
• qué módulo nativo u objetivo obligó al cambio
• si ya se probó Expo Go

Esto ayuda al agente a pasar de una orientación genérica a ediciones y comandos concretos.

Pide primero una decisión antes de pedir pasos

Un prompt de calidad empieza con:

First determine whether this app truly needs expo-dev-client.

Esa sola instrucción mejora la calidad de la respuesta porque el principal valor de la skill es evitar configurar un dev client cuando no hace falta.

Incluye fragmentos de configuración para revisión

Si pegas tu eas.json actual, un agente puede:

• detectar si falta developmentClient: true
• sugerir ajustes de versionado
• alinear los perfiles submit y build
• evitar inventar configuración que no necesitas

Esto es mucho mejor que pedir ayuda desde cero.

Deja clara la intención de distribución

El comando correcto depende de si quieres:

• una build de desarrollo local
• una build en la nube para instalar en dispositivos
• una build iOS enviada a TestFlight

Si no lo especificas, la primera respuesta puede ser técnicamente correcta pero operativamente equivocada para tu equipo.

Vigila el principal modo de fallo

El error más común es usar expo-dev-client en apps que deberían seguir en Expo Go. El segundo es dar una configuración de EAS demasiado incompleta y luego culpar a la skill por responder de forma vaga. Ambos problemas se pueden evitar si indicas el requisito nativo y la configuración actual.

Itera después de la primera respuesta

Después de la primera respuesta, haz preguntas de seguimiento como:

• “Validate this eas.json against a dev-client TestFlight workflow.”
• “Rewrite the build commands for Android only.”
• “Assume our app uses a widget extension; what changes the decision?”
• “Minimize the setup to the smallest working development profile.”

Así llevas la expo-dev-client skill de una explicación genérica a una ejecución específica para tu proyecto.

Mejora la adopción en el equipo con un prompt estándar

Si varias personas del equipo van a usar esta skill, crea una plantilla interna reutilizable como:

Use expo-dev-client to assess whether this Expo app requires a development client. Here is our eas.json, target platform, distribution goal, and native dependency list. Return: 1) decision, 2) config changes, 3) exact commands, 4) likely blockers.

Esto hace que las respuestas sean más consistentes y reduce la fricción de onboarding.

Usa la skill como filtro de decisión, no solo como receta

La mejor forma de mejorar expo-dev-client usage es tratarla como un filtro de decisión antes de compilar. Si la skill solo se usa cuando el equipo ya decidió seguir con un dev client, pierdes su mayor ventaja: evitar la carga innecesaria de un flujo de builds nativos.