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/local-setup.md (or send Accept: text/markdown).
Instalação local
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 GitHub, instale Node.js 22 ou mais recente, Git, um editor e Corepack e, em seguida, clone seu repositório da Web ou o monorepo All Platforms. Abra a pasta suastack no editor e selecione Terminal → Novo Terminal. Você deverá ver 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, faturamento ou e-mail e sem Docker. Reserve tempo extra para downloads de dependências pela primeira vez. Siga apenas o bloco Windows ou apenas o bloco macOS/Linux nos próximos passos; não execute ambos.
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 install2. 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 install3. 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 dev4. 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.
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.
Para continuar a configuração, leia Configurar a base de dados.