Lascia configurare tutto a un agente

Puoi delegare la parte noiosa

Questo repository è stato scritto in modo che un agente di codifica possa leggerlo. Include un file mappa (llms.txt), un file di regole (AGENTS.md), note di memoria per file (.ai/) e skill per attività (.agents/skills/). Il checkout Mobile autonomo non include la cartella prompts/, quindi il prompt già pronto è stampato in questa guida — copialo da qui sotto invece di aprire un file.

Delegare la digitazione non significa saltare i controlli. L'agente lavora dentro la tua copia del repository e deve riportare ciò che ha fatto con prove. Le sezioni qui sotto mostrano com'è fatto un buon report, così resti tu al comando del risultato.

Questo percorso configura l'app Expo e la sua connessione al backend Web — il server che gestisce account e dati. Se il tuo checkout contiene anche apps/web, l'agente può eseguire quel backend localmente; un checkout solo Mobile necessita dell'indirizzo backend raggiungibile che ti è stato fornito.

• Esegui l'app Mobile a mano invece

Cosa ti serve prima

Completa prima la guida di preparazione: Node.js, Git e un editor installati, l'invito GitHub accettato e la cartella supastack scaricata sul tuo computer. L'agente lavora dentro quella cartella, quindi vale ancora tutto ciò che c'è in Prima di iniziare.

Ti serve anche uno strumento che possa fare da agente di codice — un editor con un agente di codice AI integrato (un IDE AI) o un agente che gira nel tuo terminale (una CLI agent). Va bene qualsiasi strumento attuale con capacità da agente; il prompt specifica già cosa deve leggere ed eseguire, quindi non devi scrivere istruzioni da solo.

Infine, decidi le due cose che il prompt chiede: l'indirizzo del backend che il tuo dispositivo può raggiungere — un indirizzo LAN del tuo computer per un backend locale o il tuo indirizzo HTTPS fornito — e dove visualizzerai l'app: Expo Go su un telefono, un simulatore iOS su un Mac o un emulatore Android.

Copia il prompt, compila due spazi vuoti, incolla

Il prompt è il blocco di codice qui sotto — seleziona e copia l'intero blocco.

Due segnaposto richiedono le tue scelte. Sostituisci <API_URL> con l'indirizzo del backend che il tuo dispositivo può raggiungere — l'indirizzo LAN del tuo computer più la porta 3000 per un backend locale sullo stesso Wi-Fi, o il tuo indirizzo HTTPS fornito. Sostituisci <DEVICE: expo-go | simulator> con expo-go per un telefono fisico o simulator per un simulatore iOS/Android installato. I passaggi numerati restano esattamente come scritti.

Set up this supastack Mobile checkout end to end and open the Expo app on **<DEVICE: expo-go | simulator>** against the backend at **<API_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run corepack pnpm install.
3. Create apps/mobile/.env.local from the names in .env.example: EXPO_PUBLIC_API_URL=<API_URL>, EXPO_PUBLIC_APP_SCHEME=supastack and EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off. Never invent a variable absent from .env.example.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <API_URL> answers from this computer and report its status.
5. Start Expo with corepack pnpm --filter @supastack/mobile start and report the QR preview or simulator launch with the real output.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

Cosa fa l'agente con il prompt

Il prompt indica all'agente la mappa, le regole e la checklist di sicurezza, poi gli dice di lavorare attraverso la configurazione in ordine e dimostrare ogni fase. In termini semplici, l'agente:

• Legge la mappa del repository (llms.txt), le regole del progetto (AGENTS.md) e le regole di gestione delle credenziali (docs/agent-security.md) prima di toccare qualsiasi cosa.
• Crea apps/mobile/.env.local solo dai nomi in .env.example, con l'indirizzo API e lo schema che hai fornito — l'agente non inventa mai un'impostazione EXPO_PUBLIC_ assente dal file di esempio.
• Verifica che il backend risponda al tuo indirizzo — avviando apps/web da solo solo quando quella cartella esiste in questo checkout — invece di dare per scontato un server che non c'è.
• Installa le dipendenze e avvia il server di sviluppo Expo, poi riporta l'anteprima QR o l'avvio del simulatore con l'output reale.
• Si ferma e riporta dopo che lo stesso passaggio fallisce due volte — non aggira un fallimento né elimina nulla senza chiedere.

Cosa controlli nel report dell'agente

Un buon report mostra prove, non affermazioni. Cerca l'URL del backend che risponde, l'installazione delle dipendenze completata e l'output del server Expo dietro ogni PASS — non una frase come 'tutto funziona'.

Il prompt dice all'agente di fermarsi e riportare dopo che lo stesso passaggio fallisce due volte — non di aggirare il fallimento — e di chiederti prima di qualsiasi azione distruttiva. Se il tuo agente continua a improvvisare dopo fallimenti ripetuti, fermalo e porta il primo errore alla guida alla risoluzione dei problemi.

Due cose non devono mai apparire: una funzionalità di sicurezza spenta per silenziare un errore, e un valore segreto come una password o una chiave stampato nella chat o nel report. Se ne vedi una, considera l'esecuzione fallita.

Tieni separate nella tua mente l'anteprima e il vero accesso. Un'anteprima QR riuscita mostra solo schermate — gli account reali hanno bisogno del database del backend, e gli acquisti reali hanno bisogno di una build di sviluppo EAS. 'L'anteprima si è aperta' non è ancora 'gli account funzionano'.

Se preferisci farlo a mano

Ogni passaggio che l'agente esegue è scritto nelle guide manuali qui sotto — gli stessi comandi, gli stessi controlli, al tuo ritmo.

• Esegui l'app Mobile in 5 minuti
• Leggi la configurazione locale completa
• Risolvi un fallimento di configurazione