Antes de empezar

1. Elige lo que quieres ejecutar

Use una computadora con Windows, macOS o Linux con conexión a Internet. La aplicación Desktop es una ventana nativa instalada en esta misma computadora: no interviene ningún teléfono. Los pasos a continuación instalan sus herramientas y descargan el proyecto.

Un repositorio es la carpeta de archivos que recibió a través de GitHub. Una compra de Desktop proporciona el repositorio del kit Desktop; el paquete All Platforms proporciona el monorepo, una carpeta que contiene las tres aplicaciones. Acepte la invitación del repositorio que compró. El repositorio Desktop contiene el shell de Tauri —la ventana nativa alrededor de su aplicación web—, pero no el backend Web, por lo que la ventana se conecta a una dirección de 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 Desktop muestra solo el shell de escritorio dentro de apps; el monorepo All Platforms también muestra las aplicaciones web y móvil. 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. Instale Rust y las herramientas de compilación nativas

En Windows, instale Microsoft C++ Build Tools utilizando el enlace de requisitos previos de Tauri que aparece a continuación. En su instalador seleccione Desarrollo de escritorio con C++, mantenga seleccionado Windows SDK y complete la instalación. Asegúrese de que Microsoft Edge WebView2 Runtime esté instalado. Instale Rust desde Rustup.rs usando Rustup-init.exe; mantenga la cadena de herramientas MSVC predeterminada. Vuelva a abrir su terminal después de la instalación.

En macOS, ejecute xcode-select --install en Terminal y complete el cuadro de diálogo de herramientas de línea de comandos si no están instaladas. Instale Rust usando el comando macOS de Rustup.rs. En Linux, siga la página de requisitos previos Tauri para los paquetes WebKitGTK, compilador, bandeja y biblioteca del sistema de su distribución exacta, luego instale Rust. Los nombres de los paquetes de Linux varían; no ejecute los comandos de otra distribución.

Abra una terminal en la raíz del repositorio y ejecute las comprobaciones de versión a continuación. Tanto rustc como cargo deben imprimir versiones; cargo es la herramienta de construcción de Rust. Si falta alguno de ellos, finalice la instalación y vuelva a abrir el terminal antes de continuar.

• Lista de verificación de requisitos previos del sistema operativo de Tauri
• Instalador oficial de Rust

rustc --version
cargo --version

8. Continuar con las guías de Desktop

Está listo cuando Node y Git imprimen versiones, Corepack puede seleccionar el pnpm fijado, rustc y cargo imprimen versiones y su terminal está en la carpeta que contiene package.json. Elija un tutorial a continuación.

• Deje que un agente ejecute la configuración por usted
• Ejecute la aplicación de escritorio
• Conozca la pila tecnológica de Desktop