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 /de/docs/mobile/deep-links.md (or send Accept: text/markdown).
Deep Links und App-Konfiguration
Das URL-Schema, die Bildschirm-Routenkarte und der gebündelte Konfigurationsvertrag.
Ein Env-Wert leitet das Schema ab
EXPO_PUBLIC_APP_SCHEME speist apps/mobile/app.config.ts, das das Deep-Link-Schema und die erlaubten Produktions-Origins über dieselbe Mobile-Auth-Konfiguration ableitet, die auch der Anmeldefluss nutzt. Der Wert wird validiert — nur Schema-Zeichen in Kleinschreibung — und reservierte Schemas wie http, https, file, javascript, data, exp und exps werden abgelehnt. Der ausgelieferte Standard ist supastack.
Beide Kennungen werden in app.json als com.supastack.app ausgeliefert (ios.bundleIdentifier und android.package); benennen Sie sie zusammen mit dem Schema vor dem ersten Store-Upload um.
# apps/mobile/.env.local
EXPO_PUBLIC_APP_SCHEME=supastackLink-Formen, die die App akzeptiert
Deep Links sind nur Custom-Scheme: <scheme>://auth/callback schließt eine Anmelde-Übergabe ab, und <scheme>://invite/<token> öffnet den Einladungsbildschirm, der das Token an die Accept-Route der Einladungen postet. Universal Links sind nicht konfiguriert — app.json deklariert keine associatedDomains —, jeder Link wird daher über das Schema aufgelöst.
Die expo-router-Karte unter apps/mobile/app: index ist der Anmeldebildschirm, onboarding und new-organization übernehmen die Ersteinrichtung, paywall präsentiert Käufe, und feedback ist ein eigenständiger Bildschirm, der auch abgemeldet funktioniert. Innerhalb der Gruppe (app) sind die Tabs home, chat, notifications und settings; content, commerce und assistant sind versteckte Bildschirme, die über Schnellaktionen auf home erreichbar sind, und settings hält einen eigenen Unter-Stack von Bildschirmen.
Gebündelt heißt: Beide Seiten müssen übereinstimmen
Öffentliche Expo-Werte werden in die verteilte Binärdatei eingebrannt, während der Server mobile Callbacks pro Anfrage gegen MOBILE_ALLOWED_ORIGINS prüft. Das Paar muss übereinstimmen: Eine Schema- oder Origin-Änderung bedeutet einen neuen App-Build und ein Server-Deployment — nie nur eines von beiden.
Kein Over-the-Air-Kanal
Das Kit liefert weder eine expo-updates-Abhängigkeit noch eine Updates-Konfiguration — JavaScript-Änderungen erreichen Nutzer nur über neue Store-Builds. Halten Sie die API mit dem ältesten unterstützten Build kompatibel oder steuern Sie neue Fähigkeiten über serverseitigen Status.
Überprüfung und Fehlerbehebung
Testen Sie Links beim Kaltstart, Links, die eintreffen, während die App im Hintergrund läuft, und einen Link im abgemeldeten Zustand. Öffnet ein Link einen Store-Eintrag oder einen Browser statt der App, stimmt das Schema des installierten Builds nicht mit EXPO_PUBLIC_APP_SCHEME überein.