Flujo de onboarding

Antes de comenzar

Abra su proyecto supastack descargado en Visual Studio Code usando Archivo → Abrir carpeta, luego elija Terminal → Nueva terminal. La raíz del repositorio es la carpeta que contiene package.json, aplicaciones y paquetes. Ejecute el comando a continuación y deje su terminal abierta. Si no se reconoce un comando, finalice la guía de instalación de la herramienta antes de continuar.

Lea primero el tutorial de la plataforma. Un servidor es el proceso de la aplicación que responde a las solicitudes del navegador o del teléfono. La web lee apps/web-tanstack/.env.local, Expo lee apps/mobile/.env.local y los comandos de migración de bases de datos leen el .env de la raíz. La demostración de /dashboard sin base de datos es independiente de las cuentas reales de /auth, que necesitan Postgres migrado. Una entrega solo de teléfono o de escritorio necesita un backend web que se ejecute por separado.

• Instale las herramientas y obtenga el código
• Aprender comandos, archivos y configuración
• Completa el tutorial web de primera ejecución

corepack pnpm --filter @supastack/web-tanstack dev

Configuración y ajustes

Tras el registro, los gates de onboarding guían al usuario por la configuración del workspace antes del trabajo de producto: /onboarding, /new-organization, /select-organization y /choose-plan. El módulo organization-onboarding decide qué paso aplica según el estado actual del miembro.

El flujo es reanudable — cada gate rederiva el paso correcto en el servidor, así un usuario que se va a mitad de camino aterriza en la pantalla correcta al volver.

/onboarding            entry gate
/new-organization     create a team workspace
/select-organization  pick an existing one
/choose-plan          plan selection before billing
/invite/[token]       invited members join here

Flujo de implementación

Trata cada paso como un gate, no como una página de asistente — el servidor evalúa el estado y redirige al siguiente paso requerido. Los miembros invitados saltan la creación y aterrizan en accept-invite.

Al añadir un gate de producto — un campo de perfil obligatorio, una aceptación de términos — extiende la evaluación de onboarding en lugar de esparcir redirecciones por los layouts.

Verificación y solución de problemas

Prueba una cuenta nueva a través de cada paso, un usuario que vuelve a mitad de flujo, un miembro invitado y un miembro de varias organizaciones. Verifica que ningún paso renderice el shell de la app antes de superar su gate.