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

# Comandi, file e configurazione

Impara dove incollare i comandi, come aprire la cartella di progetto corretta, modificare i file .env, fermare il server Expo e segnalare un errore di configurazione senza condividere segreti.

## Un comando va nel terminale

Un terminale è la finestra in cui digiti le istruzioni per il tuo computer. In Visual Studio Code, apri prima la cartella supastack utilizzando File → Apri cartella, quindi seleziona Terminale → Nuovo terminale. Il nuovo terminale inizia in quella cartella. Su Windows scegli PowerShell utilizzando il menu accanto al pulsante + del terminale. Utilizza i blocchi macOS/Linux in un terminale macOS o Linux.

Incolla solo il contenuto di un blocco di comandi, un comando alla volta, e premi Invio. Non incollare gli apici inversi di Markdown circostanti, un prompt come PS C:\... o un output di esempio. Le righe che iniziano con # sono spiegazioni; non eseguono nulla. Attendere il completamento di ciascun comando di installazione prima di immettere il comando successivo. Un comando del server continua a essere eseguito e non restituisce un nuovo prompt finché non lo interrompi.


## Controlla quale cartella sta utilizzando il terminale

Per root del repository si intende la cartella supastack di primo livello contenente package.json, pnpm-workspace.yaml, app e pacchetti. A meno che un passaggio non indichi diversamente, esegui i comandi da lì. Il comando seguente stampa la cartella corrente; l'elenco dei file dovrebbe mostrare package.json. In Windows PowerShell funzionano anche pwd e ls.

Se l'elenco mostra solo il contenuto di apps/mobile, digita cd ../.. e premi Invio per tornare alla radice. Se mostra la tua cartella home, digita cd seguito da uno spazio e dal percorso completo del tuo clone, racchiuso tra virgolette se contiene spazi. Di solito è più semplice aprire la cartella del progetto nell'editor e creare un nuovo terminale.

```
pwd
ls
```


## La configurazione va in un file, non nel terminale

Un blocco come AI_PROVIDER=fake è il testo di configurazione. Apri il file .env denominato nell'editor, trova la riga che inizia con AI_PROVIDER=, sostituisci il suo valore e salva con Ctrl + S (Command + S su macOS). Ciascuna impostazione occupa una riga nel formato KEY=value. Non aggiungere backtick Markdown. Evitare copie duplicate della stessa chiave in un unico file.

Usa apps/mobile/.env.local per Expo e il .env radice per i comandi di migrazione del database. Expo non carica automaticamente il .env radice. Il backend Web legge il proprio apps/web/.env.local; in un checkout solo Mobile quel file appartiene al repository backend separato, non a questo. Se l'indirizzo del backend cambia, aggiorna EXPO_PUBLIC_API_URL in apps/mobile/.env.local e riavvia Expo. Mantieni invariato il file di esempio per riferimento futuro.

I file i cui nomi iniziano con un punto potrebbero essere nascosti nel file manager; l'Explorer dell'editor li mostra. Assicurati che il nome del file sia esattamente .env.local, non .env.local.txt. Questi file locali possono contenere password e sono esclusi da Git; non caricarli né incollarne il contenuto nei messaggi di supporto.

[Trova il significato di ciascuna impostazione](https://supastack.dev/it/docs/mobile/project-structure.md)


## Mantieni il server in funzione; utilizzare un altro terminale per i comandi

Il server di sviluppo Expo consegna le tue schermate a un telefono o simulatore mentre lavori. Lascia aperto il suo terminale quando un tutorial chiede di scansionare il codice QR. Un comando server continua a funzionare e non restituisce un nuovo prompt finché non lo fermi.

Per eseguire un altro comando mentre il server è attivo, seleziona Terminale → Nuovo terminale nell'editor. Il nuovo terminale è una finestra separata nello stesso progetto. Per arrestare il server, seleziona il suo terminale e premi Ctrl + C una volta. Su Windows, se viene richiesto Termina lavoro batch, digitare Y e premere Invio. Attendi il prompt normale prima di riavviarlo.

Dopo aver modificato le impostazioni di Expo, fermalo con Ctrl + C, poi esegui il comando qui sotto per riavviarlo e cancellare il bundle in cache. Salvare un file sorgente di solito aggiorna l'anteprima automaticamente, ma le modifiche all'ambiente richiedono il riavvio.

```
corepack pnpm --filter @supastack/mobile start --clear
```


## Leggi un fallimento e chiedi un aiuto utile

Se un'installazione restituisce un testo di errore in rosso, fermarsi a quel passaggio. Leggi il primo errore invece di continuare ad avviare l'app. Un comando non trovato solitamente indica uno strumento mancante; no package.json di solito significa la cartella sbagliata; ECONNREFUSED di solito significa che un server o un database richiesto non è in esecuzione; EADDRINUSE significa che un altro processo utilizza già la porta.

Quando chiedi aiuto, includi il tuo sistema operativo, la guida URL e il numero del passaggio, il comando esatto che hai inserito e il primo messaggio di errore. Rimuovi password, chiavi API, token e la parte relativa alla password di qualsiasi database URL. Non inviare i file .env. Uno screenshot dell'errore può essere d'aiuto, ma il testo copiabile è più semplice da diagnosticare.

[Risolvere un errore di configurazione specifico](https://supastack.dev/it/docs/mobile/troubleshooting.md)


## Successivo

[Lascia configurare tutto a un agente](https://supastack.dev/it/docs/mobile/agent-setup.md)