Anwendungen starten mit der ap-CLI

Auf dieser Seite

Egal ob Backend, App oder Homepage – jede Anwendung eines Plattform-Projekts startest du mit demselben Befehl im Repository-Ordner:

ap run-local

Die CLI lädt die passenden Umgebungsdateien, startet benötigte Docker-Services (z. B. die Datenbank des Backends) und danach den Entwicklungsserver. Feste Ports pro Repository sorgen dafür, dass mehrere Anwendungen parallel laufen können.

Das funktioniert lokal auf deinem Rechner genauso wie im Remote-Workspace. In VS Code, Cursor und Antigravity übernimmt der Start-Button der Plattform-Extension denselben Befehl.

Ziel und Gerät wählen

Bei Apps kannst du Ziel und Gerät angeben, z. B. für Flutter:

ap run-local chrome            # Web-Build im Browser
ap run-local ios-simulator     # iOS-Simulator (macOS)
ap devices list                # verfügbare Geräte anzeigen

Weitere nützliche Befehle

Befehl	Zweck
`ap doctor`	Prüft, ob alle benötigten Werkzeuge vorhanden sind
`ap bootstrap`	Installiert die `.tool-versions`-Laufzeiten ohne App-Start
`ap ports`	Zeigt die lokalen Ports der Repositories
`ap workspace info`	Zeigt die Projekt-/Repository-Übersicht
`ap git auto-commit`	Staged, committet und pusht in einem Schritt
`ap secrets edit <datei>`	Verschlüsselte GitOps-Konfiguration bearbeiten
`ap cli-update check`	Prüft auf CLI-Updates

Hinweis

Die ap-CLI wird von der Setup-App automatisch installiert und aktuell gehalten. In Workspaces ist sie vorinstalliert.

Wenn etwas nicht startet

ap doctor zeigt, ob ein Werkzeug fehlt.
Bricht der Start wegen eines belegten Ports ab, beende den alten Prozess oder die alten Docker-Container.
Eigene Variablen für den lokalen Start gehören in env/local.custom.env – siehe Mit Umgebungsvariablen arbeiten.