> ## 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 # Introduzione Cos'è supastack, cosa ottieni e il percorso verso un'app in esecuzione. ## 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. [Installa gli strumenti e ottieni il codice](https://supastack.dev/it/docs/web/before-you-start.md) [Scopri come eseguire un comando e modificare un file](https://supastack.dev/it/docs/web/terminal-basics.md) [Segui il tutorial completo sul Web](https://supastack.dev/it/docs/web/ship-in-5-minutes.md) ## 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. [Configurazione locale in cinque minuti](https://supastack.dev/it/docs/web/ship-in-5-minutes.md) [Sfoglia tutta la documentazione](https://supastack.dev/it/docs/web/project-structure.md) [Configurazione mobile](https://supastack.dev/it/docs/mobile/ship-in-5-minutes.md) [Configurazione desktop](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md) [Impara a navigare questa documentazione](https://supastack.dev/it/docs/web/using-the-docs.md) ## 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: pnpm@11.19.0), 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](https://supastack.dev/it/docs/web/ship-in-5-minutes.md). ## Successivo [Pubblica in 5 minuti](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)