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

# Einrichtung durch einen Agenten

Fügen Sie einen fertigen Prompt in einen Coding-Agenten ein, lassen Sie ihn die Mobile-Einrichtung auf Ihrem Computer ausführen und prüfen Sie den Bericht, den er zu jedem Schritt schreibt.

## Sie können den langweiligen Teil delegieren

Dieses Repository wurde so geschrieben, dass ein Coding-Agent es lesen kann. Es enthält eine Kartendatei (`llms.txt`), eine Regeldatei (`AGENTS.md`), dateibezogene Gedächtnisnotizen (`.ai/`) und Aufgaben-Skills (`.agents/skills/`). Der eigenständige Mobile-Checkout enthält nicht den Ordner `prompts/`, daher ist der fertige Prompt in diesem Handbuch abgedruckt — kopieren Sie ihn von unten, statt eine Datei zu öffnen.

Das Delegieren des Tippens bedeutet nicht, die Kontrollen zu überspringen. Der Agent arbeitet in Ihrer Kopie des Repositorys und muss mit Belegen berichten, was er getan hat. Die folgenden Abschnitte zeigen, wie ein guter Bericht aussieht, damit Sie die Kontrolle über das Ergebnis behalten.

Dieser Pfad richtet die Expo-App und ihre Verbindung zum Web-Backend ein — dem Server, der Konten und Daten verarbeitet. Wenn Ihr Checkout auch apps/web enthält, kann der Agent dieses Backend lokal ausführen; ein reines Mobile-Checkout benötigt die Ihnen mitgeteilte, erreichbare Backend-Adresse.

[Führen Sie die Mobile-App stattdessen von Hand aus](https://supastack.dev/de/docs/mobile/ship-in-5-minutes.md)


## Was Sie zuerst brauchen

Schließen Sie zuerst die Vorbereitungsanleitung ab: Node.js, Git und ein Editor installiert, die GitHub-Einladung angenommen und der supastack-Ordner auf Ihren Computer heruntergeladen. Der Agent arbeitet in diesem Ordner, daher gilt alles aus [Bevor Sie beginnen](https://supastack.dev/de/docs/mobile/before-you-start.md) weiterhin.

Außerdem brauchen Sie ein Werkzeug, das als Coding-Agent arbeiten kann — ein Editor mit eingebautem KI-Coding-Agenten (eine KI-IDE) oder ein Agent, der in Ihrem Terminal läuft (eine Agenten-CLI). Jedes aktuelle agentenfähige Werkzeug funktioniert; der Prompt legt bereits fest, was er lesen und ausführen muss, sodass Sie keine Anweisungen selbst schreiben müssen.

Entscheiden Sie abschließend die zwei Dinge, nach denen der Prompt fragt: die Backend-Adresse, die Ihr Gerät erreichen kann — eine LAN-Adresse des Computers für ein lokales Backend oder Ihre bereitgestellte HTTPS-Adresse — und wo Sie die App anzeigen werden: Expo Go auf einem Telefon, ein iOS-Simulator auf einem Mac oder ein Android-Emulator.


## Prompt kopieren, zwei Lücken ausfüllen, einfügen

Der Prompt ist der Codeblock unten — markieren und kopieren Sie den gesamten Block.

Zwei Platzhalter erfordern Ihre Auswahl. Ersetzen Sie `<API_URL>` durch die Backend-Adresse, die Ihr Gerät erreichen kann — die LAN-Adresse Ihres Computers plus Port 3000 für ein lokales Backend im selben WLAN oder Ihre bereitgestellte HTTPS-Adresse. Ersetzen Sie `<DEVICE: expo-go | simulator>` durch expo-go für ein physisches Telefon oder simulator für einen installierten iOS-/Android-Simulator. Die nummerierten Schritte bleiben exakt wie geschrieben.

```
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.
```


## Was der Agent mit dem Prompt macht

Der Prompt weist den Agenten auf die Karte, die Regeln und die Sicherheitscheckliste hin und weist ihn an, die Einrichtung der Reihe nach zu durchlaufen und jede Phase zu beweisen. Einfach ausgedrückt wird der Agent:

- Liest die Repository-Karte (`llms.txt`), die Projektregeln (`AGENTS.md`) und die Regeln zum Umgang mit Zugangsdaten (`docs/agent-security.md`), bevor irgendetwas angefasst wird.
- Erstellt `apps/mobile/.env.local` nur aus den Namen in `.env.example`, mit der von Ihnen angegebenen API-Adresse und dem Scheme — der Agent erfindet niemals eine `EXPO_PUBLIC_`-Einstellung, die nicht in der Beispieldatei steht.
- Überprüft, ob das Backend unter Ihrer Adresse antwortet — und startet `apps/web` nur dann selbst, wenn dieser Ordner in diesem Checkout existiert —, statt einen nicht vorhandenen Server anzunehmen.
- Installiert Abhängigkeiten und startet den Expo-Entwicklungsserver, dann meldet er die QR-Vorschau oder den Simulator-Start mit der tatsächlichen Ausgabe.
- Stoppt und meldet, nachdem derselbe Schritt zweimal fehlgeschlagen ist — er umgeht einen Fehler nicht und löscht nichts ohne Nachfrage.


## Was Sie im Bericht des Agenten prüfen

Ein guter Bericht zeigt Beweise, keine Behauptungen. Achten Sie auf die antwortende Backend-URL, die abgeschlossene Abhängigkeitsinstallation und die Expo-Serverausgabe hinter jedem PASS — nicht auf einen Satz wie „alles funktioniert“.

Der Prompt weist den Agenten an, nach dem zweiten Fehlschlag desselben Schritts zu stoppen und zu melden — statt den Fehler zu umgehen — und vor allem Zerstörerischen nachzufragen. Wenn Ihr Agent nach wiederholten Fehlern weiter improvisiert, stoppen Sie ihn und bringen Sie den ersten Fehler zum [Handbuch zur Fehlerbehebung](https://supastack.dev/de/docs/mobile/troubleshooting.md).

Zwei Dinge dürfen nie vorkommen: ein Sicherheitsfeature, das abgeschaltet wurde, um einen Fehler zum Schweigen zu bringen, und ein geheimer Wert wie ein Passwort oder Schlüssel, der in den Chat oder den Bericht geschrieben wurde. Wenn Sie eines davon sehen, werten Sie den Lauf als fehlgeschlagen.

Halten Sie Vorschau und echte Anmeldung gedanklich getrennt. Eine erfolgreiche QR-Vorschau zeigt nur Bildschirme — echte Konten benötigen die Datenbank des Backends, und echte Käufe benötigen einen EAS-Entwicklungsbuild. „Die Vorschau hat sich geöffnet“ ist noch nicht „Konten funktionieren“.


## Wenn Sie es lieber von Hand machen

Jeder Schritt, den der Agent ausführt, ist in den manuellen Handbüchern unten ausgeschrieben — dieselben Befehle, dieselben Prüfungen, in Ihrem Tempo.

[Führen Sie die Mobile-App in 5 Minuten aus](https://supastack.dev/de/docs/mobile/ship-in-5-minutes.md)

[Lesen Sie die vollständige lokale Einrichtung](https://supastack.dev/de/docs/mobile/local-setup.md)

[Beheben Sie einen Einrichtungsfehler](https://supastack.dev/de/docs/mobile/troubleshooting.md)


## Weiter

[Mobile in 5 Minuten starten](https://supastack.dev/de/docs/mobile/ship-in-5-minutes.md)
