> ## 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

# Stack tecnológica

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

## 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.

[Instale as ferramentas e obtenha o código](https://supastack.dev/pt/docs/web/before-you-start.md)

[Aprenda comandos, arquivos e configuração](https://supastack.dev/pt/docs/web/terminal-basics.md)

[Conclua o tutorial inicial da Web](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md)

```
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](https://nextjs.org) 16 com o App Router e server components do [React](https://react.dev) 19.

- [Next.js](https://nextjs.org)
- [React](https://react.dev)


## TypeScript + Turborepo

O modo strict do [TypeScript](https://www.typescriptlang.org) aplica-se a todo o workspace pnpm, e o [Turborepo](https://turborepo.com) coordena os builds.

- [TypeScript](https://www.typescriptlang.org)
- [Turborepo](https://turborepo.com)


## Better Auth

[Better Auth](https://better-auth.com) é o motor de identidade; um motor Auth.js está disponível para equipas que o padronizem.

- [Better Auth](https://better-auth.com)


## Drizzle + PostgreSQL

A persistência passa pelo ORM [Drizzle](https://orm.drizzle.team) sobre [PostgreSQL](https://www.postgresql.org) — o esquema e os helpers por onde cada registo passa.

- [Drizzle](https://orm.drizzle.team)
- [PostgreSQL](https://www.postgresql.org)


## Faturação

A faturação [Stripe](https://stripe.com) é a predefinição e está incluído um adaptador para [Lemon Squeezy](https://www.lemonsqueezy.com).

- [Stripe](https://stripe.com)
- [Lemon Squeezy](https://www.lemonsqueezy.com)


## Trigger.dev

Os trabalhos em segundo plano são executados no [Trigger.dev](https://trigger.dev).

- [Trigger.dev](https://trigger.dev)


## Email transacional

O email transacional é enviado através de [Resend](https://resend.com) ou AWS SES.

- [Resend](https://resend.com)


## Sentry + PostHog

A observabilidade passa por [Sentry](https://sentry.io) e [PostHog](https://posthog.com).

- [Sentry](https://sentry.io)
- [PostHog](https://posthog.com)


## Expo

A aplicação móvel [Expo](https://expo.dev) 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.

- [Expo](https://expo.dev)


## 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
```


## Seguinte

[Instalação local](https://supastack.dev/pt/docs/web/local-setup.md)