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

# Die mobile App konfigurieren

Lege die Backend-Adresse und das Deep-Link-Schema fest, die der native Build nutzt, und halte beide Seiten der Übergabe synchron.

## Einrichtung und Konfiguration

Gerätebezogene Werte gehören in `apps/mobile/.env.local`; Expo liest diese Datei, nicht die `.env` im Repository-Stamm. `EXPO_PUBLIC_API_URL` ist der Web-Backend-Ursprung, den das Telefon erreicht — derselbe Wert, den du im Telefonbrowser getestet hast. `EXPO_PUBLIC_APP_SCHEME` ist das native URI-Schema der App; verwende einen Reverse-DNS-Wert wie `com.example.app`.

`app.json` verwaltet Produktname, Slug, Version, Bundle-ID und Plugins. `app.config.ts` leitet das Deep-Link-Schema und die Produktions-Ursprünge aus `EXPO_PUBLIC_APP_SCHEME` ab; eine Schemaänderung erfordert daher einen nativen Neubau, nicht nur einen Metro-Neustart. Füge auf dem Server jeden Ursprung, den die App nutzt, zu `MOBILE_ALLOWED_ORIGINS` hinzu; die Übergabe schlägt fehl, wenn beide Seiten nicht übereinstimmen.

Jeder `EXPO_PUBLIC_*`-Wert wird in die App gebündelt. Halte Anbieterschlüssel auf dem Server und nutze öffentliche Werte nur für Adressen und Schemata.

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


## Implementierungsablauf

Starte Expo nach einer Änderung an `.env.local` neu. Führe die Pakettests und die Typprüfung aus und bestätige das aufgelöste Schema mit einem Entwicklungs-Build: Öffne einen Auth-Callback-Link und prüfe, ob er zur App statt zum Browser zurückkehrt. Expo Go kann benutzerdefinierte Schemata deines nativen Builds nicht validieren.


## Überprüfung und Fehlerbehebung

Starte Expo nach einer Änderung an `.env.local` neu und öffne die Vorschau auf dem Zielgerät. Wechsle das Theme, starte die App neu und bestätige, dass die Auswahl bleibt; löse dann einen Deep Link aus und prüfe, dass die App ihn statt des Browsers verarbeitet.


Wenn du die Einrichtung fortsetzen möchtest, lies [Die mobile App testen](https://supastack.dev/de/docs/mobile/testing.md).


## Weiter

[Die mobile App testen](https://supastack.dev/de/docs/mobile/testing.md)