Antes de empezar

1. Elige lo que quieres ejecutar

Use una computadora con Windows, macOS o Linux con conexión a Internet, más un teléfono o un simulador instalado para ver la aplicación. La computadora realiza cada paso de instalación a continuación; el teléfono solo muestra la vista previa terminada.

Un repositorio es la carpeta de archivos que recibió a través de GitHub. Una compra de Mobile proporciona el repositorio del kit Mobile; el paquete All Platforms proporciona el monorepo, una carpeta que contiene las tres aplicaciones. Acepte la invitación del repositorio que compró. El repositorio Mobile contiene la aplicación Expo y sus paquetes de UI compartidos, pero no el backend Web —el servidor que gestiona cuentas y datos—, por lo que la aplicación se conecta a un backend que se ejecuta por separado.

Prepare estas herramientas una vez. La descarga de herramientas y la primera compilación nativa puede llevar mucho más de cinco minutos. Las guías de cinco minutos comienzan después de estos preparativos; La ejecución local no publica su aplicación en Internet.

2. Instale Node.js

Abra la página de descarga oficial de Node.js a continuación. Elija una versión de LTS con el número 22 o superior y el instalador para su computadora: .msi en Windows o .pkg en macOS. Abra el instalador descargado, mantenga sus valores predeterminados y finalice la instalación. Node.js permite que su computadora ejecute JavaScript de la aplicación; npm se instala con él.

Cierra y vuelve a abrir tu terminal después de la instalación. En Windows, abra Inicio, escriba PowerShell y ábralo. En macOS, presione Comando + Espacio, escriba Terminal y presione Entrar. En Linux, abra Terminal desde el menú de aplicaciones. Pegue el siguiente comando y luego presione Entrar. Un resultado como v22.x.x o v24.x.x confirma que Node está disponible. Si ve un comando no encontrado o no reconocido, vuelva a abrir la terminal o reinstale Node con su opción PATH habilitada.

• Instaladores oficiales de Node.js

node --version
npm --version

3. Instale Git y un editor de texto.

Abra la página de descarga de Git a continuación, seleccione su sistema operativo y siga su instalador. Git descarga su repositorio privado y registra los cambios de archivos. En macOS, ejecutar el siguiente comando puede ofrecer la instalación de las herramientas de línea de comandos de Apple; acéptelo y vuelva a ejecutar el comando una vez que finalice. En Linux, utilice el comando de instalación que se muestra para su distribución en la página de Git.

Instale Visual Studio Code desde su página de descarga oficial. Este es un editor de texto para abrir el proyecto y guardar archivos de configuración. Ábrelo, elige Archivo → Abrir carpeta (Archivo → Abrir en macOS) y luego selecciona la carpeta supastack que descargas. No es necesario escribir código para completar la primera demostración local.

En una terminal recién abierta, ejecute el siguiente comando. Un resultado que comienza con la versión de git significa que Git está listo. Si falta el comando, finalice el instalador y vuelva a abrir la terminal.

• Instaladores oficiales de Git
• Descarga Visual Studio Code

git --version

4. Acepta tu invitación GitHub

Inicie sesión en GitHub en su navegador utilizando la cuenta que proporcionó al realizar la compra. Abra su correo electrónico de invitación GitHub, seleccione Ver invitación y acepte el acceso. Luego abra el repositorio invitado. Deberías ver sus archivos y un botón verde de Código. Un 404 generalmente significa que la invitación no ha sido aceptada o que ha iniciado sesión en una cuenta GitHub diferente.

Seleccione Código → Local → HTTPS y copie la dirección que se muestra. Utilice esa dirección exacta en el siguiente paso. Las direcciones de ejemplo que contienen corchetes angulares son plantillas: reemplácelas en lugar de pegar los corchetes. No es necesario adivinar el nombre de una organización ni hacer público el repositorio privado.

5. Descarga el proyecto a tu computadora.

Elija una carpeta para sus proyectos, como Documentos. Abra esa carpeta en el Explorador de archivos o Finder. En Windows, haga clic derecho en un área vacía y elija Abrir en Terminal, luego elija PowerShell si es necesario. En macOS, abra Terminal, escriba cd seguido de un espacio, arrastre la carpeta a la terminal y presione Entrar. La terminal ahora está funcionando en esa carpeta.

En el primer comando a continuación, reemplace YOUR_COPIED_HTTPS_ADDRESS con la dirección HTTPS que acaba de copiar. Ejecute una línea a la vez. La primera línea crea una nueva carpeta llamada supastack; la segunda línea entra en él. Si Git le pide que inicie sesión, complete el inicio de sesión del navegador. No utilice la contraseña de su cuenta GitHub como contraseña de Git. Si el inicio de sesión en el navegador no está disponible, siga la guía de autenticación HTTPS de GitHub vinculada a continuación.

Éxito: la carpeta supastack contiene package.json, pnpm-workspace.yaml, apps y packages. Un checkout de Mobile muestra solo la aplicación móvil dentro de apps; el monorepo All Platforms también muestra las aplicaciones web y desktop. Esta es la raíz del repositorio. Si Git indica que el destino ya existe, use otra carpeta vacía o abra el clon existente; no elimine su trabajo. Mantenga esta terminal abierta para el siguiente paso.

• Ayuda de autenticación GitHub HTTPS

git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack

6. Verifique Corepack y el administrador de paquetes anclado.

Ejecute el primer comando a continuación. Corepack selecciona la versión pnpm registrada en package.json; pnpm descarga las bibliotecas que utiliza el proyecto. Si Corepack solicita permiso para descargar esa versión, escriba y y presione Entrar. Esta caja fija pnpm 11.19.0; mantenga su pin en lugar de elegir un administrador de paquetes diferente.

Si falta el paquete principal, ejecute npm install --global corepack, vuelva a abrir su terminal y vuelva a intentarlo. Si PowerShell dice que no se puede ejecutar un script npm.ps1 o corepack.ps1, use npm.cmd o corepack.cmd para ese comando, incluido corepack.cmd pnpm install. No es necesario cambiar la política de ejecución de su computadora.

Los comandos filtrados de primera ejecución llaman directamente a Corepack. Si utiliza un comando Turbo como corepack pnpm dev, Turbo también necesita un comando pnpm en PATH. La siguiente configuración de Windows crea ese comando en una carpeta que el usuario puede escribir; su cambio PATH dura solo para el terminal actual. Ejecute este bloque nuevamente después de abrir una nueva terminal si falta pnpm. En macOS/Linux, ejecute corepack enable; si informa un error de permiso, utilice el comando filtrado de primera ejecución.

• Aprenda a ejecutar un comando y editar un archivo

corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"

7. Continuar con las guías de Mobile

Está listo cuando Node y Git imprimen versiones, Corepack puede seleccionar el pnpm fijado y su terminal está en la carpeta que contiene package.json. Elija un tutorial a continuación. Expo Go en su teléfono es suficiente para la primera vista previa; las compilaciones nativas y las cuentas de tienda llegan en las guías posteriores.

• Deje que un agente ejecute la configuración por usted
• Ejecute la aplicación móvil
• Conozca la pila tecnológica de Mobile