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

# Lança em 5 minutos

Execute a demonstração da Web em seu computador com comandos exatos do Windows e macOS, sem credenciais de provedor pagas e um caminho claro para contas reais baseadas em banco de dados.

## 1. Prepare seu computador e abra o projeto

Primeiro conclua Antes de começar: aceite o convite do GitHub, instale o Node.js 22 ou mais recente, o Git, um editor e o Corepack e, em seguida, clone o seu repositório Web ou o monorepo All Platforms. Abra a pasta supastack no editor e selecione Terminal → New Terminal. Você deverá ver o package.json na lista de arquivos de nível superior do editor. Todos os comandos abaixo são executados a partir da raiz deste repositório.

Isso inicia a demonstração local sem contas em provedores de IA, cobrança ou e-mail e sem Docker. Reserve tempo extra para o primeiro download das dependências. Siga apenas o bloco Windows ou apenas o bloco macOS/Linux nos próximos passos; não execute os dois.

[Instale as ferramentas e obtenha o código](https://supastack.dev/pt/docs/web/before-you-start.md)

[Aprenda como executar um comando e editar um arquivo](https://supastack.dev/pt/docs/web/terminal-basics.md)

[Ou deixe um agente executar a configuração por você](https://supastack.dev/pt/docs/web/agent-setup.md)


## 2. Crie arquivos de configuração — macOS/Linux

No seu terminal, execute cada linha abaixo. A primeira cópia cria .env para comandos de migração posteriores. O segundo cria apps/web/.env.local, que o servidor Web realmente lê. Ambos contêm as configurações locais do exemplo. Se algum dos arquivos de destino já existir, mantenha-o e ignore o comando de cópia; não substitua as configurações salvas. Os usuários do Windows usam a próxima seção.

corepack pnpm install baixa as bibliotecas que o aplicativo precisa. Se Corepack solicitar o download de pnpm, responda y. Espere até que termine e o prompt do terminal retorne. Uma mensagem Done final sem erro significa que você pode continuar.

```
cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install
```


## 2. Crie arquivos de configuração — Windows PowerShell

Use estes comandos em PowerShell da pasta que contém package.json. Se .env ou apps/web/.env.local já existir, pule a linha de cópia e mantenha suas configurações. Aguarde a conclusão da instalação antes de iniciar o servidor. Se a execução do script estiver bloqueada, use corepack.cmd em vez de corepack conforme explicado em Antes de começar.

```
Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install
```


## 3. Inicie o servidor Web – deixe este terminal aberto

Execute o comando abaixo na raiz do repositório. Ele inicia apenas o aplicativo Web, portanto funciona tanto no repositório somente Web quanto no monorepo Todas as plataformas. Aguarde até que o terminal mostre Local: http://localhost:3000 e Ready. A primeira página pode demorar um pouco mais para ser compilada. O terminal deve continuar funcionando; isso é esperado.

No monorepo Todas as plataformas, corepack pnpm dev inicia os espaços de trabalho de desenvolvimento disponíveis juntos. Se apps/docs estiver presente, esse aplicativo de documentos separado usa http://localhost:3001.. Os guias públicos que você está lendo fazem parte do aplicativo Web em http://localhost:3000/docs. Você não precisa da porta 3001 para seguir este tutorial.

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


## 4. Abra o aplicativo e conclua uma tarefa local

Na barra de endereço do seu navegador, abra http://localhost:3000 para ver a página inicial. Em seguida, abra http://localhost:3000/dashboard.. Mantenha o nome e e-mail pré-preenchidos ou insira seus próprios valores de teste e clique em Start local reference flow. Isso cria um espaço de trabalho de demonstração na memória; ele não cria uma conta persistente nem envia um e-mail real.

Na demonstração, abra AI task na barra lateral, insira uma solicitação curta como Resumir os critérios de aceitação locais e clique em Queue local task. Quando seu status estiver na fila, clique em Run local task e depois em View result. Você deverá ver a saída concluída e um estado Email queued. A resposta da IA ​​é deliberadamente falsa e repetível; o email na fila é local. Reiniciar o servidor limpa esses dados de demonstração.

Para usar /auth para inscrição real, primeiro inicie Postgres e aplique migrações usando o guia de banco de dados e migrações. Depois disso, as mensagens de inscrição ou OTP de EMAIL_PROVIDER=local podem ser inspecionadas em http://localhost:3000/mail-preview;, pois não chegam a uma caixa de entrada externa. O login móvel também usa essa autenticação baseada em banco de dados, em vez da sessão de demonstração.

[Adicionar Postgres e contas persistentes](https://supastack.dev/pt/docs/web/database.md)


## 5. Pare, reinicie e corrija problemas comuns na primeira execução

Sucesso significa que a página inicial é carregada, o espaço de trabalho local é aberto e uma tarefa na fila é concluída. Ao terminar, clique no terminal do servidor e pressione Ctrl + C. Para continuar mais tarde, reabra um terminal na raiz do repositório e repita o comando do servidor do passo 3; você não reinstala dependências todas as vezes.

Se localhost:3000 não abrir, verifique se o terminal do servidor ainda está em execução e mostra Ready. Se a porta 3000 estiver em uso, pare o outro servidor de desenvolvimento com Ctrl + C e tente novamente. Se você vir um erro de banco de dados após abrir /auth, retorne para /dashboard para ver a demonstração ou conclua o guia do banco de dados. Se a demonstração local estiver faltando, verifique APP_ENV=local, AI_PROVIDER=fake, BILLING_PROVIDER=local, EMAIL_PROVIDER=local e JOB_PROVIDER=local em apps/web/.env.local e reinicie.

Para personalizar o nome e o texto de marketing, abra apps/web/src/marketing/site-config.ts no editor. Siga Branding para os campos exatos e etapas de verificação. Para as configurações de aparência da conta real, conclua primeiro a configuração do banco de dados e depois abra /settings/appearance. Os comandos de aceitação automatizados demoram mais do que este passo a passo da primeira execução; encontre-os em Comandos do espaço de trabalho.

[Corrigir um erro na primeira execução](https://supastack.dev/pt/docs/web/troubleshooting.md)

[Altere o nome e a cópia do seu produto](https://supastack.dev/pt/docs/web/marketing-site.md)


Para continuar a configuração, leia [Configurar a base de dados](https://supastack.dev/pt/docs/web/setup-database.md).


## Seguinte

[Stack tecnológica](https://supastack.dev/pt/docs/web/tech-stack.md)