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 /it/docs/web.md (or send Accept: text/markdown).

Introduzione

Cos'è supastack, cosa ottieni e il percorso verso un'app in esecuzione.

Chiedi informazioni su questa guida

Inizia da qui: cosa hai ricevuto

Il kit è un'app iniziale che puoi personalizzare. Web è l'interfaccia del browser più il server API; Mobile è l'interfaccia del telefono; Desktop è una finestra nativa che visualizza l'app Web. Uno API è l'indirizzo del server che un client chiama per accedere o leggere i dati. I pacchetti condivisi sono pezzi riutilizzabili utilizzati da queste app.

Inizia con il tutorial locale sul Web riportato di seguito. Ti dice esattamente come scaricare le librerie, avviare il server ed eseguire un falso AI task. Quindi aggiungi il database per gli account salvati, scegli solo i fornitori di cui il tuo prodotto ha bisogno, personalizza il tuo marchio e prepara l'hosting. Potrai leggere le spiegazioni tecniche più avanti; non sono prerequisiti per aprire la prima demo.

Costruire partendo da fondamenta condivise

supastack è una base modulare per AI SaaS su web, dispositivi mobili e desktop. Next.js porta l'interfaccia utente web e API, Expo fornisce flussi di riferimento nativi e la shell desktop Tauri carica la stessa app web. I pacchetti condivisi gestiscono identità, spazi di lavoro, fatturazione, intelligenza artificiale, lavori, posta elettronica, archiviazione e osservabilità.

Inizia con il flusso di riferimento locale per capire come i moduli si incastrano tra loro. Configura i fornitori di produzione solo dopo che il flusso funziona nel tuo ambiente.

Trova la tua strada

Le applicazioni compongono i pacchetti condivisi. Le funzionalità specifiche del prodotto appartengono alla base di codici del prodotto di consumo piuttosto che al nucleo riutilizzabile.

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

Scegli il tuo punto di partenza

Inizia con la configurazione locale di cinque minuti. Quindi segui il collegamento «Per continuare la configurazione, leggi» in fondo a ogni guida: configura il database, l'autenticazione, i piani e i provider prima di preparare la distribuzione. Usa l'indice completo della documentazione per trovare ogni funzionalità, provider, componente e riferimento.

Il percorso consigliato in locale è stato verificato nell'ambiente di sviluppo del progetto. La configurazione cronometrata da clone pulito, lo smoke test con provider reali, la distribuzione e l'accettazione su dispositivo fisico restano passaggi di verifica separati.

Benvenuto in supastack

supastack è un kit modulare per prodotti SaaS con AI: un'app web Next.js, un'app mobile Expo e una shell desktop Tauri, tutti costruiti su pacchetti TypeScript condivisi per auth, fatturazione, AI, job, email, storage e osservabilità.

Dopo l'acquisto ricevi un invito GitHub ai repository del kit — web, mobile e desktop (il bundle All Platforms consegna il monorepo completo). Clona la superficie che stai distribuendo e rendila tua.

Queste doc sono un percorso passo passo, non un contenitore di riferimenti: prima fai girare l'app in locale, poi segui le pagine di configurazione dei provider in ordine. Ogni pagina si chiude indicando la successiva.

Avvia un server locale

Ti serve Node.js 22 o più recente. Il repo fissa il suo package manager (packageManager: [email protected]), quindi esegui pnpm tramite Corepack — nessuna installazione globale richiesta.

1. Copia il file di ambiente per creare la tua configurazione locale.

2. Installa le dipendenze del workspace.

3. Opzionalmente avvia il container Postgres locale per la persistenza reale — i default funzionano senza.

4. Avvia il dev server e apri http://localhost:3000.

cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000

Il file .env

Le impostazioni dell'ambiente scelgono il servizio locale o ospitato utilizzato dal kit. Copia .env.example in root .env per le migrazioni e in apps/web/.env.local per il server Web. Expo utilizza apps/mobile/.env.local. La copia solo di root .env non configura tutte le app.

I fornitori falsi/locali predefiniti non necessitano di credenziali API a pagamento. Ti consentono di completare la dimostrazione in memoria/dashboard; l'accesso reale a /auth richiede ancora PostgreSQL e migrazioni. Per un provider reale, modificare solo le impostazioni denominate nel file di configurazione Web, salvare, quindi arrestare e riavviare il server. Non esporre mai i segreti tramite i valori NEXT_PUBLIC_ o EXPO_PUBLIC_.

Scegli il tuo percorso

Nuovo qui? Pubblica in 5 minuti ti porta dal clone a un'app in esecuzione con i soli default.

Stai costruendo per telefono o desktop? Le schede Mobile e Desktop coprono le superfici Expo e Tauri. Quando l'app è avviata, il gruppo Configura i provider guida ogni integrazione doc dopo doc.

Per continuare la configurazione, leggi Pubblica in 5 minuti.