Descripción general de escritorio

Guía paso a paso para principiantes

Requisitos previos: lea las dos guías para principiantes que aparecen a continuación y finalice la configuración local del escritorio, incluidos Rust y los requisitos previos del sistema operativo. El bloque de código inicia tanto la aplicación web como Tauri en el monorepo; en un pago solo de escritorio, use su comando filtrado solo después de iniciar un backend web accesible por separado. Tauri carga ese backend.

Términos breves: un espacio de trabajo son los usuarios, datos y configuraciones separados de un equipo. El servidor es el backend confiable; Mantenga las claves del proveedor fuera del código del navegador y del teléfono. Una migración es un cambio de base de datos versionada que crea o actualiza tablas. Un modelo de IA es el motor que responde; el catálogo de modelos es la lista del servidor de ID de modelos disponibles y precios. Un proveedor es un servicio externo, como inteligencia artificial, correo electrónico o servicio de facturación. Un derecho es una concesión que permite que un espacio de trabajo utilice una función. Un webhook es un mensaje que un servicio envía al URL de otro servicio.

1. Siga la configuración local del escritorio, luego abra la aplicación en la ventana Tauri e inicie sesión en la misma cuenta web que usa en un navegador.

2. Visite la página de un espacio de trabajo, oculte/muestre la ventana desde la bandeja y pruebe el acceso directo de invocación.

3. La pantalla debe coincidir con la aplicación web porque Tauri carga el backend configurado. Si está en blanco, confirme que SUPASTACK_APP_URL apunta a una aplicación web en ejecución accesible.

Para obtener código personalizado, comience con el prompts/README.md proporcionado y copie el mensaje más cercano: prompts/new-app-screen.md para una pantalla de aplicación o prompts/new-landing-page.md para una página pública. Para trabajos de servidor, base de datos o proveedor, asigne a su agente de codificación la tarea de esta guía y pídale que lea AGENTS.md, .ai/PROJECT_CONTEXT.md y los espejos .ai/ correspondientes; inspeccionar los archivos fuente exactos nombrados aquí; enumerar archivos y verificaciones antes de editarlos; preservar la propiedad del espacio de trabajo y los secretos exclusivos del servidor; y mostrarte la diferencia. Dígale el comportamiento que desea, los campos de entrada y salida, los roles permitidos, los éxitos y errores esperados y la cuenta, proveedor o dispositivo de prueba. Utilice valores de muestra; Nunca pegues un verdadero secreto.

• Antes de comenzar
• Conceptos básicos de terminales
• Configuración local de escritorio
• Mensajes del agente y memoria del proyecto

# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop

# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop dev

Una interfaz de producto, un shell nativo

apps/desktop es un webview Tauri sobre tu aplicación web. Comparte con la web la interfaz, la autenticación y el chat del producto; el comportamiento de ventana/bandeja nativas está en src-tauri/src/lib.rs. Necesita un backend web accesible y no incluye una interfaz de producto independiente.

Usa las funciones del shell nativo

El shell incluye un menú de bandeja, cerrar a la bandeja, foco de instancia única, tecla global de invocación, menús de navegación/vista nativos, enlaces externos en el navegador del sistema, invocación mediante enlace profundo supastack://, estado de ventana recordado y una capa de reintento sin conexión.

SUPASTACK_APP_URL elige el backend: primero el valor válido en tiempo de ejecución, luego el de compilación y después localhost. SUPASTACK_DESKTOP_HOTKEY reemplaza CmdOrCtrl+Shift+Space. Las compilaciones de lanzamiento firmadas inyectan SUPASTACK_UPDATER_ENDPOINT y SUPASTACK_UPDATER_PUBKEY; cuando la ruta del endpoint contiene {{channel}}, el menú de la aplicación habilita Beta Updates (stable frente a beta, reemplazable en tiempo de ejecución con SUPASTACK_UPDATE_CHANNEL).

Elige la ruta de escritorio

Ejecuta web y escritorio juntos durante el desarrollo local y luego compila y verifica el destino nativo con sus requisitos de plataforma. La firma de tienda, los instaladores y el comportamiento de escritorio físico requieren una aceptación independiente.

• Configure el escritorio Tauri en 5 minutos
• Comportamiento de ventanas, bandejas y teclas de acceso rápido
• Compilaciones y distribución de escritorio

Un shell webview, no una segunda app

apps/desktop es un shell de Tauri 2.x. El núcleo Rust en src-tauri posee la ventana, la bandeja del sistema y el atajo global, mientras una webview carga la aplicación web. Interfaz, autenticación, billing y AI vienen del mismo codebase de Next.js — la superficie de escritorio añade presencia, no un producto paralelo.

El shell incluye una página placeholder en apps/desktop/ui que se muestra mientras carga la aplicación web, así un arranque en frío nunca renderiza una ventana vacía.

Apuntar el shell a un despliegue

El destino de la ventana se resuelve en orden: la variable de entorno SUPASTACK_APP_URL en tiempo de ejecución, luego el valor de SUPASTACK_APP_URL fijado en compilación y por último http://localhost:3000. Solo se aceptan URL http y https — los valores vacíos o no web caen al siguiente candidato.

Para el desarrollo, esto significa que el caparazón se adhiere a cualquier cosa que sirva corepack pnpm dev. Para producción, configure la variable en el momento de la compilación para que se hornee en su aplicación web implementada.

Mantener los secretos en el servidor

El shell no lleva credenciales de proveedores. La webview habla con la misma superficie de API autenticada que usa un navegador, así que claves de proveedores, secretos de sesión y configuración de billing permanecen en el servidor.

El identificador de bundle com.supastack.desktop y el conjunto de capabilities por defecto (core:default) mantienen la webview en sandbox; amplía los permisos en src-tauri/capabilities solo cuando una función nativa lo necesite.