Den Projektordner öffnen
Aus der MainPath Toolbox öffnest du das Projekt unter Projekte mit dem Button für dein Werkzeug, alternativ im Editor über Datei → Ordner öffnen den Ordner ~/Documents/MainPath/<organisation>/<projekt>. Öffne immer den übergeordneten Projektordner, damit Backend, App, Homepage und local-configuration nebeneinander liegen.
Im Remote-Workspace öffnest du über Apps auf der Workspace-Kachel VS Code im Browser oder verbindest dich per Remote Desktop; die Projektordner liegen im Home-Verzeichnis.
In VS Code, Cursor und Antigravity zeigt MainPath-Erweiterung doppelt-digital.application-platform eine Startseite mit allen Repositories, Links zu GitLab und Dokumentation und einem Start-Button für mp run-local.
Ein Terminal öffnen
Öffne über Terminal → Neues Terminal ein Terminal und wechsle in das Repository; ls zeigt die Ordner:
cd backend
Die Anwendung starten
mp run-local
Ein Backend startet zuerst Docker-Dienste wie Datenbank, Mailhog und PHPMyAdmin und dann den Entwicklungsserver, eine App den Entwicklungsserver ihres Stacks mit den Werten aus den env-Dateien, eine Homepage Hugo oder Astro auf dem Port des Repositorys.
Das Terminal zeigt die lokale Adresse, etwa http://localhost:3000; mp ports listet alle Ports. Bei Flutter-Apps gibst du das Ziel an, etwa mp run-local chrome oder mp run-local ios-simulator; mp devices list zeigt die Geräte, und mehrere Anwendungen laufen gleichzeitig in mehreren Terminals.
Im Browser ansehen
Öffne die Adresse im Browser; viele Entwicklungsserver übernehmen Änderungen nach dem Speichern von selbst, sonst lade die Seite neu.
Beenden
Drücke im Terminal Strg+C, auf dem Mac mit Control statt der Befehlstaste.
Wenn etwas nicht startet
mp doctor prüft die Werkzeuge; fehlende installiert das Entwickler-Setup der MainPath Toolbox. Ist ein Port belegt, beende den alten Prozess oder Docker-Container; fehlt eine Laufzeit trotz Installation, stehst du nicht im Repository-Ordner mit der passenden .tool-versions. Eigene Werte gehören in env/local.custom.env, siehe Umgebungsvariablen; weitere Optionen von mp run-local stehen unter Anwendungen starten.
Läuft die Anwendung, kannst du Änderungen von einem KI-Agenten vornehmen lassen.