For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/mobile/local-setup.md (or send Accept: text/markdown).

Ejecuta la aplicación móvil

Conecta Expo a una API de desarrollo accesible.

Preguntar sobre esta guía

1. Prepare la computadora, el teléfono y el backend

Complete Antes de comenzar y abra el repositorio móvil o monorepo para todas las plataformas en su editor. En Terminal → Nueva Terminal en la raíz del repositorio, ejecute el siguiente comando de instalación. Espere a que termine. Instale Expo Go en su teléfono usando la página oficial Expo vinculada a continuación; su versión debe ser compatible con la versión Expo SDK registrada en apps/mobile/package.json.

Un backend es el servidor web que maneja el inicio de sesión, los datos del espacio de trabajo y las solicitudes de IA. Si su pago contiene apps/web, primero ejecute la configuración web en otra terminal y deje ese servidor en ejecución. Complete la configuración de Postgres antes de intentar registrarse o iniciar sesión de forma nativa. Un pago solo para dispositivos móviles no contiene apps/web: en su lugar, conéctelo a su backend en ejecución, proporcionado por separado. Al iniciar Expo se inicia el servidor de vista previa de pantalla, no el backend.

Pon tu teléfono y computadora en el mismo Wi-Fi. Desconecte temporalmente un VPN si bloquea las conexiones locales. localhost de un teléfono significa el teléfono en sí. Utilice la dirección de red privada de su computadora para un teléfono físico o dispositivo Android; El simulador de iOS en la misma Mac puede usar http://localhost:3000, y el emulador de Android comúnmente usa http://10.0.2.2:3000..

corepack pnpm install

2. Busque y pruebe la dirección de backend

En Windows, ejecute ipconfig en una nueva terminal PowerShell, busque su adaptador Wi-Fi activo y lea la dirección IPv4. En macOS, abra Configuración del sistema → Wi-Fi → Detalles → TCP/IP y lea la dirección IP. En Linux, abra la configuración de red y lea Dirección IPv4. Una dirección podría parecerse a 192.168.1.25; el tuyo normalmente será diferente.

Si la dirección de su computadora es 192.168.1.25, abra http://192.168.1.25:3000 en el navegador del teléfono mientras el servidor web se está ejecutando. Sustituya su dirección real. La página de inicio debe cargarse antes de continuar. Permita la aplicación Node en redes privadas si el Firewall de Windows lo solicita. Si no se carga, verifique la dirección, Wi-Fi, firewall y servidor web en ejecución; un túnel Expo solo transporta el paquete de vista previa y no hace que se pueda acceder a su API por separado.

# Windows PowerShell only:
ipconfig

3. Cree el archivo de configuración de la aplicación móvil.

En el Explorador del editor, expanda aplicaciones → móvil, cree un nuevo archivo llamado .env.local y pegue la siguiente configuración en ese archivo. Reemplace 192.168.1.25 con la dirección que acaba de probar o use la dirección de backend HTTPS proporcionada. Guarde el archivo. Su ruta completa es apps/mobile/.env.local; Expo no lee automáticamente root .env.

Mantenga desactivada la configuración de compra del teléfono para la primera vista previa. EXPO_PUBLIC_ significa que se incluye una configuración en la aplicación del teléfono, por lo que estos valores deben contener solo URL públicas, esquemas y configuraciones de cliente públicas. No pegue aquí secretos de facturación, bases de datos o proveedores de IA. El servidor Web dispone de su propio apps/web/.env.local; cambiar el archivo móvil no cambia el servidor.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4. Inicie Expo y abra la vista previa.

Desde la raíz del repositorio, ejecute el siguiente comando. Espere un código QR y el mensaje de espera de Metro. Mantenga abiertos este terminal y el terminal backend. En Android abra Expo Go y escanee el código QR; en iPhone use la cámara, escanee el código y ábralo en Expo Go. El código QR abre la aplicación de desarrollo, no la página de inicio del backend.

El éxito significa que la pantalla de inicio de sesión de la aplicación se abre en su dispositivo. Con las compras desactivadas, esta es una vista previa de la interfaz de usuario; complete la configuración de autenticación web respaldada por la base de datos antes de probar el inicio de sesión, los espacios de trabajo guardados o el chat. Si su objetivo es un simulador instalado, presione a en el terminal Expo para Android o i para iOS. iOS Simulator requiere macOS y Xcode; no puede ejecutarse en Windows.

corepack pnpm --filter @supastack/mobile start

5. Recupérese de errores de vista previa y pruebe flujos reales

Si Expo Go informa un proyecto incompatible, compare su SDK compatible con apps/mobile/package.json y use la versión compatible de la página oficial Expo. No actualice las versiones de dependencia del kit solo para descartar el mensaje. Si un módulo nativo requerido no está disponible, siga las compilaciones móviles para obtener una compilación de desarrollo que contenga ese módulo.

Si el inicio de sesión falla debido a un error de red, primero vuelva a intentar el backend URL en el navegador del teléfono. Si el URL funciona pero el inicio de sesión falla, inspeccione el terminal backend y verifique el Postgres y las migraciones. La sesión de demostración local/panel de control no le permite iniciar sesión en el teléfono. Si la configuración parece obsoleta, presione Ctrl + C en la terminal Expo, luego ejecute el comando de reinicio a continuación y vuelva a abrir la vista previa.

Expo Go no puede demostrar un comportamiento real de compra/restauración de StoreKit o Play Billing. Siga las compras dentro de la aplicación y las compilaciones móviles para obtener una compilación de desarrollo EAS y almacenar cuentas de prueba. Las compilaciones nativas por primera vez y el registro de cuentas pueden tardar más de cinco minutos. Para detener esta vista previa, presione Ctrl + C en la terminal Expo; detenga el backend por separado cuando haya terminado.

corepack pnpm --filter @supastack/mobile start --clear

Si quieres continuar la configuración, lee Autenticación nativa.