Comandi, file e configurazione

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

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