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

# Prima di iniziare

Installa Node.js, Git e un editor, accetta l'invito al repository, scarica il kit e verifica che il tuo computer sia pronto per la prima esecuzione.

## 1. Scegli cosa vuoi eseguire

Utilizza un computer Windows, macOS o Linux con una connessione Internet. Un browser esegue l'app Web; un telefono esegue l'app mobile; l'app desktop si apre in una finestra separata. Il tuo telefono da solo non può eseguire i passaggi di installazione riportati di seguito.

Un repository è la cartella dei file ricevuti tramite GitHub. Gli acquisti Web, Mobile e Desktop forniscono ciascuno il repository di kit corrispondente; il bundle All Platforms fornisce il monorepo, una cartella contenente tutte e tre le app. Accetta l'invito per il repository che hai acquistato. Un checkout mobile o desktop necessita ancora di un backend Web raggiungibile: il server che gestisce account e dati. Tali repository client non includono il server Web.

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.

[Installatori ufficiali Node.js](https://nodejs.org/en/download)

```
node --version
npm --version
```


## 3. 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.

[Installatori Git ufficiali](https://git-scm.com/downloads/)

[Scarica Visual Studio Code](https://code.visualstudio.com/download)

```
git --version
```


## 4. 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.

Operazione riuscita: la cartella supastack contiene package.json, pnpm-workspace.yaml, app e pacchetti. 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. Mantieni questo terminale aperto per il passaggio successivo.

[Guida per l'autenticazione GitHub HTTPS](https://docs.github.com/en/get-started/git-basics/about-remote-repositories)

```
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack
```


## 6. 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.

[Scopri come eseguire un comando e modificare un file](https://supastack.dev/it/docs/web/terminal-basics.md)

```
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. Continua con la tua piattaforma

Sei pronto quando Node e Git stampano le versioni, Corepack può selezionare pnpm bloccato e il tuo terminale si trova nella cartella contenente package.json. Scegli un tutorial qui sotto. Docker è facoltativo per la dimostrazione Web; in seguito sarà necessario un database per i conti reali. Il desktop necessita anche di Rust e di strumenti di creazione nativi, che il tutorial spiega prima del comando di avvio.

[Lascia che un agente esegua la configurazione per te](https://supastack.dev/it/docs/web/agent-setup.md)

[Esegui l'applicazione Web](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)

[Esegui l'app per dispositivi mobili](https://supastack.dev/it/docs/mobile/ship-in-5-minutes.md)

[Esegui l'app desktop](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md)


## Successivo

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