Markdown

Für Entwickler

Neues Projekt anlegen

Ein neues Projekt entsteht im Assistenten der Oberfläche oder als JSON über die ap CLI und die MCP-Werkzeuge des Agent-Plugins.

Auf dieser Seite

Aus Komponenten und Stack deines Produkts generiert die Plattform die GitLab-Gruppe mit allen Repositories.

Im Assistenten der Oberfläche

Nach der Registrierung unter app.application-platform.com/register legst du über Organisation erstellen eine Organisation an. Der Projekt-Assistent fragt Komponenten (auch mehrere Apps), Tech-Stack je Komponente und optional Domains, Store-Accounts und Hosting ab; jeden Klick zeigt Dein erstes Projekt anlegen.

Unterstützt sind Flutter, React Native (Expo), Next.js, natives iOS und Android für Apps, Hugo und Astro für Homepages sowie NestJS, FastAPI und Laravel für Backends; Django, Vue oder Spring fehlen heute.

Per CLI mit JSON

demo-json schreibt eine Vorlage, mit --minimal eine kürzere:

ap platform projects demo-json --minimal -o project.json

Eine Next.js-App mit NestJS-Backend und Datenbank sieht so aus:

{
  "slug": "shop",
  "name": "Shop",
  "description": "Onlineshop mit Web-App und API",
  "hostingMode": "none",
  "deploymentMode": "standard",
  "repositories": [
    {
      "type": "app",
      "techStack": "nextjs",
      "name": "Web App",
      "configurationId": "web",
      "webProdDomain": "app.example.com",
      "webEnabled": true
    },
    {
      "type": "backend",
      "techStack": "nestjs",
      "name": "API",
      "backendUrl": "api.example.com",
      "hasDatabase": true,
      "smtpEnabled": false
    }
  ]
}

type und techStack entsprechen den Stacks des Assistenten, Packages (dart-package, npm, go, docker-image und weitere) sind zusätzlich möglich. Danach legst du das Projekt an, wartest mit --watch auf die Repositories und klonst sie:

ap platform projects create --from-json project.json --watch
ap platform projects clone shop

clone legt alle Repositories unter ~/Documents/application-platform/<organisations-slug>/shop/ ab, richtet die Git-Hooks ein und verlinkt local-configuration; ap platform projects status <projekt-id> zeigt den Stand einer laufenden Einrichtung.

Per Agent

Mit dem Agent-Plugin reicht der Prompt „Lege ein neues Application-Platform-Projekt mit einer Next.js-App und einem NestJS-Backend an und klone es.“ Der Skill create-project ruft platform_whoami auf, holt mit platform_projects_demo_json (minimal: true) die Vorlage, passt name, repositories[].type und techStack an, ruft platform_projects_create auf, wartet mit platform_watch (Subjekt project) und klont mit platform_projects_clone. Bei mehreren Organisationen fragt der Agent nach, Mitgliedschaften lässt er leer, damit du Maintainer wirst, und schlägt Create oder Watch fehl, legt er nichts an der Plattform vorbei an.

Was danach in GitLab liegt

Pro Komponente entsteht ein Repository mit Code-Gerüst, generierter .gitlab-ci.yml und env/-Dateien, dazu local-configuration (Editor- und Agent-Konfiguration), gitops-configuration (Deployment für Dev und Prod) und gitlab-profile (README der Gruppe); Sentry kommt hinzu, sobald unter Anbindungen ein Sentry-Konto verbunden ist. Danach öffnest du den Projektordner im Editor und startest jede Anwendung mit ap run-local, siehe Lokal entwickeln.