Lokal liegen Werkzeuge und Code auf deinem Rechner unter macOS, Windows oder Linux. Die Setup-App installiert fehlende Werkzeuge, klont deine Projekte und öffnet sie im Editor deiner Wahl; die Anforderungen an den Rechner stehen unter Voraussetzungen. Ohne Installation arbeitest du in einem Remote-Workspace, einer vorbereiteten Ubuntu-VM in der Cloud, auf dieselbe Weise.
Ablauf der Einrichtung
Du lädst die Setup-App von der Downloads-Seite, meldest dich mit deinem Application-Platform-Account an und führst das Entwickler-Setup aus, das von Git über die Laufzeiten bis zur ap-CLI installiert, was fehlt. Danach klonst du im Bereich Projekte ein Projekt; die App holt alle Repositories, legt die gemeinsame Konfiguration an und öffnet das Projekt per Klick im Editor oder KI-Werkzeug.
Der Projektordner
Alle Repositories eines Projekts liegen nebeneinander unter ~/Documents/application-platform/<organisation>/<projekt>/: ein Verzeichnis pro Komponente, local-configuration für Editoren und KI-Agenten und gitops-configuration für das Deployment.
~/Documents/application-platform/<organisation>/<projekt>/
├── backend/ # ein Ordner pro Repository
├── <app>/
├── homepage/
├── local-configuration/ # gemeinsame Editor- und Agenten-Konfiguration
├── gitops-configuration/ # Deployment-Konfiguration
├── AGENTS.md → local-configuration/AGENTS.md
├── CLAUDE.md → local-configuration/CLAUDE.md
├── .cursor → local-configuration/.cursor
├── .claude → local-configuration/.claude
├── .codex → local-configuration/.codex
├── .vscode → local-configuration/.vscode
└── …
Die Einträge auf local-configuration sind Symlinks, die die Setup-App beim Klonen anlegt; dadurch gelten dieselben Editor-Einstellungen und Regeln für KI-Agenten für alle Repositories. Öffne im Editor oder KI-Agenten immer diesen Projektordner und nicht ein einzelnes Repository, damit Backend, App und Homepage zusammen sichtbar sind und die gemeinsame Konfiguration greift.
Arbeiten im Projekt
Jede Anwendung startest du im Root ihres Repositorys mit ap run-local, das je nach Typ Docker-Dienste und Entwicklungsserver, Flutter Web oder Hugo mit den passenden Umgebungsdateien startet; Ports, Beenden und typische Fehler beschreibt Anwendungen starten. Die Laufzeitversionen stehen pro Repository in .tool-versions, bereitgestellt von asdf auf macOS und Linux und von FVM, NVM und HVM auf Windows. Konfigurationswerte liegen in env/*.generated.env (Plattform) und env/*.custom.env (eigene Werte), siehe Umgebungsvariablen; ein Push auf main startet die Pipeline aus Git-Workflow und Deployment.