Pular para o conteúdo
supastack
Explorar a documentação
Aplicação desktopTauri

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

Antes de começar

Instale o Node.js, o Git e um editor, aceite o convite do repositório, baixe o kit e verifique se o seu computador está pronto para a primeira execução.

Perguntar sobre este guia
Abrir em

1. Escolha o que você deseja executar

Use um computador Windows, macOS ou Linux com conexão à Internet. Um navegador executa o aplicativo Web; um telefone executa o aplicativo Mobile; o aplicativo Desktop é aberto em sua própria janela. Seu telefone sozinho não pode executar as etapas de instalação abaixo.

Um repositório é a pasta de arquivos que você recebeu por meio de GitHub. As compras na Web, Mobile e Desktop fornecem o repositório do kit correspondente; o pacote Todas as plataformas fornece o monorepo, uma pasta que contém todos os três aplicativos. Aceite o convite do repositório que você comprou. Um checkout móvel ou desktop ainda precisa de um back-end da Web acessível: o servidor que gerencia contas e dados. Esses repositórios de clientes não incluem o servidor Web.

Prepare essas ferramentas uma vez. O download das ferramentas e a primeira compilação nativa podem demorar muito mais do que cinco minutos. Os guias de cinco minutos começam após esses preparativos; executado localmente não publica seu aplicativo na Internet.

2. Instale Node.js

Abra a página oficial de download do Node.js abaixo. Escolha uma versão LTS numerada 22 ou superior e o instalador para o seu computador: .msi no Windows ou .pkg no macOS. Abra o instalador baixado, mantenha seus padrões e finalize a instalação. Node.js permite que seu computador execute o JavaScript do aplicativo; npm é instalado com ele.

Feche e reabra seu terminal após a instalação. No Windows, abra Iniciar, digite PowerShell e abra-o. No macOS, pressione Command + Espaço, digite Terminal e pressione Enter. No Linux, abra o Terminal no menu de aplicativos. Cole o comando abaixo e pressione Enter. Um resultado como v22.x.x ou v24.x.x confirma que o Node está disponível. Se você vir o comando não encontrado ou não reconhecido, reabra o terminal ou reinstale o Node com sua opção PATH habilitada.

node --version
npm --version

3. Instale o Git e um editor de texto

Abra a página de download do Git abaixo, selecione seu sistema operacional e siga seu instalador. Git baixa seu repositório privado e registra alterações no arquivo. No macOS, executar o comando abaixo pode oferecer a instalação de ferramentas de linha de comando da Apple; aceite-o e execute novamente o comando após terminar. No Linux, use o comando de instalação mostrado para sua distribuição na página do Git.

Instale Visual Studio Code de sua página oficial de download. Este é um editor de texto para abrir o projeto e salvar os arquivos de configuração. Abra-o, escolha Arquivo → Abrir pasta (Arquivo → Abrir no macOS) e depois selecione a pasta supastack que você baixou. Você não precisa escrever código para concluir a primeira demonstração local.

Em um terminal recém-aberto, execute o comando abaixo. Um resultado começando com a versão git significa que o Git está pronto. Se o comando estiver faltando, finalize o instalador e reabra o terminal.

git --version

4. Aceite seu convite GitHub

Faça login em GitHub em seu navegador usando a conta que você forneceu no momento da compra. Abra seu e-mail de convite GitHub, selecione Ver convite e aceite o acesso. Em seguida, abra o repositório convidado. Você deverá ver seus arquivos e um botão verde de código. Um 404 geralmente significa que o convite não foi aceito ou que você está conectado a uma conta GitHub diferente.

Selecione Código → Local → HTTPS e copie o endereço mostrado. Use esse endereço exato na próxima etapa. Exemplos de endereços contendo colchetes angulares são modelos: substitua-os em vez de colar os colchetes. Você não precisa adivinhar o nome de uma organização ou tornar público o repositório privado.

5. Baixe o projeto para o seu computador

Escolha uma pasta para seus projetos, como Documentos. Abra essa pasta no File Explorer ou Finder. No Windows, clique com o botão direito em uma área vazia e escolha Abrir no Terminal e escolha PowerShell se necessário. No macOS, abra o Terminal, digite cd seguido de um espaço, arraste a pasta para o terminal e pressione Enter. O terminal agora está funcionando nessa pasta.

No primeiro comando abaixo, substitua YOUR_COPIED_HTTPS_ADDRESS pelo endereço HTTPS que você acabou de copiar. Execute uma linha de cada vez. A primeira linha cria uma nova pasta chamada suastack; a segunda linha entra nele. Se o Git solicitar que você faça login, conclua o login no navegador. Não use a senha da sua conta GitHub como senha do Git. Se o login do navegador não estiver disponível, siga o guia de autenticação GitHub do HTTPS com link abaixo.

Sucesso: a pasta suastack contém package.json, pnpm-workspace.yaml, apps e pacotes. Esta é a raiz do repositório. Se o Git disser que o destino já existe, use uma pasta vazia diferente ou abra o clone existente; não exclua seu trabalho. Mantenha este terminal aberto para a próxima etapa.

git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack

6. Verifique Corepack e o gerenciador de pacotes fixados

Execute o primeiro comando abaixo. Corepack seleciona a versão pnpm registrada em package.json; pnpm baixa as bibliotecas que o projeto usa. Se Corepack solicitar permissão para baixar essa versão, digite y e pressione Enter. Esta verificação fixa pnpm 11.19.0; mantenha seu pin em vez de escolher um gerenciador de pacotes diferente.

Se o corepack estiver faltando, execute npm install --global corepack, reabra seu terminal e tente novamente. Se PowerShell disser que um script npm.ps1 ou corepack.ps1 não pode ser executado, use npm.cmd ou corepack.cmd para esse comando, incluindo corepack.cmd pnpm install. Você não precisa alterar a política de execução do seu computador.

Os comandos filtrados de primeira execução chamam Corepack diretamente. Se você usar um comando Turbo como corepack pnpm dev, o Turbo também precisará de um comando pnpm em PATH. A configuração do Windows abaixo cria esse comando em uma pasta gravável pelo usuário; sua alteração PATH dura apenas para o terminal atual. Execute este bloco novamente após abrir um novo terminal se pnpm estiver faltando. No macOS/Linux, execute corepack enable; se relatar um erro de permissão, use o comando filtrado de primeira execução.

corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"

7. Continue com sua plataforma

Você estará pronto quando o Node e o Git imprimirem as versões, Corepack puder selecionar o pnpm fixado e seu terminal estiver na pasta que contém package.json. Escolha um tutorial abaixo. Docker é opcional para demonstração na Web; um banco de dados será necessário posteriormente para contas reais. O Desktop também precisa do Rust e de ferramentas de construção nativas, que seu tutorial explica antes do comando de inicialização.

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