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/using-the-docs.md (or send Accept: text/markdown).

Como usar esta documentação

Encontre o seu caminho na documentação — abas, grupos, pesquisa e links de seção — e entregue qualquer guia a um agente de codificação com as ferramentas de cópia embutidas.

Como as páginas estão organizadas

Esta documentação é o manual do kit que você baixou. O seletor de superfície acima da lista de guias — Web, Mobile e Desktop — reúne os guias de cada superfície: o app de navegador, o app de telefone e a janela de desktop. Comece pela Web; ela cobre o servidor com que todas as superfícies falam. Cada superfície abre no seu próprio quickstart de cinco minutos.

A coluna da esquerda lista os guias dentro de grupos nomeados como Primeiros passos e Configurar os fornecedores; selecione o título de um grupo para abrir ou fechar a sua lista, e a página atual fica destacada. A coluna da direita, Nesta página, lista as seções do guia que você está lendo — selecione uma para pular direto para ela. Para achar um guia por uma palavra em qualquer lugar dele, como um nome de arquivo ou de configuração, use Pesquisar no topo da coluna da esquerda ou pressione Ctrl + K (⌘K no Mac).

No fim de um guia, um cartão Seguinte — e na maioria das páginas também um cartão Anterior — leva às páginas vizinhas. Os guias de configuração também mostram uma frase acima deles — «Para continuar a configuração, leia» — com um link para o próximo passo de configuração, para que você conecte os provedores em ordem.

As ferramentas de cópia

Dois botões ficam sob o título de cada guia. Copiar como Markdown coloca o guia inteiro na sua área de transferência em Markdown — o mesmo formato de texto simples que a versão .md da página serve — incluindo os comandos, as listas e o link para o próximo guia. Copiar prompt copia uma única linha pronta: Read seguido do endereço da versão Markdown desta página. Cole-a num chat de IA e o modelo busca o guia sozinho.

Ao lado deles, Perguntar sobre este guia abre o ChatGPT numa nova aba com essa mesma instrução já preenchida. O menu Abrir em oferece o mesmo atalho para o ChatGPT mais Markdown, que abre a versão em texto simples no seu navegador — o mesmo endereço da página com .md no fim.

Cada bloco de comando tem um pequeno botão Copiar no canto superior. Ele copia apenas os comandos dentro daquele bloco, não a explicação em volta, então você pode colar direto num terminal. Cada botão mostra Copiado por um instante quando funciona.

Entregue um guia a um agente de codificação

Um agente de codificação — um assistente de IA que consegue ler e editar o seu projeto, como Claude Code, Cursor ou Codex — funciona melhor quando lê as mesmas instruções que você. A entrega mais simples é Copiar prompt: cole a linha copiada no chat do agente e ele mesmo lê a versão Markdown do guia. Escolha Copiar como Markdown quando quiser o texto completo inline — por exemplo, para o agente comparar o guia com os seus arquivos, ou para que um chat sem acesso à web ainda assim o veja.

Você também pode colar o endereço da página terminando em .md em quase qualquer chat de IA; ele devolve o mesmo Markdown sem a decoração da página. O kit foi escrito para esse fluxo — dentro do seu repositório, AGENTS.md e a pasta prompts/ dão a um agente as suas regras e tarefas prontas.

O mesmo conteúdo dentro do seu repositório

Você não precisa deste site para cada resposta — boa parte dele vem dentro do código que você baixou. No repositório Web e no monorepo All Platforms, a pasta docs/ guarda referências Markdown mais longas, como agent-setup.md (o runbook de configuração autônoma) e upgrading.md (a versão detalhada do passo a passo de atualização deste grupo), e a pasta prompts/ guarda instruções prontas para colar. Compras standalone de Mobile e Desktop trazem, em vez disso, um conjunto menor e selecionado. De qualquer forma, o arquivo llms.txt na raiz do repositório é um mapa: lista quais arquivos um agente deve ler primeiro e as regras que ele deve seguir.

O seu app em execução serve a mesma ideia por conta própria: tem os seus próprios guias /docs para o produto que você constrói e uma rota /llms.txt que entrega a um agente um índice vivo do app.

Aponte para uma seção, não só para uma página

Cada título de seção numa página de guia também é uma âncora — uma posição linkável dentro da página. Selecione uma seção na coluna Nesta página, ou selecione o próprio título, e a barra de endereço do navegador ganha um final #nome-da-secao. Esse endereço completo abre a página já rolada até a seção.

Compartilhe um endereço com âncora com um colega quando você quer indicar um passo específico, ou cole-o num prompt de agente pelo mesmo motivo. Duas páginas companheiras vivem neste grupo: o glossário abaixo e o passo a passo de atualização para quando o próprio kit melhora.

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