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

Le tecnologie dietro il kit e il ruolo di ciascuna.

## Prima di iniziare

Apri il progetto supastack scaricato in Visual Studio Code utilizzando File → Apri cartella, quindi scegli Terminale → Nuovo terminale. La radice del repository è la cartella contenente package.json, app e pacchetti. Esegui il comando qui sotto e lascia il suo terminale aperto. Se un comando non viene riconosciuto, completare la guida all'installazione dello strumento prima di continuare.

Leggi prima il tutorial sulla piattaforma. Un server è il processo dell'app che risponde alle richieste del browser o del telefono. Il Web legge apps/web/.env.local, Expo legge apps/mobile/.env.local e i comandi di migrazione del database leggono root .env. La dimostrazione senza database/dashboard è separata dagli account reali/auth, che necessitano della migrazione Postgres. Un pagamento solo telefonico o desktop richiede un backend Web eseguito separatamente.

[Installa gli strumenti e ottieni il codice](https://supastack.dev/it/docs/web/before-you-start.md)

[Impara comandi, file e configurazione](https://supastack.dev/it/docs/web/terminal-basics.md)

[Completa il tutorial di prima esecuzione sul Web](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)

```
corepack pnpm --filter @supastack/web dev
```


## Stack applicativo

L'app web è un'applicazione Next.js composta da pacchetti TypeScript condivisi — gli stessi pacchetti alimentano l'app mobile Expo. Il chrome del prodotto usa CSS Modules sui design token, quindi non c'è CSS-in-JS a runtime da debuggare, e lo storage di oggetti è compatibile con S3. Gli strumenti seguenti sono i default scelti.


## Next.js + React

L'app web esegue [Next.js](https://nextjs.org) 16 con l'App Router e i server component di [React](https://react.dev) 19.

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


## TypeScript + Turborepo

La modalità strict di [TypeScript](https://www.typescriptlang.org) si applica a tutto il workspace pnpm, e [Turborepo](https://turborepo.com) coordina le build.

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


## Better Auth

[Better Auth](https://better-auth.com) è il motore di identità; è disponibile un motore Auth.js per i team che lo standardizzano.

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


## Drizzle + PostgreSQL

La persistenza passa attraverso l'ORM [Drizzle](https://orm.drizzle.team) su [PostgreSQL](https://www.postgresql.org) — lo schema e gli helper attraverso cui passa ogni record.

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


## Fatturazione

La fatturazione [Stripe](https://stripe.com) è il default, ed è incluso un adattatore per [Lemon Squeezy](https://www.lemonsqueezy.com).

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


## Trigger.dev

I job in background girano su [Trigger.dev](https://trigger.dev).

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


## Email transazionale

Le email transazionali vengono inviate tramite [Resend](https://resend.com) o AWS SES.

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


## Sentry + PostHog

L'osservabilità passa per [Sentry](https://sentry.io) e [PostHog](https://posthog.com).

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


## Expo

L'app mobile [Expo](https://expo.dev) consuma gli stessi pacchetti TypeScript, quindi le modifiche ai contratti vengono verificate su entrambe le superfici contemporaneamente. Expo compila per iOS e Android.

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


## Moduli condivisi

Ogni capacità trasversale vive in un pacchetto con un piccolo contratto: auth, db, billing, ai, jobs, email, storage, observability, config, i18n e api. Le applicazioni li compongono; la logica di dominio del prodotto resta fuori dal kit.

Ogni modulo basato su provider include un adattatore fake o locale così il ciclo di test e sviluppo predefinito non chiama mai un servizio a pagamento.


## Strumenti di verifica

Vitest copre il comportamento unitario e di integrazione, Playwright copre i flussi browser, ed ESLint più Prettier mantengono il codice coerente. La suite deterministica gira senza credenziali provider; l'accettazione con provider reali è un percorso separato e opzionale.

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


## Successivo

[Installazione locale](https://supastack.dev/it/docs/web/local-setup.md)