> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Introdução O que é o supastack, o que recebes e o caminho até uma app a correr. ## 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. [Instale as ferramentas e obtenha o código](https://supastack.dev/pt/docs/web/before-you-start.md) [Aprenda como executar um comando e editar um arquivo](https://supastack.dev/pt/docs/web/terminal-basics.md) [Siga o tutorial completo de primeira execução na Web](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md) ## 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. [Configure localmente em cinco minutos](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md) [Navegue por toda a documentação](https://supastack.dev/pt/docs/web/project-structure.md) [Configuração do Mobile](https://supastack.dev/pt/docs/mobile/ship-in-5-minutes.md) [Configuração do Desktop](https://supastack.dev/pt/docs/desktop/ship-in-5-minutes.md) [Aprenda a navegar nesta documentação](https://supastack.dev/pt/docs/web/using-the-docs.md) ## 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: pnpm@11.19.0), 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](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md). ## Seguinte [Lança em 5 minutos](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md)