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

> Source: https://www.application-platform.com/de/docs/open-and-run/

## Den Projektordner öffnen

Aus der Setup-App öffnest du das Projekt unter **Projekte** mit dem Button für dein Werkzeug, alternativ im Editor über **Datei** → **Ordner ö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 **Terminal** → **Neues Terminal** ein Terminal und wechsle in das Repository; `ls` zeigt die Ordner:

```bash
cd backend
```

## Die Anwendung starten

```bash
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]({{< relref "environment-setup" >}}); weitere Optionen von `ap run-local` stehen unter [Anwendungen starten]({{< relref "workspace-ubuntu-dev-scripts" >}}).

Läuft die Anwendung, kannst du Änderungen von einem [KI-Agenten]({{< relref "work-with-ai-agents" >}}) vornehmen lassen.