For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/web/onboarding.md (or send Accept: text/markdown).
Fluxo de onboarding
O caminho com gates do sign-up até a um workspace e plano ativos.
Antes de começar
Abra seu projeto supastack baixado em Visual Studio Code usando Arquivo → Abrir pasta e escolha Terminal → Novo Terminal. A raiz do repositório é a pasta que contém package.json, apps e pacotes. Execute o comando abaixo e deixe seu terminal aberto. Se um comando não for reconhecido, conclua o guia de instalação da ferramenta antes de continuar.
Leia o tutorial da plataforma primeiro. Um servidor é o processo do aplicativo que responde às solicitações do navegador ou do telefone. A Web lê apps/web/.env.local, Expo lê apps/mobile/.env.local e os comandos de migração de banco de dados leem root .env. A demonstração sem banco de dados/painel é separada das contas reais/auth, que precisam migrar para Postgres. Uma finalização de compra somente por telefone ou desktop precisa de um back-end da Web executado separadamente.
- Instale as ferramentas e obtenha o código
- Aprenda comandos, arquivos e configuração
- Conclua o tutorial inicial da Web
corepack pnpm --filter @supastack/web devInstalação e configuração
Depois do sign-up, os gates de onboarding conduzem o utilizador pela configuração do workspace antes do trabalho de produto: /onboarding, /new-organization, /select-organization e /choose-plan. O módulo de onboarding de organização decide qual o passo aplicável a partir do estado atual do membro.
O fluxo é retomável — cada gate volta a derivar o passo correto no servidor, por isso um utilizador que sai a meio aterra no ecrã certo quando regressa.
/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 hereFluxo de implementação
Trata cada passo como um gate, não como uma página de wizard — o servidor avalia o estado e redireciona para o próximo passo exigido. Membros convidados saltam a criação e aterram em accept-invite.
Ao adicionar um gate de produto — um campo de perfil obrigatório, uma aceitação de termos — estende a avaliação de onboarding em vez de espalhar redirects pelos layouts.
Verificação e resolução de problemas
Testa uma conta nova em cada passo, um utilizador que regressa a meio do fluxo, um membro convidado e um membro de várias organizações. Verifica que nenhum passo renderiza o shell da app antes de o seu gate passar.