Pular para o conteúdo
supastack
Explorar a documentação
WebNext.js

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/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çoO que ofereceNecessário paraGuia
Banco de dados Postgres (Supabase, Neon ou Docker)Tabelas para contas, workspaces e dadosLogin real e dados guardadosConfigurar a base de dados
StripePagamentos com cartão e assinaturas na webCobrar dinheiro na app webAdicionar os pagamentos com Stripe
Resend ou Amazon SESEnvio de e-mail transacionalCódigos de acesso e recibos em caixas de entrada reaisAdicionar o email com Resend / Configurar e-mail do Amazon SES
Cliente OAuth do Google CloudO botão Continuar com GoogleOferecer início de sessão com GoogleAdicionar o início de sessão com Google
OAuth App do GitHubO botão Continuar com GitHubOferecer início de sessão com GitHubAdicionar o início de sessão com GitHub
Chave de provedor de IA (OpenAI, Anthropic ou OpenRouter)Respostas reais do modeloTarefas de IA reais em vez do adaptador falsoRecolher as chaves de provedor restantes
Trigger.devExecuções geridas de trabalhos em segundo planoTrabalho em segundo plano em produçãoRecolher as chaves de provedor restantes
Bucket compatível com S3 (ex.: Cloudflare R2)Armazenamento de ficheiros e objetosUploads e ficheiros guardadosRecolher as chaves de provedor restantes
Sentry ou PostHogRastreio de erros e analítica de produtoObservabilidade em produçãoRecolher as chaves de provedor restantes
Cloudflare TurnstileControlos antispam em formulários públicosFormulários públicos de registo e contactoRecolher as chaves de provedor restantes
Registrador de domínio + DNSO seu próprio nome de domínioUm endereço público https://yourdomain.comRecolher 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 webEntrar em produção para utilizadores reaisImplementar no Google Cloud / Checklist de deployment
Expo + EASBuilds na nuvem da app nativaTudo além da pré-visualização do Expo GoCriar as contas mobile
Programa Apple DeveloperAssinatura iOS, submissão à App Store, Sign in with AppleLançamentos para iPhone e início de sessão com AppleCriar as contas mobile / Adicionar o início de sessão com Apple
Google Play ConsoleA ficha da loja AndroidSubmissão à Play StoreCriar as contas mobile
RevenueCatCompras nativas verificadas e restauraçõesVender assinaturas dentro da appConfigurar as compras da RevenueCat
Developer ID Apple + AC de assinaturaInstaladores de desktop assinados e notarizadosLançamentos públicos de desktop sem avisosCriar 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.

Para continuar a configuração, leia Adicionar o início de sessão com Google.

Perguntas frequentes

14 perguntas

O que é o supastack?

O supastack é uma base modular para construir produtos SaaS com IA. Reúne a infraestrutura comum para que possas concentrar-te nas funcionalidades próprias do teu produto.

Suporta web e mobile?

Sim. O supastack inclui apps Next.js e Expo como pontos de partida para experiências web e mobile.

Que autenticação está incluída?

O Better Auth cobre email/palavra-passe, OTP e login social. Os workspaces pessoais são aprovisionados com a conta para que os registos fiquem delimitados desde o primeiro dia.

Como é suportada a IA?

O supastack inclui IA multi-fornecedor configurável, registo de utilização, orçamentos e suporte encriptado de chaves próprias (BYOK).

Como são geridas as subscrições?

Para produtos construídos sobre o kit, a faturação Stripe, as subscrições e as permissões formam a base do acesso pago. Os segredos de fornecedor ficam no servidor.

Onde vive o código próprio do meu produto?

As funcionalidades próprias do produto ficam num codebase separado, enquanto o produto configura e integra os módulos base do supastack.

Como funciona o preço do supastack?

O kit é uma compra única com atualizações vitalícias: Uma framework por 249 $ (preço de lançamento temporário — 100 $ de desconto sobre o preço normal de 349 $) ou Todas as frameworks (Next.js, iOS, Android) por 499 $ (preço de lançamento temporário — 100 $ de desconto sobre o preço normal de 599 $), mais 75 $ por lugar de programador adicional. Sem subscrição do kit. O checkout neste site entrega a tua chave de licença por email, com acesso ao repo por convite GitHub.

Como é que os workspaces delimitam os meus dados?

Os registos do utilizador são delimitados por workspaceId. Identidade, permissões, utilização de IA, eventos de faturação e entradas de auditoria ficam dentro do limite do workspace pessoal.

Como funcionam os jobs em segundo plano?

O Trigger.dev é o runtime de jobs explícito. O contrato JobRunner só promete enqueue, status e cancel — a semântica de workflow permanece específica e explícita do Trigger.dev.

Como difere o email da divulgação?

O email transacional cobre fluxos de produto como avisos de conclusão de tarefas. A divulgação fria e as campanhas pertencem ao próprio produto, fora do módulo de email deste kit.

Como funcionam as compras no aplicativo móvel?

O aplicativo móvel inclui compras nativas e restauração via RevenueCat, com acesso verificado pelo servidor. Configure as contas das lojas e conclua os testes em dispositivos antes de publicar. A cobrança web permanece separada.

Onde residem as chaves dos fornecedores de IA?

As credenciais BYOK são encriptadas e ficam no servidor. As chaves são higienizadas nos logs; a utilização e os orçamentos ficam visíveis ao nível do workspace.

Quais métodos de pagamento o checkout aceita?

O checkout hospedado na Stripe aceita cartões e também pode oferecer Alipay e WeChat Pay quando essas carteiras estiverem ativadas na conta Stripe — útil para compradores na China. As autorizações de carteira são confirmadas de forma assíncrona, então a página da licença é atualizada assim que o pagamento é liquidado.

Posso solicitar um reembolso?

Depois de obter acesso ao repositório, o supastack é seu para sempre, portanto não pode ser reembolsado. Mas fique tranquilo: você recebe o código-fonte completo com atualizações vitalícias para criar e lançar produtos ilimitados para você ou seus clientes. Você apenas não pode revender o código nem redistribuir o repositório como starter kit ou modelo.

PT
Tema