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/web/before-you-start.md (or send Accept: text/markdown).
Antes de empezar
Instale Node.js, Git y un editor, acepte la invitación de su repositorio, descargue el kit y verifique que su computadora esté lista para la primera ejecución.
1. Elige lo que quieres ejecutar
Utilice una computadora con Windows, macOS o Linux con conexión a Internet. Un navegador ejecuta la aplicación web; un teléfono ejecuta la aplicación móvil; la aplicación de escritorio se abre en su propia ventana. Su teléfono por sí solo no puede realizar los pasos de instalación a continuación.
Un repositorio es la carpeta de archivos que recibió a través de GitHub. Las compras web, móviles y de escritorio proporcionan cada una el repositorio de kits correspondiente; el paquete Todas las plataformas proporciona monorepo, una carpeta que contiene las tres aplicaciones. Acepta la invitación para el repositorio que compraste. Una caja móvil o de escritorio aún necesita un servidor web accesible: el servidor que maneja las cuentas y los datos. Esos repositorios de clientes no incluyen el servidor web.
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.
node --version
npm --version3. 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.
git --version4. 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 paquete.json, pnpm-workspace.yaml, aplicaciones y paquetes. Esta es la raíz del repositorio. Si Git dice que el destino ya existe, use una carpeta vacía diferente o abra el clon existente; No borres tu trabajo. Mantenga esta terminal abierta para el siguiente paso.
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. 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.
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. Continúa con tu plataforma
Está listo cuando Node y Git imprimen las versiones, Corepack puede seleccionar el pnpm anclado y su terminal está en la carpeta que contiene package.json. Elija uno de los tutoriales a continuación. Docker es opcional para la demostración web; Posteriormente se requiere una base de datos para cuentas reales. El escritorio también necesita Rust y herramientas de compilación nativas, que su tutorial explica antes de su comando de inicio.