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

# Configura l’app mobile

Imposta l’indirizzo del backend e lo schema dei deep link usati dalla build nativa, e mantieni sincronizzati i due lati del passaggio.

## Installazione e configurazione

Inserisci i valori destinati al dispositivo in `apps/mobile/.env.local`; Expo legge quel file, non il `.env` nella radice del repository. `EXPO_PUBLIC_API_URL` è l’origine del backend web raggiungibile dal telefono — lo stesso valore provato nel browser del telefono. `EXPO_PUBLIC_APP_SCHEME` è lo schema URI nativo dell’app; usa un valore DNS inverso come `com.example.app`.

`app.json` gestisce nome del prodotto, slug, versione, bundle identifier e plugin. `app.config.ts` deriva lo schema dei deep link e le origini di produzione da `EXPO_PUBLIC_APP_SCHEME`, quindi un cambio di schema richiede una nuova build nativa, non solo un riavvio di Metro. Sul server aggiungi ogni origine usata dall’app a `MOBILE_ALLOWED_ORIGINS`; il passaggio fallisce in modo sicuro quando i due lati non coincidono.

Ogni valore `EXPO_PUBLIC_*` viene incluso nel bundle dell’app. Mantieni le chiavi dei provider sul server e usa valori pubblici solo per indirizzi e schemi.

```
EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app
```


## Flusso di implementazione

Riavvia Expo dopo aver modificato `.env.local`. Esegui i test e il controllo dei tipi del pacchetto, poi conferma lo schema risolto con una build di sviluppo: apri un link di callback di autenticazione e verifica che torni all’app invece che al browser. Expo Go non può validare schemi personalizzati della tua build nativa.


## Verifica e risoluzione dei problemi

Riavvia Expo dopo aver modificato `.env.local` e apri l’anteprima sul dispositivo di destinazione. Cambia il tema, riavvia l’app e conferma che la scelta persiste; poi attiva un deep link e verifica che l’app lo gestisca invece del browser.


Per continuare la configurazione, leggi [Testa l’app mobile](https://supastack.dev/it/docs/mobile/testing.md).


## Successivo

[Testa l’app mobile](https://supastack.dev/it/docs/mobile/testing.md)