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/web/terminal-basics.md (or send Accept: text/markdown).
Comandi, file e configurazione
Scopri dove incollare i comandi, come aprire la cartella di progetto corretta, modificare i file .env, arrestare un server e segnalare un errore di configurazione senza condividere i 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/web o apps/mobile, digitare cd ../.. e premere Invio per tornare alla radice. Se mostra la tua cartella home, digita cd seguito da uno spazio e il percorso completo del tuo clone, racchiuso tra virgolette quando contiene spazi. Aprire la cartella del progetto nell'editor e creare un nuovo terminale è solitamente più semplice.
pwd
lsLa 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.
Utilizzare root .env per i comandi di migrazione del database, apps/web/.env.local per il server Web Next.js e apps/mobile/.env.local per Expo. Next e Expo vengono eseguiti nelle cartelle delle proprie app e non caricano automaticamente root .env. Se la connessione al database cambia, aggiorna DATABASE_URL sia in root .env che in apps/web/.env.local in modo che le migrazioni e il server utilizzino lo stesso database. Mantenere il file di esempio invariato 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.
Mantieni il server in funzione; utilizzare un altro terminale per i comandi
Il server di sviluppo serve la tua app mentre lavori. Lascia il terminale aperto quando un tutorial dice apri localhost:3000. localhost significa questo computer; :3000 è la porta, come una porta numerata utilizzata dall'app. Inserisci URL nella barra degli indirizzi del browser, non nel terminale.
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 dell'ambiente Web, arrestare e riavviare il server Web con il comando seguente. Il salvataggio di un file di origine normalmente aggiorna automaticamente la pagina, ma le modifiche all'ambiente richiedono un riavvio. Dopo aver modificato le impostazioni di Expo, arresta Expo, quindi esegui corepack pnpm --filter @supastack/mobile start --clear per riavviare e cancellare il bundle memorizzato nella cache.
corepack pnpm --filter @supastack/web devLeggi 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.