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/external-accounts.md (or send Accept: text/markdown).
Crie suas contas externas
A checklist mestre: quais serviços externos o kit pode usar, o que cada um oferece e em que ordem criá-los.
Você pode construir antes de comprar
Cada recurso deste kit funciona primeiro com um substituto local — um adaptador incorporado que imita o serviço real sem conta. EMAIL_PROVIDER=local escreve as mensagens numa página de pré-visualização em vez de enviá-las, AI_PROVIDER=fake devolve uma resposta falsa determinista, BILLING_PROVIDER=local completa o checkout sem um fornecedor de pagamentos, JOB_PROVIDER=local enfileira trabalhos em segundo plano na memória sem executá-los, e CAPTCHA_PROVIDER=off mantém os formulários públicos abertos. A configuração .env.example já vem assim — o tutorial de cinco minutos não precisa de nenhuma conta paga.
Crie uma conta externa real apenas quando lançar o recurso que ela alimenta: um banco de dados antes do login real, um provedor de e-mail antes de as mensagens precisarem chegar a caixas de entrada reais, um fornecedor de faturação antes de cobrar dinheiro. Cada guia abaixo indica a página da consola, os valores a copiar e onde colá-los.
A checklist completa de contas
Esta tabela lista cada serviço externo de que um produto supastack pode precisar. Ignore qualquer linha cujo recurso você não está lançando — um starter só web nunca toca nas linhas de mobile e desktop. A coluna Guia indica o documento que percorre essa consola passo a passo; os links reais estão em «Por onde começar» no fim desta página.
| Serviço | O que oferece | Necessário para | Guia |
|---|---|---|---|
| Banco de dados Postgres (Supabase, Neon ou Docker) | Tabelas para contas, workspaces e dados | Login real e dados guardados | Configurar a base de dados |
| Stripe | Pagamentos com cartão e assinaturas na web | Cobrar dinheiro na app web | Adicionar os pagamentos com Stripe |
| Resend ou Amazon SES | Envio de e-mail transacional | Códigos de acesso e recibos em caixas de entrada reais | Adicionar o email com Resend / Configurar e-mail do Amazon SES |
| Cliente OAuth do Google Cloud | O botão Continuar com Google | Oferecer início de sessão com Google | Adicionar o início de sessão com Google |
| OAuth App do GitHub | O botão Continuar com GitHub | Oferecer início de sessão com GitHub | Adicionar o início de sessão com GitHub |
| Chave de provedor de IA (OpenAI, Anthropic ou OpenRouter) | Respostas reais do modelo | Tarefas de IA reais em vez do adaptador falso | Recolher as chaves de provedor restantes |
| Trigger.dev | Execuções geridas de trabalhos em segundo plano | Trabalho em segundo plano em produção | Recolher as chaves de provedor restantes |
| Bucket compatível com S3 (ex.: Cloudflare R2) | Armazenamento de ficheiros e objetos | Uploads e ficheiros guardados | Recolher as chaves de provedor restantes |
| Sentry ou PostHog | Rastreio de erros e analítica de produto | Observabilidade em produção | Recolher as chaves de provedor restantes |
| Cloudflare Turnstile | Controlos antispam em formulários públicos | Formulários públicos de registo e contacto | Recolher as chaves de provedor restantes |
| Registrador de domínio + DNS | O seu próprio nome de domínio | Um endereço público https://yourdomain.com | Recolher as chaves de provedor restantes / Implementar no Google Cloud |
| Hospedagem (Google Cloud Run ou um VPS + Coolify) | Um URL HTTPS público para a app web | Entrar em produção para utilizadores reais | Implementar no Google Cloud / Checklist de deployment |
| Expo + EAS | Builds na nuvem da app nativa | Tudo além da pré-visualização do Expo Go | Criar as contas mobile |
| Programa Apple Developer | Assinatura iOS, submissão à App Store, Sign in with Apple | Lançamentos para iPhone e início de sessão com Apple | Criar as contas mobile / Adicionar o início de sessão com Apple |
| Google Play Console | A ficha da loja Android | Submissão à Play Store | Criar as contas mobile |
| RevenueCat | Compras nativas verificadas e restaurações | Vender assinaturas dentro da app | Configurar as compras da RevenueCat |
| Developer ID Apple + AC de assinatura | Instaladores de desktop assinados e notarizados | Lançamentos públicos de desktop sem avisos | Criar as contas de lançamento de desktop |
Uma ordem de criação sensata
Crie as contas na ordem em que os recursos entram no ar. Para a maioria dos produtos web isso significa: 1. banco de dados Postgres, 2. e-mail transacional, 3. início de sessão com Google e/ou GitHub, 4. faturação, 5. um provedor de IA — depois armazenamento, trabalhos em segundo plano, observabilidade e proteção antispam conforme o produto precisar.
Hospedagem e domínio vêm por último — um URL público só serve quando existe uma app funcional a que apontá-lo. As contas mobile (Expo, Apple, Google Play, RevenueCat) e as contas de assinatura de desktop só importam quando chega a essas plataformas; ignore-as por completo num lançamento só web.
Guarde cada segredo — segredos de cliente OAuth, chaves de API, segredos de assinatura de webhooks e a palavra-passe dentro de DATABASE_URL — em ficheiros .env.local ou no gestor de segredos do seu host. Nunca os coloque em variáveis NEXT_PUBLIC_ ou EXPO_PUBLIC_ nem os envie para o Git.
Por onde começar
Os guias detalhados abaixo percorrem cada consola passo a passo. Trabalhe de cima para baixo: os provedores de início de sessão, depois os percursos de contas para pagamentos, email e as chaves de provedor restantes, depois as referências de configuração dos serviços que o seu produto lança, depois a implementação; os guias de contas de plataforma quando chegar a mobile ou desktop.
- Adicionar o início de sessão com Google
- Adicionar o início de sessão com GitHub
- Adicionar o início de sessão com Apple
- Adicionar os pagamentos com Stripe
- Adicionar o email com Resend
- Recolher as chaves de provedor restantes
- Configurar a base de dados
- Configurar pagamentos
- Configurar email
- Configurar login OAuth
- Configurar IA
- Configurar jobs em segundo plano
- Configurar o armazenamento de ficheiros
- Configurar a observabilidade
- Proteção anti-spam
- Configurar domínios personalizados
- Implementar no Google Cloud
- Checklist de deployment
- Criar as contas mobile
- Criar as contas de lançamento de desktop
- Configuração EAS
- Configurar as compras da RevenueCat
- Assinatura de código
Para continuar a configuração, leia Adicionar o início de sessão com Google.