Parcours d'onboarding

Avant de commencer

Ouvrez votre projet supastack téléchargé dans Visual Studio Code en utilisant Fichier → Ouvrir le dossier, puis choisissez Terminal → Nouveau terminal. La racine du référentiel est le dossier contenant package.json, les applications et les packages. Exécutez la commande ci-dessous et laissez son terminal ouvert. Si une commande n'est pas reconnue, terminez le guide d'installation de l'outil avant de continuer.

Lisez d’abord le didacticiel de la plateforme. Un serveur est le processus d'application qui répond aux requêtes du navigateur ou du téléphone. Le Web lit apps/web-tanstack/.env.local, Expo lit apps/mobile/.env.local et les commandes de migration de base de données lisent root .env. La démonstration sans base de données/tableau de bord est distincte des comptes réels/auth, qui nécessitent une migration Postgres. Un paiement sur téléphone ou sur ordinateur uniquement nécessite un backend Web exécuté séparément.

• Installez les outils et récupérez le code
• Apprendre les commandes, les fichiers et la configuration
• Terminez le didacticiel Web de première exécution

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

Configuration et paramètres

Après l'inscription, les gates d'onboarding guident l'utilisateur à travers la mise en place du workspace avant le travail produit : /onboarding, /new-organization, /select-organization et /choose-plan. Le module organization-onboarding décide de l'étape applicable d'après l'état courant du membre.

Le parcours est reprenable — chaque gate re-dérive la bonne étape côté serveur, donc un utilisateur parti en cours de route retombe sur le bon écran à son retour.

/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

Processus d’implémentation

Traitez chaque étape comme un gate, pas comme une page de wizard — le serveur évalue l'état et redirige vers la prochaine étape requise. Les membres invités sautent la création et atterrissent sur accept-invite.

Pour ajouter un gate produit — un champ de profil obligatoire, une acceptation de conditions — étendez l'évaluation d'onboarding plutôt que de disperser des redirections dans les layouts.

Vérification et dépannage

Testez un compte neuf à travers chaque étape, un utilisateur revenant en cours de flux, un membre invité et un membre de plusieurs organisations. Vérifiez qu'aucune étape ne rend le shell applicatif avant que son gate ne passe.