> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 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](https://supastack.dev/pt/docs/web/before-you-start.md)

[Aprenda comandos, arquivos e configuração](https://supastack.dev/pt/docs/web/terminal-basics.md)

[Conclua o tutorial inicial da Web](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md)

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


## Instalaçã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 here
```


## Fluxo 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.


## Seguinte

[Pagamentos e subscrições](https://supastack.dev/pt/docs/web/billing.md)