# Lokal am Projekt arbeiten

Die Setup-App richtet deinen Rechner ein und klont alle Repositories eines Projekts in einen gemeinsamen Ordner, in dem Editoren und KI-Agenten das ganze Projekt sehen.

> Source: https://www.application-platform.com/de/docs/working-locally/

Lokal liegen Werkzeuge und Code auf deinem Rechner unter macOS, Windows oder Linux. Die [Setup-App]({{< relref "local-app" >}}) installiert fehlende Werkzeuge, klont deine Projekte und öffnet sie im Editor deiner Wahl; die Anforderungen an den Rechner stehen unter [Voraussetzungen]({{< relref "local-requirements" >}}). Ohne Installation arbeitest du in einem [Remote-Workspace]({{< relref "workspaces-overview" >}}), einer vorbereiteten Ubuntu-VM in der Cloud, auf dieselbe Weise.

## Ablauf der Einrichtung

Du lädst die Setup-App von der [Downloads-Seite]({{< relref "/downloads" >}}), 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]({{< relref "ai-instructions" >}}) 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]({{< relref "workspace-ubuntu-dev-scripts" >}}). 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]({{< relref "environment-setup" >}}); ein Push auf `main` startet die Pipeline aus [Git-Workflow und Deployment]({{< relref "git-workflow" >}}).