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

Stack tecnológica

As tecnologias por trás do kit e o papel de cada uma.

Perguntar sobre este guia
Abrir em

Antes de começar

Abra seu projeto supastack baixado em Visual Studio Code usando Arquivo → Abrir pasta e escolha Terminal → Novo Terminal. A raiz do repositório é a pasta que contém package.json, apps e pacotes. Execute o comando abaixo e deixe seu terminal aberto. Se um comando não for reconhecido, conclua o guia de instalação da ferramenta antes de continuar.

Leia o tutorial da plataforma primeiro. Um servidor é o processo do aplicativo que responde às solicitações do navegador ou do telefone. A Web lê apps/web/.env.local, Expo lê apps/mobile/.env.local e os comandos de migração de banco de dados leem root .env. A demonstração sem banco de dados/painel é separada das contas reais/auth, que precisam migrar para Postgres. Uma finalização de compra somente por telefone ou desktop precisa de um back-end da Web executado separadamente.

corepack pnpm --filter @supastack/web dev

Stack da aplicação

A aplicação web é uma aplicação Next.js composta por pacotes TypeScript partilhados — os mesmos pacotes alimentam a aplicação móvel Expo. O chrome do produto usa módulos CSS sobre tokens de design, pelo que não há CSS-in-JS em runtime para depurar, e o armazenamento de objetos é compatível com S3. As ferramentas abaixo são as predefinições escolhidas.

Next.js + React

A aplicação web executa Next.js 16 com o App Router e server components do React 19.

TypeScript + Turborepo

O modo strict do TypeScript aplica-se a todo o workspace pnpm, e o Turborepo coordena os builds.

Better Auth

Better Auth é o motor de identidade; um motor Auth.js está disponível para equipas que o padronizem.

Drizzle + PostgreSQL

A persistência passa pelo ORM Drizzle sobre PostgreSQL — o esquema e os helpers por onde cada registo passa.

Faturação

A faturação Stripe é a predefinição e está incluído um adaptador para Lemon Squeezy.

Trigger.dev

Os trabalhos em segundo plano são executados no Trigger.dev.

Email transacional

O email transacional é enviado através de Resend ou AWS SES.

Sentry + PostHog

A observabilidade passa por Sentry e PostHog.

Expo

A aplicação móvel Expo consome os mesmos pacotes TypeScript, pelo que as alterações de contrato são verificadas em ambas as superfícies ao mesmo tempo. A Expo compila para iOS e Android.

Módulos partilhados

Cada capacidade transversal vive num pacote com um contrato pequeno: auth, db, billing, ai, jobs, email, storage, observability, config, i18n e api. As aplicações compõem-nos; a lógica de domínio do produto fica fora do kit.

Cada módulo apoiado por um provider inclui um adaptador fake ou local para que o ciclo de teste e desenvolvimento predefinido nunca chame um serviço pago.

Ferramentas de verificação

O Vitest cobre o comportamento unitário e de integração, o Playwright cobre os fluxos de browser, e o ESLint mais o Prettier mantêm o código consistente. A suite determinística corre sem credenciais de provider; a aceitação com providers reais é um percurso separado e opcional.

corepack pnpm test          # deterministic unit + integration
corepack pnpm check         # lint, types, tests, format
corepack pnpm build         # production builds
corepack pnpm test:e2e      # browser flows

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