Pular para o conteúdo
supastack
Explorar a documentação
WebTanStack Start

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/tanstack/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-tanstack 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.

corepack pnpm --filter @supastack/web-tanstack typecheck
corepack pnpm --filter @supastack/web-tanstack build

Prepara 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-tanstack typecheck
corepack pnpm --filter @supastack/web-tanstack test
corepack pnpm --filter @supastack/web-tanstack build

Verifica 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.