> ## 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 tuo repository, scarica il kit e verifica che il tuo computer sia pronto per la prima esecuzione mobile.

## 1. Scegli cosa vuoi eseguire

Usa un computer Windows, macOS o Linux con una connessione Internet, più un telefono o un simulatore installato per visualizzare l'app. Il computer esegue ogni passaggio di installazione qui sotto; il telefono mostra solo l'anteprima finita.

Un repository è la cartella di file che hai ricevuto tramite GitHub. Un acquisto Mobile fornisce il repository del kit Mobile; 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 Mobile contiene l'app Expo e i suoi pacchetti UI condivisi, ma non il backend Web — il server che gestisce account e dati — quindi l'app si connette a un 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.

[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.

Successo: la cartella supastack contiene package.json, pnpm-workspace.yaml, apps e packages. Un checkout Mobile mostra solo l'app mobile dentro apps; il monorepo All Platforms mostra anche le app web e desktop. 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.

[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/mobile/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 le guide Mobile

Sei pronto quando Node e Git stampano le versioni, Corepack può selezionare il pnpm bloccato e il tuo terminale è nella cartella che contiene package.json. Scegli un tutorial qui sotto. Expo Go sul tuo telefono è sufficiente per la prima anteprima; le build native e gli account dello store arrivano nelle guide successive.

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

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

[Scopri lo stack tecnologico Mobile](https://supastack.dev/it/docs/mobile/tech-stack.md)


## Successivo

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