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

Palavras que você vai ver

Definições em linguagem simples para os termos que os guias de configuração, as mensagens de erro e o próprio produto usam.

Arquivos e pastas

Estas palavras descrevem o código que você baixou. Os guias de configuração as nomeiam sempre que pedem para você abrir ou editar um arquivo.

  • Repository — a pasta do projeto mais o histórico completo de alterações, hospedada no GitHub e copiada para o seu computador.
  • Clone — a sua própria cópia de um repositório no computador; o comando git clone a cria.
  • Monorepo — um único repositório que guarda vários apps e pacotes compartilhados; o pacote All Platforms é um.
  • package.json — o arquivo em cada app ou pacote que lista o seu nome, os seus comandos e as bibliotecas de que precisa.
  • pnpm-workspace.yaml — o arquivo na raiz do monorepo que lista quais pastas pertencem ao workspace.
  • Lockfile — o arquivo que registra a versão exata de cada biblioteca instalada, para que toda instalação saia igual.

Ferramentas no seu computador

Programas que você instala uma vez antes da primeira execução. Os guias os nomeiam em comandos como node --version.

  • Terminal — a janela onde você digita comandos, como o PowerShell no Windows ou o Terminal no macOS.
  • Node.js — o programa que executa JavaScript fora do navegador; o servidor e os scripts do kit rodam nele.
  • npm — o instalador de bibliotecas que vem com o Node.js; neste kit você o usa principalmente para chegar ao Corepack.
  • Corepack — a ferramenta que ativa a versão exata do gerenciador de pacotes que o projeto fixa.
  • pnpm — o gerenciador de pacotes que baixa bibliotecas e executa os scripts do projeto; acesse-o como corepack pnpm.
  • Git — a ferramenta que baixa o seu repositório e registra cada alteração que você faz nele.
  • Editor ou IDE — o app onde você abre pastas e edita arquivos; os guias usam o Visual Studio Code.

Palavras de configuração

As configurações vivem em arquivos, não no terminal. Estas palavras cobrem onde elas ficam e como se chamam.

  • Variável de ambiente — uma configuração com nome, como EMAIL_PROVIDER=local, que muda o comportamento do app.
  • .env — o arquivo na raiz do repositório que guarda configurações para comandos como as migrações de banco de dados.
  • .env.local — o arquivo de configurações de um app, como apps/web/.env.local para o servidor web.
  • Secret — um valor que deve permanecer privado, como uma senha ou chave de assinatura; nunca faça commit dele nem o cole em chats.
  • API key — uma string secreta que um serviço externo lhe dá para reconhecer o seu app como um chamador autorizado.
  • Provider — um serviço externo que o kit pode usar para IA, e-mail, cobrança, armazenamento e tarefas parecidas.

Palavras que o produto usa

O app em execução e as suas telas de configurações usam estes termos. Workspace aparece com dois significados diferentes — confira o contexto.

  • Workspace — no produto, os usuários, dados e configurações separados de uma equipe; em comandos pnpm, uma pasta de pacote dentro do monorepo, selecionada com --filter.
  • Entitlement — o registro no servidor de que um espaço de trabalho pode usar um recurso pago.
  • Migration — uma alteração de banco de dados versionada que cria ou atualiza tabelas; você aplica migrações com um comando.
  • Session — o estado de login que diz ao servidor quem está pedindo, até expirar ou você sair.
  • Webhook — uma mensagem que um serviço externo envia ao URL do seu app quando algo acontece, como uma fatura paga.
  • Account vs organization — uma account é o login de uma pessoa; uma organization é o espaço de equipe compartilhado em que os membros entram, também chamado de workspace.

Palavras de desenvolvimento web

Termos que os guias de execução, build e implantação usam quando você abre o app num navegador.

Ctrl + C significa pressionar e segurar Ctrl, tocar em C e soltar — isso interrompe o comando em execução num terminal.

  • localhost — o nome deste computador num endereço de navegador; o seu app roda aí durante o desenvolvimento.
  • Port — a porta numerada depois de localhost, como :3000; cada app em execução usa uma diferente.
  • Dev server — o comando que fica recompilando e servindo o app enquanto você trabalha; pare-o com Ctrl + C.
  • Build — o passo que transforma o seu código-fonte nos arquivos otimizados que um servidor implanta.
  • Server rendering (SSR) — páginas que o servidor monta antes de enviá-las, para que a primeira visualização chegue completa.

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