Salta al contenuto
supastack
Sfoglia la documentazione
WebNext.js

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

Come usare questa documentazione

Orientati nella documentazione — tab, gruppi, ricerca e link alle sezioni — e passa qualsiasi guida a un agente di codice con gli strumenti di copia integrati.

Come sono organizzate le pagine

Questa documentazione è il manuale del kit che hai scaricato. Il selettore di superficie sopra l'elenco delle guide — Web, Mobile e Desktop — raccoglie le guide di ogni superficie: l'app del browser, l'app del telefono e la finestra desktop. Inizia con Web; copre il server con cui ogni superficie comunica. Ogni superficie si apre sulla propria guida rapida da cinque minuti.

La colonna di sinistra elenca le guide dentro gruppi con nome come Per iniziare e Configura i provider; seleziona l'intestazione di un gruppo per aprire o chiudere il suo elenco e la pagina corrente resta evidenziata. La colonna di destra, In questa pagina, elenca le sezioni della guida che stai leggendo — selezionane una per saltarci direttamente. Per trovare una guida con una parola ovunque al suo interno, come un nome di file o di impostazione, usa Cerca in cima alla colonna di sinistra oppure premi Ctrl + K (⌘K su Mac).

In fondo a una guida, una scheda Successivo — e nella maggior parte delle pagine anche una scheda Precedente — passa alle pagine vicine. Le guide di configurazione mostrano anche una frase sopra di sé — Per continuare la configurazione, leggi — con un link al passaggio di configurazione successivo, così puoi collegare i provider in ordine.

Gli strumenti di copia

Due pulsanti si trovano sotto il titolo di ogni guida. Copia come Markdown mette l'intera guida negli appunti come Markdown — lo stesso formato testo semplice che serve la versione .md della pagina — inclusi comandi, elenchi e il link alla guida successiva. Copia il prompt copia una singola riga già pronta: Read seguita dall'indirizzo della versione Markdown di questa pagina. Incollala in una chat AI e il modello recupera la guida da solo.

Accanto, Chiedi informazioni su questa guida apre ChatGPT in una nuova scheda con la stessa istruzione già compilata. Il menu Apri in offre la stessa scorciatoia per ChatGPT più Markdown, che apre la versione testo semplice nel tuo browser — lo stesso indirizzo della pagina con .md alla fine.

Ogni blocco di comandi porta un piccolo pulsante Copia nell'angolo in alto. Copia solo i comandi dentro quel blocco, non la spiegazione intorno, così puoi incollare direttamente in un terminale. Ogni pulsante mostra brevemente Copiato quando ha funzionato.

Passa una guida a un agente di codice

Un agente di codice — un assistente AI che può leggere e modificare il tuo progetto, come Claude Code, Cursor o Codex — lavora meglio quando legge le stesse istruzioni che leggi tu. Il passaggio più semplice è Copia il prompt: incolla la riga copiata nella chat dell'agente e leggerà da solo la versione Markdown della guida. Scegli Copia come Markdown quando vuoi il testo completo direttamente nel messaggio — per esempio perché l'agente confronti la guida con i tuoi file, o perché una chat senza accesso al web la veda comunque.

Puoi anche incollare l'indirizzo della pagina che finisce in .md in quasi ogni chat AI; restituisce lo stesso Markdown senza la decorazione della pagina. Il kit è stato scritto per questo workflow — dentro il tuo repository, AGENTS.md e la cartella prompts/ danno a un agente le sue regole e attività già pronte.

Gli stessi contenuti dentro il tuo repository

Non hai bisogno di questo sito per ogni risposta — gran parte è inclusa nel codice che hai scaricato. Nel repository Web e nel monorepo All Platforms, la cartella docs/ contiene riferimenti Markdown più lunghi, come agent-setup.md (il runbook della configurazione automatica) e upgrading.md (la versione dettagliata della procedura di aggiornamento in questo gruppo), e la cartella prompts/ contiene istruzioni pronte da incollare. I checkout standalone di Mobile e Desktop portano invece un insieme selezionato più piccolo. In ogni caso, il file llms.txt alla radice del repository è una mappa: elenca quali file un agente deve leggere prima e le regole che deve seguire.

La tua app in esecuzione serve da sola la stessa idea: ha le proprie guide /docs per il prodotto che costruisci e una route /llms.txt che consegna a un agente un indice vivo dell'app.

Linka una sezione, non solo una pagina

Ogni titolo di sezione in una pagina guida è anche un anchor — una posizione linkabile dentro la pagina. Seleziona una sezione nella colonna In questa pagina, oppure seleziona il titolo stesso, e la barra degli indirizzi del browser guadagna un finale #section-name. Quell'indirizzo completo apre la pagina già scorsa fino alla sezione.

Condividi un indirizzo con anchor con un collega quando intendi un passaggio specifico, oppure incollalo in un prompt dell'agente per la stessa ragione. In questo gruppo vivono due pagine compagne: il glossario qui sotto e la procedura di aggiornamento per quando il kit stesso migliora.

Domande frequenti

14 domande

Cos'è supastack?

supastack è una base modulare per costruire prodotti SaaS con AI. Riunisce l'infrastruttura comune così puoi concentrarti sulle funzionalità proprie del tuo prodotto.

Supporta web e mobile?

Sì. supastack include app Next.js ed Expo come punti di partenza per esperienze web e mobile.

Quale autenticazione è inclusa?

Better Auth copre email/password, OTP e login social. I workspace personali vengono provisionati con l'account così i record restano delimitati fin dal primo giorno.

Come è supportata l'AI?

supastack include AI multi-provider configurabile, tracciamento dell'uso, budget e supporto cifrato per le proprie chiavi (BYOK).

Come vengono gestiti gli abbonamenti?

Per i prodotti costruiti sul kit, fatturazione Stripe, abbonamenti e permessi formano la base dell'accesso a pagamento. I segreti dei provider restano lato server.

Dove vive il codice specifico del mio prodotto?

Le funzionalità specifiche del prodotto restano in un codebase separato, mentre il prodotto configura e integra i moduli base di supastack.

Come funziona il prezzo di supastack?

Il kit è un acquisto unico con aggiornamenti a vita: Un framework a 249 $ (prezzo di lancio temporaneo — 100 $ di sconto sul prezzo di listino di 349 $) oppure Tutti i framework (Next.js, iOS, Android) a 499 $ (prezzo di lancio temporaneo — 100 $ di sconto sul prezzo di listino di 599 $), più 75 $ per posto sviluppatore aggiuntivo. Nessun abbonamento al kit. Il checkout su questo sito consegna la tua chiave di licenza via email, con accesso al repo tramite invito GitHub.

Come delimitano i workspace i miei dati?

I record utente sono delimitati da workspaceId. Identità, permessi, uso AI, eventi di fatturazione e voci di audit restano dentro il confine del workspace personale.

Come funzionano i job in background?

Trigger.dev è il runtime di job esplicito. Il contratto JobRunner promette solo enqueue, status e cancel — la semantica di workflow resta specifica ed esplicita di Trigger.dev.

In cosa differisce l'email dall'outreach?

L'email transazionale copre i flussi di prodotto come gli avvisi di completamento delle attività. L'outreach a freddo e le campagne appartengono al prodotto, fuori dal modulo email di questo kit.

Come funzionano gli acquisti su mobile?

La versione mobile include acquisti nativi e ripristino tramite RevenueCat, con accesso verificato dal server. Configura gli account degli store e completa i test sui dispositivi prima della pubblicazione. I pagamenti web restano separati.

Dove risiedono le chiavi dei provider AI?

Le credenziali BYOK sono cifrate e restano lato server. Le chiavi vengono sanificate nei log; uso e budget restano visibili a livello di workspace.

Quali metodi di pagamento accetta il checkout?

Il checkout ospitato da Stripe accetta le carte e può offrire anche Alipay e WeChat Pay una volta attivati i wallet sull'account Stripe — utile per gli acquirenti in Cina. Le autorizzazioni dei wallet vengono confermate in modo asincrono, quindi la pagina della licenza si aggiorna non appena il pagamento va a buon fine.

Posso ottenere un rimborso?

Una volta ottenuto l'accesso al repository, supastack è tuo per sempre, quindi non può essere rimborsato. Ma non preoccuparti: ricevi il codice sorgente completo con aggiornamenti a vita per creare e lanciare prodotti illimitati per te o per i tuoi clienti. L'unica condizione è che non puoi rivendere il codice né ridistribuire il repository come starter kit o modello.

IT
Tema