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/desktop/before-you-start.md (or send Accept: text/markdown).
Prima di iniziare
Installa Node.js, Git, un editor, Rust e gli strumenti di build nativi, accetta l'invito al tuo repository, scarica il kit e verifica che il tuo computer sia pronto per la prima esecuzione desktop.
1. Scegli cosa vuoi eseguire
Usa un computer Windows, macOS o Linux con una connessione Internet. L'app Desktop è una finestra nativa installata su questo stesso computer — nessun telefono è coinvolto. I passaggi qui sotto installano i suoi strumenti e scaricano il progetto.
Un repository è la cartella di file che hai ricevuto tramite GitHub. Un acquisto Desktop fornisce il repository del kit Desktop; il bundle All Platforms fornisce il monorepo, una cartella contenente tutte e tre le app. Accetta l'invito per il repository che hai acquistato. Il repository Desktop contiene la shell Tauri — la finestra nativa attorno alla tua app web — ma non il backend Web, quindi la finestra si connette a un indirizzo backend in esecuzione separata.
Preparare questi strumenti una volta. Il download degli strumenti e la prima compilazione nativa possono richiedere molto più di cinque minuti. Le guide di cinque minuti iniziano dopo questi preparativi; in esecuzione localmente non pubblica la tua app su Internet.
2. Installare Node.js
Apri la pagina di download ufficiale di Node.js di seguito. Scegli una versione LTS numerata 22 o successiva e il programma di installazione per il tuo computer: .msi su Windows o .pkg su macOS. Apri il programma di installazione scaricato, mantieni le impostazioni predefinite e completa l'installazione. Node.js consente al tuo computer di eseguire JavaScript dell'app; npm è installato con esso.
Chiudi e riapri il terminale dopo l'installazione. Su Windows apri Start, digita PowerShell e aprilo. Su macOS premi Comando + Spazio, digita Terminale e premi Invio. Su Linux apri Terminale dal menu delle applicazioni. Incolla il comando seguente, quindi premi Invio. Un risultato come v22.x.x o v24.x.x conferma che il nodo è disponibile. Se vedi il comando non trovato o non riconosciuto, riapri il terminale o reinstalla Node con l'opzione PATH abilitata.
node --version
npm --version3. Installa Git e un editor di testo
Apri la pagina di download di Git qui sotto, seleziona il tuo sistema operativo e segui il suo programma di installazione. Git scarica il tuo repository privato e registra le modifiche ai file. Su macOS, l'esecuzione del comando seguente potrebbe offrire l'installazione degli strumenti da riga di comando di Apple; accettarlo ed eseguire nuovamente il comando al termine. Su Linux utilizza il comando di installazione mostrato per la tua distribuzione nella pagina Git.
Installa Visual Studio Code dalla sua pagina di download ufficiale. Questo è un editor di testo per aprire il progetto e salvare i file di configurazione. Aprilo, scegli File → Apri cartella (File → Apri su macOS), quindi seleziona la cartella supastack che scarichi. Non è necessario scrivere codice per completare la prima dimostrazione locale.
In un terminale appena aperto, esegui il comando seguente. Un risultato che inizia con la versione git significa che Git è pronto. Se il comando manca, termina il programma di installazione e riapri il terminale.
git --version4. Accetta il tuo invito GitHub
Accedi a GitHub nel tuo browser utilizzando l'account fornito al momento dell'acquisto. Apri l'e-mail di invito GitHub, seleziona Visualizza invito e accetta l'accesso. Quindi apri il repository invitato. Dovresti vedere i suoi file e un pulsante verde Codice. Un 404 di solito significa che l'invito non è stato accettato o che hai effettuato l'accesso a un altro account GitHub.
Selezionare Codice → Locale → HTTPS e copiare l'indirizzo visualizzato. Utilizza quell'indirizzo esatto nel passaggio successivo. Gli indirizzi di esempio contenenti parentesi angolari sono modelli: sostituiscili anziché incollare le parentesi. Non è necessario indovinare il nome di un'organizzazione o rendere pubblico il repository privato.
5. Scarica il progetto sul tuo computer
Scegli una cartella per i tuoi progetti, ad esempio Documenti. Apri la cartella in Esplora file o nel Finder. Su Windows, fai clic con il pulsante destro del mouse su un'area vuota e scegli Apri nel terminale, quindi scegli PowerShell se necessario. Su macOS apri Terminale, digita cd seguito da uno spazio, trascina la cartella nel terminale e premi Invio. Il terminale ora funziona in quella cartella.
Nel primo comando seguente, sostituisci YOUR_COPIED_HTTPS_ADDRESS con l'indirizzo HTTPS che hai appena copiato. Esegui una riga alla volta. La prima riga crea una nuova cartella denominata supastack; la seconda riga vi entra. Se Git ti chiede di accedere, completa l'accesso al browser. Non utilizzare la password del tuo account GitHub come password Git. Se l'accesso al browser non è disponibile, seguire la guida di autenticazione HTTPS di GitHub collegata di seguito.
Successo: la cartella supastack contiene package.json, pnpm-workspace.yaml, apps e packages. Un checkout Desktop mostra solo la shell desktop dentro apps; il monorepo All Platforms mostra anche le app web e mobile. Questa è la radice del repository. Se Git dice che la destinazione esiste già, usa una cartella vuota diversa o apri il clone esistente; non eliminare il tuo lavoro. Tieni aperto questo terminale per il passaggio successivo.
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. Controlla Corepack e il gestore pacchetti bloccato
Esegui il primo comando di seguito. Corepack seleziona la versione pnpm registrata in package.json; pnpm scarica le librerie utilizzate dal progetto. Se Corepack chiede il permesso per scaricare quella versione, digita y e premi Invio. Questo checkout inserisce pnpm 11.19.0; mantenere il suo pin invece di scegliere un diverso gestore di pacchetti.
Se manca il corepack, esegui npm install --global corepack, riapri il terminale e riprova. Se PowerShell indica che uno script npm.ps1 o corepack.ps1 non può essere eseguito, utilizza npm.cmd o corepack.cmd per quel comando, incluso corepack.cmd pnpm install. Non è necessario modificare la politica di esecuzione del computer.
I comandi filtrati di prima esecuzione chiamano direttamente Corepack. Se utilizzi un comando Turbo come corepack pnpm dev, Turbo necessita anche di un comando pnpm su PATH. L'installazione di Windows di seguito crea quel comando in una cartella scrivibile dall'utente; la sua modifica PATH dura solo per il terminale corrente. Esegui nuovamente questo blocco dopo aver aperto un nuovo terminale se manca pnpm. Su macOS/Linux, esegui corepack enable; se segnala un errore di autorizzazione, utilizzare invece il comando filtrato di prima esecuzione.
corepack --version
corepack pnpm --version
# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"7. Installa Rust e gli strumenti di build nativi
Su Windows installa Microsoft C++ Build Tools utilizzando il collegamento ai prerequisiti Tauri riportato di seguito. Nel suo programma di installazione seleziona Sviluppo desktop con C++, mantieni selezionato Windows SDK e completa l'installazione. Assicurati che Microsoft Edge WebView2 Runtime sia installato. Installa Rust da rusticup.rs usando rusticup-init.exe; mantenere la toolchain MSVC predefinita. Riapri il terminale dopo l'installazione.
Su macOS, esegui xcode-select --install nel Terminale e completa la finestra di dialogo degli strumenti da riga di comando se non sono installati. Installa Rust utilizzando il comando macOS da ruggine.rs. Su Linux, segui la pagina dei prerequisiti Tauri per i pacchetti WebKitGTK, compilatore, vassoio e libreria di sistema della tua distribuzione, quindi installa Rust. I nomi dei pacchetti Linux variano; non eseguire i comandi di un'altra distribuzione.
Apri un terminale nella root del repository ed esegui i controlli della versione di seguito. Sia rustc che cargo devono stampare versioni; cargo è lo strumento di creazione di Rust. Se uno dei due manca, termina l'installazione e riapri il terminale prima di continuare.
rustc --version
cargo --version8. Continua con le guide Desktop
Sei pronto quando Node e Git stampano le versioni, Corepack può selezionare il pnpm bloccato, rustc e cargo stampano le versioni e il tuo terminale è nella cartella che contiene package.json. Scegli un tutorial qui sotto.