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/deployment.md (or send Accept: text/markdown).
Checklist de deployment
Prepara as dependências de produção e verifica o fluxo que pretendes entregar.
Prepare um aplicativo público nesta ordem
Implantação significa executar seu aplicativo em um serviço de hospedagem para que outras pessoas possam visitá-lo. localhost é acessível apenas em seu ambiente de desenvolvimento. Primeiro, conclua o login localmente baseado em banco de dados real, escolha um guia de hospedagem abaixo, crie um banco de dados de teste separado e defina as configurações do ambiente do host com o aplicativo HTTPS público real URL. Mantenha as configurações de demonstração locais separadas do aplicativo público.
Em um segundo terminal na raiz do repositório, execute as verificações da Web abaixo. Uma compilação bem-sucedida cria uma versão de produção em seu computador; ele não carrega nem publica. Não confunda corepack pnpm --filter @supastack/web start com implantação: start executa a versão anteriormente construída localmente. Execute-o somente após parar o servidor de desenvolvimento na porta 3000.
Siga o guia do host escolhido para as etapas de migração, ambiente e lançamento. Inscrição de teste, um código de e-mail, dados de conta salvos após uma reinicialização e um recurso pago na sandbox do provedor antes de abrir as vendas. Um cliente móvel ou desktop deve apontar para este back-end HTTPS em execução. O lançamento de um aplicativo nativo é uma etapa separada, documentada no guia de distribuição da plataforma.
- Implementar no Google Cloud
- Implantar em um servidor com Coolify
- Preparar login baseado em banco de dados
corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web buildPrepara os serviços
Crie o banco de dados Postgres, aplique as migrações do repositório e insira seu aplicativo público URL e configurações de autenticação no painel de hospedagem. Escolha um provedor de faturamento da Web compatível e um provedor de e-mail transacional para os recursos habilitados. Configure Trigger.dev quando seu produto usar fluxos de trabalho em segundo plano; você não precisa de todas as integrações para publicar um aplicativo básico.
Configura o catálogo imutável de modelos/preços e a política de IA do workspace antes de aceitar tarefas de IA de produção. Uma política de aliases vazia deve deixar essas escolhas indisponíveis.
Constrói e faz deploy da app web
Execute os comandos da Web abaixo na raiz do repositório e resolva qualquer erro antes de continuar. typecheck verifica os tipos, test executa os testes da Web e build cria arquivos de produção localmente. Siga o guia de hospedagem selecionado para carregá-los e executá-los com as configurações do ambiente do servidor. Esses comandos não implantam o aplicativo.
corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web test
corepack pnpm --filter @supastack/web buildVerifica as fronteiras deployed
Verifica login e persistência na base deployed; testa isolamento de workspace; confirma o processamento de webhooks Stripe sandbox e alterações de permissões; e executa uma tarefa em segundo plano até ao resultado persistido e entrega transacional.
Lê docs/real-provider-smoke.md e docs/production-ai-runtime.md no repo para o processo explícito de aceitação de fornecedores. Um build bem-sucedido ou um teste de browser interceptado não estabelece esses resultados externos.