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

Introdução

O que é o supastack, o que recebes e o caminho até uma app a correr.

Perguntar sobre este guia
Abrir em

Comece aqui: o que você recebeu

O kit é um aplicativo inicial que você pode personalizar. Web é a interface do navegador mais o servidor API; Móvel é a interface do telefone; Desktop é uma janela nativa que exibe o aplicativo Web. Um API é o endereço do servidor que um cliente chama para entrar ou ler dados. Pacotes compartilhados são peças reutilizáveis ​​usadas por esses aplicativos.

Comece com o tutorial local da Web abaixo. Ele informa exatamente como baixar bibliotecas, iniciar o servidor e executar um AI task falso. Em seguida, adicione o banco de dados de contas salvas, escolha apenas os provedores que seu produto precisa, personalize sua marca e prepare a hospedagem. Você pode ler as explicações técnicas posteriormente; eles não são pré-requisitos para abrir a primeira demonstração.

Construa a partir de uma base compartilhada

suastack é uma base modular para AI SaaS na web, dispositivos móveis e desktop. Next.js carrega a UI da web e API, Expo fornece fluxos de referência nativos e o shell de desktop Tauri carrega o mesmo aplicativo da web. Os pacotes compartilhados lidam com identidade, espaços de trabalho, cobrança, IA, empregos, email, armazenamento e observabilidade.

Comece com o fluxo de referência local para entender como os módulos se encaixam. Configure provedores de produção somente depois que o fluxo funcionar em seu ambiente.

Encontre o seu caminho

Os aplicativos compõem os pacotes compartilhados. Os recursos específicos do produto pertencem à base de código do produto de consumo, e não ao núcleo reutilizável.

apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery

Escolha o seu ponto de partida

Comece pela configuração local de cinco minutos. Em seguida, siga o link Continuar a configuração no fim de cada guia: configure o banco de dados, a autenticação, os planos e os provedores antes de preparar a implantação. Use o índice completo da documentação para encontrar cada recurso, provedor, componente e referência.

O caminho recomendado local já passou no ambiente de desenvolvimento do projeto. A configuração cronometrada a partir de um clone limpo, o smoke test com provedores reais, a implantação e a aceitação em dispositivo físico continuam sendo etapas de verificação separadas.

Bem-vindo ao supastack

O supastack é um kit modular para produtos SaaS com IA: uma app web Next.js, uma app mobile Expo e um shell desktop Tauri, tudo construído sobre pacotes TypeScript partilhados para auth, faturação, IA, jobs, email, armazenamento e observabilidade.

Após a compra recebes um convite GitHub para os repositórios do kit — web, mobile e desktop (o bundle All Platforms entrega o monorepo completo). Clona a superfície que vais lançar e torna-a tua.

Estas docs são um percurso passo a passo, não uma descarga de referência: põe primeiro a app a correr localmente e depois percorre as páginas de configuração de fornecedores por ordem. Cada página termina a apontar para a seguinte.

Inicia um servidor local

Precisas de Node.js 22 ou mais recente. O repo fixa o seu package manager (packageManager: [email protected]), por isso corre o pnpm através do Corepack — sem instalação global.

1. Copia o ficheiro de ambiente para criar a tua configuração local.

2. Instala as dependências do workspace.

3. Opcionalmente, inicia o contentor Postgres local para persistência real — os defaults correm sem ele.

4. Inicia o servidor de desenvolvimento e abre http://localhost:3000.

cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000

O ficheiro .env

As configurações de ambiente escolhem o serviço local ou hospedado usado pelo kit. Copie .env.example para root .env para migrações e para apps/web/.env.local para o servidor Web. Expo usa apps/mobile/.env.local. Copiar apenas root .env não configura todos os aplicativos.

Os provedores falsos/locais padrão não precisam de credenciais API pagas. Eles permitem que você conclua a demonstração na memória/painel; o login real em /auth ainda precisa de PostgreSQL e migrações. Para um provedor real, altere apenas as configurações nomeadas no arquivo de configuração da Web, salve, pare e reinicie o servidor. Nunca exponha segredos por meio de valores NEXT_PUBLIC_ ou EXPO_PUBLIC_.

Escolhe o teu caminho

Novo por aqui? Lança em 5 minutos leva-te do clone a uma app a correr só com os defaults.

A construir para telemóvel ou desktop? Os separadores Mobile e Desktop cobrem as superfícies Expo e Tauri. Com a app no ar, o grupo Configurar os fornecedores percorre cada integração doc a doc.

Para continuar a configuração, leia Lança em 5 minutos.

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