Markdown

Für Einsteiger

Bestehendes Projekt übernehmen

Ein Ordner, den du mit Claude Code, Cursor oder Codex gebaut hast, kommt mit einem Prompt auf die Application Platform, sofern sein Tech-Stack unterstützt wird.

Auf dieser Seite

Eine mit einem KI-Agenten gebaute Anwendung bringt derselbe Agent auf die Plattform; ein Hochladen im Browser gibt es nicht.

Was du brauchst

  • Einen Account unter app.application-platform.com/register mit einer Organisation, siehe Dein erstes Projekt anlegen.
  • Die ap CLI. Im Terminal installierst du sie mit curl -fsSL https://www.application-platform.com/install.sh | sh (Windows in PowerShell: irm https://www.application-platform.com/install.ps1 | iex); die Setup-App bringt sie ebenfalls mit.
  • Node.js ab Version 18, prüfbar mit node --version; fehlt es, installiert es das Entwickler-Setup der Setup-App.
  • Claude Code, Cursor oder Codex.
  • Einen unterstützten Tech-Stack, siehe unten.

Ein Terminal öffnen

Die nächsten Befehle gibst du in ein Terminal ein, in Cursor und VS Code über TerminalNeues Terminal.

Agent-Plugin installieren und anmelden

npx --yes github:doppelt-digital/application-platform-plugin

Der Installer erkennt die installierten Agenten, legt bei ihnen Skills und MCP-Konfiguration ab und öffnet den Browser für die Anmeldung; danach zeigt ap whoami deinen Account.

Wird ap nicht gefunden, fehlt die ap CLI; öffnet sich kein Browser, gib ap login ein. Zum Schluss lädst du Cursor über „Fenster neu laden“ neu und startest Claude Code oder Codex neu.

Den Prompt einfügen

Öffne den Projektordner im Agenten, in Cursor über DateiOrdner öffnen, für Claude Code oder Codex per cd im Terminal und claude oder codex, und füge diesen Prompt ein:

Du holst ein bestehendes lokales Projekt in die Application Platform.

Voraussetzungen – sonst sofort abbrechen und sagen, was fehlt:
- Application-Platform-Account
- MCP-Server "application-platform" verbunden (über die ap CLI angemeldet)

Nur diese Stacks sind erlaubt:
- App: Flutter, React Native (Expo), Next.js, natives iOS, natives Android
- Homepage: Hugo, Astro
- Backend: NestJS, FastAPI, Laravel
- Package nur wenn eindeutig: Dart-Package, Docker-Image, NPM, Go, PyPI, Terraform-Modul/-Provider, VS-Code-Plugin

Steht ein Framework nicht in der Liste (Django, Vue, Express, Symfony, Svelte, Spring, …): STOPP.
Sage klar: "[Name] ist heute nicht im Assistenten (auch wenn es auf der Roadmap steht)."
Keine ähnlichen Stacks vorschlagen, nichts umbiegen.

Nutze das MCP-Werkzeug platform_projects_import_local mit dem Pfad dieses Ordners und einem Projektnamen. Es legt das Projekt an, wartet bis das Setup fertig ist, klont die Repositories in den Workspace, übernimmt die lokalen Dateien und pusht auf main.
Fehlt das Werkzeug: platform_projects_demo_json, platform_projects_create, platform_watch, platform_projects_clone, danach die Dateien übernehmen und pushen.
Wenn Anlegen, Import oder Warten fehlschlägt, melde den Fehler. Kein eigenes git clone oder git remote add als Ausweg.
Generierte CI- und Umgebungsdateien nicht überschreiben. Eigene Werte in die custom-Umgebungsdateien.
Keine Secrets committen.

Kürzer geht es mit dem Slash-Command /import-existing-project des Plugins.

Was der Agent tut

Der Agent bestätigt den Pfad, fragt nach dem Projektnamen und ruft platform_projects_import_local auf, das die Tech-Stacks erkennt, das Projekt anlegt, auf Repositories und Pipelines wartet, sie klont, deine Dateien darüberlegt und alles auf main pusht; .gitlab-ci.yml und env/*.generated.env bleiben erhalten.

Ab jetzt arbeitest du in ~/Documents/application-platform/<organisation>/<projekt>/ mit einem Unterordner pro Repository und local-configuration; der alte Ordner ist nicht mit der Plattform verbunden.

Meldet der Agent, dass du nicht angemeldet bist oder der MCP-Server fehlt, hilft Wenn etwas nicht klappt.

Wenn dein Stack nicht unterstützt wird

Unterstützt werden Apps mit Flutter, React Native (Expo), Next.js, nativem iOS und nativem Android, Homepages mit Hugo und Astro, Backends mit NestJS, FastAPI und Laravel sowie eindeutige Packages wie npm-Paket, Dart-Package oder Docker-Image.

Bei anderen Frameworks bricht der Agent ab und legt kein Projekt mit einem anderen Stack an; einen fehlenden Stack meldest du über die Feedback-Seite.

Den CLI-Befehl ap platform projects import-local für Entwickler beschreibt Bestehendes Repository importieren.

Weiter geht es mit Rechner einrichten oder im Browser arbeiten.