Estructura del proyecto

Configuración y ajustes

Antes de cualquier paso, lea Antes de comenzar y Conceptos básicos del terminal. Estas instrucciones suponen que abrió el monorepo supastack completo en VS Code; su paquete raíz.json marca la raíz del repositorio. En los comandos pnpm, un paquete de espacio de trabajo es una aplicación o una carpeta de código compartido; En el producto, un espacio de trabajo es el contenedor de datos y el límite de seguridad de un equipo. corepack pnpm --filter ... selecciona un paquete del monorepo mientras los comandos se ejecutan desde su raíz. Si abrió solo una carpeta sincronizada para dispositivos móviles o de escritorio, no contiene el backend web, la configuración de Docker ni los scripts raíz: ejecute el backend desde este monorepo o un servidor alojado accesible y use los propios scripts de la carpeta de la plataforma. Una variable de entorno es una configuración con nombre almacenada en un archivo .env local o en su panel de hosting; reinicie la aplicación correspondiente después de cambiarla y mantenga los secretos del servidor fuera de los valores NEXT_PUBLIC_ y EXPO_PUBLIC_.

1. Abra el paquete raíz.json en VS Code, luego busque apps/web para ver el sitio web, apps/mobile para Expo, apps/desktop para el shell del escritorio y paquetes para piezas compartidas.

2. Desde la raíz del repositorio, ejecute corepack pnpm --filter @supastack/web dev.

3. Abra http://localhost:3000.. Se espera: la aplicación web se inicia desde apps/web mientras los paquetes compartidos permanecen en este mismo repositorio; la ventana del Escritorio envuelve esta aplicación web en lugar de contener un segundo producto.

El espacio de trabajo de pnpm contiene Next.js en apps/web, Expo en apps/mobile y paquetes compartidos en packages. Ejecuta los comandos del espacio de trabajo desde la raíz del repositorio. Las rutas de la aplicación combinan módulos compartidos; el comportamiento específico del producto pertenece al producto consumidor.

Lee AGENTS.md y .ai/PROJECT_CONTEXT.md antes de cambiar el comportamiento. Los archivos espejo de .ai/ explican decisiones y restricciones que quizá no resulten evidentes al revisar un componente aislado.

apps/web/app/       Routes and layouts
apps/web/src/       Web components and server composition
apps/mobile/        Expo application
packages/           Shared contracts and adapters
tests/              Cross-module and browser checks
docs/               Operational guides

Comandos para copiar

Siga los comentarios para ver en qué carpeta se ejecuta un comando. Si dos terminales están etiquetados, abra dos ventanas de terminal y mantenga el primer comando ejecutándose mientras usa el segundo.

corepack pnpm --filter @supastack/web dev

Dónde pertenece un cambio

Antes de editar, decide qué app o paquete es dueño del cambio. La regla general: si solo una superficie del producto lo necesita, ponlo en esa app; si lo necesita cada superficie, ponlo en un paquete compartido dentro de packages/.

El repositorio web y el monorepo All Platforms contienen todas las carpetas de abajo. Una entrega independiente de Mobile o Desktop contiene solo su propia app — el código del servidor permanece en el repositorio web.

• Construye tu primera funcionalidad

• Una página de marketing o landing nueva → apps/web/app/ — el sitio web público.
• Una pantalla nueva dentro del producto con sesión iniciada → apps/web/app/ para la ruta más apps/web/src/ para su lógica — las páginas componen los paquetes compartidos.
• Una ruta de API nueva → apps/web/app/api/ — la mitad de servidor de la app web.
• Un cambio que comparten todas las apps — una tabla de base de datos, un contrato, un adaptador de proveedor → la carpeta correspondiente en packages/.
• Una pantalla solo de teléfono → apps/mobile/ — habla con la API de la app web en lugar de tener su propio backend.
• Un comportamiento solo de escritorio → apps/desktop/ — el shell de Tauri envuelve la app web y casi nunca bifurca la UI del producto.

Flujo de implementación

Empieza por la ruta que controla la acción de la persona usuaria, sigue su controlador de servidor y luego inspecciona el paquete compartido al que llama. Un componente de interfaz no debería volver a implementar la resolución del espacio de trabajo, la autorización de facturación ni la selección de proveedores.

Al añadir una ruta, decide si será pública o requerirá autenticación. Resuelve la propiedad autenticada en el servidor antes de acceder a registros de usuarios y mantén las credenciales del servidor fuera de las importaciones del cliente.

Verificación y solución de problemas

Si el comando informa que ningún proyecto coincide con el filtro, verifique que el terminal esté en la carpeta que contiene el paquete raíz.json. Si el puerto 3000 ya está en uso, detenga primero el otro servidor web local. No busque una implementación de inicio de sesión o chat de escritorio independiente; el shell del escritorio carga el backend web.

Ejecuta las pruebas pertinentes y la comprobación de tipos después de cambiar el contrato de un paquete. Inspecciona los consumidores web y móvil cuando cambies tipos compartidos. Que la compilación web termine correctamente no demuestra compatibilidad con la aplicación nativa.