Markdown

Für Einsteiger

Projekt öffnen und starten

Du öffnest den Projektordner im Editor, startest ein Terminal, lässt die Anwendung mit ap run-local laufen und siehst sie dir im Browser an.

Auf dieser Seite

Den Projektordner öffnen

Aus der Setup-App öffnest du das Projekt unter Projekte mit dem Button für dein Werkzeug, alternativ im Editor über DateiOrdner öffnen den Ordner ~/Documents/application-platform/<organisation>/<projekt>. Öffne immer den übergeordneten Projektordner, damit Backend, App, Homepage und local-configuration nebeneinander liegen und AGENTS.md sowie .cursor auf local-configuration verweisen.

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 die Plattform-Erweiterung doppelt-digital.application-platform eine Startseite mit allen Repositories, Links zu GitLab und Dokumentation und einem Start-Button für ap run-local.

Ein Terminal öffnen

Öffne über TerminalNeues Terminal ein Terminal und wechsle in das Repository; ls zeigt die Ordner:

cd backend

Die Anwendung starten

ap 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; ap ports listet alle Ports. Bei Flutter-Apps gibst du das Ziel an, etwa ap run-local chrome oder ap run-local ios-simulator; ap 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

ap doctor prüft die Werkzeuge; fehlende installiert das Entwickler-Setup der Setup-App. 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 ap run-local stehen unter Anwendungen starten.

Läuft die Anwendung, kannst du Änderungen von einem KI-Agenten vornehmen lassen.